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СгежевоипаВес{В сп — формирует прямоугольную область со скругленными углами. 518 
СгеафеЗетарвВоге — создает семафор. .... еее... 518 
СгежеЗоПаВгизВ — создает дескриптор сплошной кисти .............. 579 
Сгеа{еТЬгеаЯ — создает поток. ... уе... 579 
Сгеа&е\УаЦаеТипег — создает таймер. (... д... .. 580 
Се СигзогРоз, зе СигзогРоз — работа с координатами курсора . мыши ... 581 
рае пе Тозумет те 1 и Зузвет теторает ие — преобразуют форматы отображения 

дат и времени... еее еее. о 082 
ОеефеАфот — удаляет из локальной ‘таблицы атом. иен... 582 
РеефеЕ Пе и другие функции работы с файлами. .. ее... 082 
Пе!е{феМепи — удаление указанного раздела меню... 683 
Пе|ефеОБ]ес+ — удаляет созданный объект... еее... 584 
Рез{гоу\УИ т4о\ — разрушает и удаляет из памяти окно... ........... 584 
Оеу1се!оСоп%го! — посылает команду драйверу устройства... ....... 584 
01зКЕгее — возвращает свободное место на диске в байтах ............. 692 
01$К517е — возвращает размер диска в байтах... и... . .. 692 
ОгавАссерЕЦез и другие функции работы с технологией я Огав&Огор и... ... 592 
ОгаЕ!111$ — окончание перетаскивания файлов. ... еее с. 593 
Ога иегуГИе — получает информацию о перетащенных файлах ен... . 093 
Огамсоп — рисование пиктограммы ... уе в 9 9593 
Огам[сопЕх — изменение размера пиктограммы еее ни 9 594 
Е]рзе — рисует эллипс или окружность. . .. уе. 9 595 

- Епа]еМепаЦет — управляет доступностью раздела меню... (....... 595 

Епаб1е\/11Чо\у — делает указанное окно доступным или недоступным д... 596 
ЕпишСЬПа\/1пдомз — перебор окон родительского окна... ........... 597 
ЕпапОБ]ес{$ — метод интерфейса ЗЭЬе!Ро!4ег..... .. 597 
ЕпишКезопгсеМатез — позволяет получить список имен ресурсов ‘указанного типа. . 598 
Епат\У/ш9о\з — перебор окон верхнего уровня... и... . о. 699 
Ех &Ргосезз и другие функции звершения процесса... 599 
Ех 'ТЬгеа4 и другие функции управления потоком... . .... 600 
Ех У! шао\зЕх и другие Функции, обеспечивающие выключение компьютера 

и перезагрузку системы. ... еее... . 602 
Ех&СгежеВе51оп — восстановление региона по запомненному . д... .. 604 
Ехфгас$Аззос1а{4е ЧШсоп — возвращает дескриптор пиктограммы с указанным номером. . 604 
Ех{гас М соп — извлекает пиктограммы из исполняемых Файлов. уе . о 605 
ГИеЕх!54$ — проверка существования файла... . деи ‹ 605 
ЕШКВес%, шуегВесф — заполняют область контекста устройства. ее... .. о 605 
ЕшАА{ф0от — осуществляет поиск атома в локальной таблице............ 606 
ЕшаСозеСвапхеМо !сайоп — функция мониторинга каталога... . .. 606 
ЕшаЕхесае — возвращает имя и путь приложения, связанного с указанным файлом. . 606 
ЕшаЕ1:$СрапхеМо са оп и другие функции мониторинга каталога........ 607 
ЕпаМех{СПапгеМойса оп — функция мониторинга каталога... .. 608 
Епа\/ том — возвращает дескриптор окна заданного класса с заданным 1 текстом. . 608 


Еша\ЛшаомЕх — возвращает дескриптор дочернего окна.............. 608 
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ЕНазВ\У/тшао\ — осуществляет мигание пиктограммы приложения в полосе задач . . 609 
Е оз ЕПеВоЁегз — передает данные в порт .. ен. о о 609 
Гогта&{Меззаге — текстовое описание сообщений об ошибках .... | .. 609 
ЕгатеВес$ и другие функции рисования прямоугольников на контексте устройства. . 609 
ЕгееЕпу!1гоптеп&гше$ — удаление блока переменных окружения ......... 610 
ЕгееГл6гагу — выгружает указанный модуль. ... ее... 610 
Се$АгсП1гесЯоп — определяет направление рисования окружности еее о 011 
Се Аггитеп$$ и другие методы интерфейса Зе! ок ..... еее в. 0611 
Се АзупсКеу $ а{е — асинхронное определение состояния клавиши ... .. 613 
Се АфотМаше — заносит в буфер строку, связанную с атомом из локальной таблицы .. 614 
Се Сарфиге — определяет окно, захватившее курсор мыши. ........... . 614 
Се СЧазМаште — определение класса окна... .. . . 614 
Се{СПеп Вес, Се’ шт4омВес& — определение размеров с окна и его клиентской области .. 0614 
Се СоттМазК — получает текущую маску событий порта .... ..... 0614 
СеСотшт $афе и другие функции получения и установки параметров порта ..... 0615 
Се СоттТИтеоц&$ — получение временых параметров порта .... .. 618 
СеёОС, Сез\У/т4омрсС, В@аеазе С — управление дескриптором контекста а устройства .. 618 
Се{Оезсг1рИоп — метод интерфейса Зве!аик..... еее о о 618 
СеОез{ор\//т4о\ — возвращает дескриптор Рабочего стола... .... 0618 
Се+01зКЕгеебрасеЕх — информация о размере диска и свободном месте на нем... . 618 
Се{015р]ауМатеО{Р — метод интерфейса ЗЬе]Ро!4ег................ 618 
Се шуеТуре — определяет тип диска. .. .... 0619 
Се Епу1гоптеп {$ 115$ и другие функции работы. с переменными окружения. .... 619 
Се Епугоптеп  Уама е — получение информации о значении переменной окружения. . 620 
СеЕх{СодеРгосез$ — получает код завершения дочернего процесса. ........ . 620 
Се Ех СодеТогеаЯ — получает код завершения потока. .............. 620 
Се Но{Кеу — метод интерфейса Зе ШапКк. . еее еее 9 620 
Че сопГосаЙоп — метод интерфейса ЗвеШлок .. ее с 5 620 
Се Кеу {а{е — получает сведения о состоянии клавиши ... д... . о. 620 
Се Газ{Еггог, Бе лаз Еггог — работают с кодом ошибки данного потока. ...... . 0621 
Се{Гоз1саОтуегтяз и другие функции получения информации о дисках... . . 622 
Се Мепл и другие функции получения информации о меню. ............ 624 
Се МепаЦетСоип® — определяет число разделов меню............... 624 
Се МепиЦетГО — получение идентификатора меню... деи... 625 
Се{МепиЦет то — позволяет получить тексты разделов меню........... 625 
Се Мепи$ {а{е — получает флаги раздела меню. ... ии... о. 625 
Се Мепи5{т115 — позволяет получить тексты разделов ъ меню... .... 0626 
Се+{Мех{УЛтпом — определяет дескриптор следующего или предыдущего окна... . 626 
Се{Оуег|арреЯ Вези -получение информации о завершении записи или чтения в порт. . 626 
Се$Рагепф — возвращает дескриптор родительского окна.............. 626 
Се$Ра{%1 — метод интерфейса ЗвеПТлюк ..... еее о. е 627 
Се РиогЦу(аз$ и другие функции информации о процессе еее. о + 021 
Се РгосАЧгезз — возвращает адрес указанной функции... .. 628 
Се$РгосезТипез — позволяет получить сведения о времени выполнения процесса .. 628 
Се Кез1оп)афа, Ех&Сгеа{еВей10оп — запоминание и восстановление региона. .. . . . 628 
Се Зпом\Ст@ — метод интерфейса ЗвелаиКк. „еее еее. ое 629 
Се З{юоскКОЪ]ес& — возвращает дескриптор объекта ... д... . о. 629 
Се Зи Мепи — позволяет получить дескриптор выпадающего | меню......... 630 
Се Зуз ет П1гесфогу — возвращает путь к системному каталогу У/119омз....... 630 
СеЗуз4ет шо — возвращает информацию о процессоре .............. 631 
СЧебуз$етМепи — дает доступ к объекту системного меню... .. 631 
Се’ТГипейопе{огтайоп, ЗеТипе/опет#огтайоп — информация с (9) дате 1 и времени 

с учетом временного пояса... де... о. 632 
СефУег$!0оп — позволяет получить информацию о ‘версии МИпаомв. еее. о 6383 
Се$Уегз1опЕх — позволяет получить информацию о версии \Уп4омз ........ 634 
СефУо|итеп{огта{10оп — получает информацию о файловой системе. ... . 635 
Се У том — определяет дескриптор окна, находящегося с указанным в некотором 

отношении. ... еее ео. 635 
Сер та4ом)С — возвращает дескриптор. контекста окна... 636 


Се \\таомР]асетеп$, Зе УЛ тп4омР]асетепф — позволяют работать с характеристиками 
местоположение окна. .. еее еее еее о о 686 


Содержание 


Се УИ ш4омВес* — определение размеров клиентской области окна 
Се\/т4о\В5п — возвращает копию региона окна. 

Сез\У/т4омТех& — копирует текст окна в указанный буфер . 

Се \/шп4омТехГеп{П — возвращает длину текста окна 

Че \Уогкт=ПО1гесфогу — метод интерфейса ТЗве!ТиКк . 

Со] Аа4А4от — добавляет в глобальную таблицу строку с именем атома. 
СПоБа]!Де]еёеАфот — удаляет из глобальной таблицы атом. . 
Соба1Е11ААфот — осуществляет поиск атома в глобальной таблице . 


С]оЪа1СеАфотМаше — заносит в буфер строку, связанную с атомом из глобальной 


таблицы . 


СЛоБа!Менюогу ва - — получение сведений. о ресурсах. памяти и ее е текущем ‹ состоянии . 


НазГЕогтаф — определяет зарегистрирован ли если формат 


НазОуег|арредТоСотр]еёе — производит опрос завершения асинхронной операции 


`’ чтения или записи . .. 

ГЕМип10Г1 $6 — интерфейс . . 
ШиА{4юшТаШе — задает размер локальной й таблицы. атомов . 
пзегМепаЦет — вставляет раздел в указанную позицию меню 
Шпуег{ Вес — осуществляет операцию НЕ с пикселами . 

КеуБа_ еуеп& — эмуляция нажатия клавиши . 

ТлпеТо, МоуеТоЕх — рисуют на контексте прямую линию 
ГоааСигзог — загружает курсор из ресурса 

ГоааСигзогГготЕ1е — загружает курсор из файла . 

ГоаЯ!соп — загружает пиктограмму . . 
ГоааКеубоагаГауон% — задает раскладку клавиатуры. 
ГоааГа6гагу — загружает указанный модуль. . 
ГоокарРиуЦегеУуае — получение ГОТО привилегии. 
МАКЕГУТКЕБЗООВСЕ — формирует ссылку на ресурс 

МАХ _РАТН — максимальная длина пути . . 
МЕМОВУЗТАТОЗ$ — структура для получения сведений (6) ‚ ресурсах в памяти 


МЕМОТТЕМГУРО, ТМепиЦет по — тип структур, используемый для я информации 


о разделах меню . 
МеззагеВеер — воспроизводит звуковой с сигнал 
МоуеЕ!е, МоуеЕ\еЕх, МоуеЕ\е\/ИРгогтез$ — перемещают файлы 1 и каталоги 
МоуеЕПеЕх — перемещает или переименовывает файл или каталог . . 
МоуеЕПе\/ {И Ргойгезз — перемещает или переименовывает файл или каталог . 
МоуеТоЕх — перемещает курсор на контексте устройства. 
Моуе\У/тао\ — изменяет положение и размер окна 
МОТТРУТСОМРАТА — структура . 
ОБ]есВтагуТоТех&, ОетТоСвагВаЁ — ` переводят информацию об объекте . 
ОетТоСПВаг, ОетТоСпагВи{{ — переводят текст М5-0ООВ в строку . 
ОешТоСвагВи{{! — переводит текст МЗ-РОВ в строку . 
ОрепЕуеп+ — открывает существующий объект события . 
ОрепРгосезТокеп — получение доступа к привилегиям приложения 
ОрепЗетарпоге — осуществляет доступ к существующему семафору. 
Ореп\/ацаеТиие — осуществляет доступ к существующему таймеру . 


ОУЕВГАРРЕО, ТОуегарре — структура, используется при асинхронном режиме 


чтения из устройства и записи в устройство... .. (. 
Р1е — рисует сектор . 
Р]аубоцпа — воспроизводит звук . | . 
РОТМТ- структура, характеризует координаты 1 точки. . 
Ро|уВе?71ег — сглаживают на контексте устройства множество точек. 
Ро|уВе21егТо — сглаживает множество точек на контексте устройства . 
Ро!у)га\м — сглаживает множество точек на контексте устройства 
Ро|уйоп, Ро]уРо[ухоп — рисуют многоугольники на контексте устройства 


Ро!уЙпе, Ро!у|пеТо, Ро!уРо|уПпе — проводят кусочно-линейные кривые на контексте 


устройства. . 

Ро!у|ПпеТо — соединяет кусочно-линейной кривой множество точек на контексте 
устройства. . 

Ро!уРо|угоп — рисует многоугольники. на контексте е устройства, 


Ро!уРо|уПпе — соединяет кусочно-линейной кривой множество точек на контексте 


устройства. 
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Роз Меззаге — помещает в очередь указанное сообщение . 
Ра|5еЕуеп% — изменяет состояние события. . 
РигеСотт — и другие функции работы с портом в синхронном режиме . 


КеааЕПе, У/гцеЕИе — чтение и запись в устройство, открытое функцией СтеабеЕПе. 


Веа4ЕЛеЕх, \У/гцеЕРЦеЕх — асинхронное чтение и запись . 

ВЕСТ — характеризует прямоугольную область 

Весфап2]е — рисует прямоугольник . . . 
Веё13$егНо{Кеу, Опгей1${егНо&Кеу — регистрация горячих Е клавиш . 
Ве513{ег\/п4о\Меззахе — регистрирует сообщение У п4о\з . . 
ВееазеСарфаге и другие функции, управляющие захватом курсора мыши . 
Вееазе)С — освобождение дескриптора контекста . 

ВееазезетарВоге — увеличивает счетчик семафора 

ВетоуеГоп{Везоигсе — снимает с регистрации трифт 

ВепатеР\е — переименовывает файл . . . 

Везе Еуеп$ — устанавливает событие в несигнальное состояние . 

Везо[уе — метод интерфейса [ЗвеШлик 

ВезитеТЬгеа — разрешает продолжения работы потока после е приостановки 
ВОВ — формирует цвет из красного, зеленого, синего 

ВБоипаКесф — рисует прямоугольник 

ЗЕСОЕТУ АТТЕВОТЕЗ — структура, задающая дескриптор защиты. 
Зе]ес&Глгесфогу — диалог выбора каталога... . .. . 
з@ес{ОБ]есф — назначает созданный дескриптор контексту устройства. 
зепаМеззахе — посылает указанное в ней сообщение окну или множеству окон 
зефАгсП1гесйоп — устанавливает направление рисования окружности. 
зебАггатеп{$ — метод интерфейса ГЗве!ТапК 

зе Сарёаге — захват курсора мыши. . 

ЗеСИрБоага’\У1е\мжег — включает свое окно в цепочку СИрЪоага 
3е{СоттВгеаК — перевод порта в состояние разрыва связи . 


зе СоштМазК и другие функции, управляющие отслеживанием событий порта 


зеСоши{а{фе — устанавливает параметры порта. . 
ЗеСоттТипеоц&$ — устанавливает временые параметры порта . 

зе СигзогРоз — устанавливает курсор мыши в заданные координаты 
зе Оезсг1роп — метод интерфейса [Зве!юКк . 

зе Епу1гоптеп& Уаг1ае — задает значение переменной . 

зе Еуепф и другие функции управления событиями. 

зе ЕПеРой\цег — изменяет текущую позицию файла . 


зе гар1сзМо4е — задает графический режим для преобразования координат 


контекста... 
зе Но{Кеу — метод интерфейса ТЗвешиюк . 

зе сопГосайюоп — метод интерфейса ЗпеШаик. 

ое Газ$Еггог — устанавливает код ошибки. 

зе МепиЦет по — задает свойства раздела меню 

ое Раф — метод интерфейса Зве!Тлок . . . 
оебРг!ог{уС]аз5 — позволяет установить приоритет выполнения процесса . 
зеЗво\СтшА — метод интерфейса ЗвеТапКк . 


зееТ1телопе[1огтайоп — задает информацию о дате и ` времени с учетом временного 


пояса . . . 
Зе \ГацаеТиег. — ` активирует таймер . 
Бе \/шаомГ.опя, де МУ шаом[Г.опй — управляют стилем окна 
рер\\ИшаомР]асетеп& — задает местоположение окна формы 
зе \М/114омРоз — изменяет параметры окна . . 
зер\\У паомВеп — задает окну сформированный регион . . 
Зе шаомзНоокКЕх, Оппоок\/1паомзНооЕЕх — регистрация ловушки . 
зер\\У/т4о\Тех& — изменяет текст окна . 
Зер\Уог1АТгапоги — осуществляет трансформацию координат. 
ЭНВгомзеГогРо|Чег — позволяет выбрать папку в стандартном диалоге 
эве| Мо {у[соп — связь приложения с пиктограммой в Буззет Тгау . 
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Посвящается Архангельской И.Т. — 
покровительнице наших трудов 
на ниве С++ВиПаег и Перт 


От авторов 


Эту книгу написали два автора. Один — умудренный годами и опытом на- 
писания ряда книг о С++Ви!аег и Шер (и уже несколько уставший от этого). 
Другой — молодой, энергичный, несмотря на молодость уже профессионально 
освоивший С++Ви!аег, Перы и жаждущий поделиться своим умением с дру- 
гими. Сейчас уже невозможно разделить, что именно в этой книге написал тот 
или иной из авторов. Мы выступали в ней как единый автор в двух лицах. По- 
этому в дальнейшем изложении мы решили отказаться от претенциозного. 
и безличного местоимения «мы», и заменяем его местоимением «я». 


Для кого эта книга 


Книга рассчитана на читателей, уже освоивших С++ВиИаег и желающих 
расширить и углубить свои знания. Поэтому в ней не рассматриваются вопро- 
сы, традиционные для большинства книг по С++ВиИаег. Мы предполагаем, 
что читатель умеет работать со средой С++ВиЦаег 5-6 или С++Виаег 2006, 
знает основные компоненты, их свойства, методы, события. Для такого перво- 
начального знакомства с С++ВиИаег рискнем рекомендовать приведенные 
в разделе «Дополнительные источники информации о С++ВиПаег» кни- 
ги [1] — [3] одного из авторов данной книги, также готовящиеся к изданию 
книги [5] — [7]. Кроме того, для оперативной помощи в работе очень помогают 
справки [4] (они плод совместной работы обоих авторов), встраиваемые в среду 
С-+--+Виа!аег. Во всяком случае, сами мы постоянно ими пользуемся, хотя они 
пока недостаточно полные и все никак не доходят руки кардинально их рас- 
ширить. | 

Итак, мы полагаем, что читатель по этим или иным источникам освоил 
С-+--+Ви!аег и имеет некоторый опыт в разработке проектов. Но когда проекты 
становятся достаточно сложными, часто оказывается, что стандартных сведе- 
ний, почерпнутых из большинства книг, явно недостаточно. Требуется воз- 
можность организовать совместную синхронную работу нескольких приложе- 
ний; управлять внешними приложениями, созданными другими фирмами, 
с неизвестным исходным кодом; вмешиваться в поток сообщений \У!119о%з, 
циркулирующих в системе; управлять клавиатурой, курсором мыши, самим 
компьютером, выключая его или, наоборот, запрещая выключение. А со вре- 
менем разработчику начинает хотеться какой-то экзотики вроде непрямо- 
угольных форм и окон, текстов, отображаемых под любыми углами и т.п. 
Впрочем, это и не такая уж экзотика: во многих приложениях требуются ре- 
дакторы с перемещаемыми и вращающимися графическими объектами. 

Подобных задач возникает множество. Большинство из них могут быть ре- 
шены средствами АРТ \У/1т4о\мз. Но решение таких задач, как правило, не рас- 
сматривается в книгах по С++ВиЦаег. И разработчик начинает лазить по до- 
кументации в поисках средств взаимодействия с АРТ \У/114о\з. Цель, которую 
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мы поставили перед собой при написании данной книги — помочь читателю 
в разрешении подобных проблем. При выборе тем, представленных в данной 
книге, мы руководствовались двумя соображениями. Во-первых, изучение ма- 
териалов различных конференций и форумов по С++ВиПаег, прежде всего, 
в Интернете, позволило выделить вопросы, которые больше всего интересуют 
‚ разработчиков, по которым задается больше всего вопросов, и которые, следо- 
вательно, представляют интерес для большинства пользователей С++Ви!Паег. 
Во-вторых, мы старались совершенно не повторять материал книг [1] — [3] 
по С++Во!Паег, возможно, знакомых читателям. И это нам удалось. Кроме, мо- 
жет быть, нескольких страниц, которые были необходимы для последователь- 
ного полноценного изложения, все представленное в данной книге — совер- 
шенно новый материал, ранее не публиковавшийся. 


На какие версии С++ВиНаег рассчитана книга 


Рассмотренные приемы программирования применимы, как правило, 
к любым версиям С++ВоПаег. Но, конечно, предпочтительнее работать 
с С--+ВиПаег 6 или 2006, в которых некоторые задачи рептаются проще. В тех 
случаях, когда тот или иной прием не применим к более ранним версиям 
С+-+ВоПаег, мы старались дать альтернативное решение для этих версий. 

В данной книге отсутствует какой-то сквозной сюжет, отсутствует после- 
довательное изложение и развитие каких-то тем. Во многих главах каждый 
раздел — это самодостаточное изложение некоторой проблемы. Можно счи- 
тать, что книга представляет собой что-то вроде коллекции рецептов решения 
самых различных задач, во многом подсказанных вопросами, часто задавае- 
мыми на форумах и конференциях в Интернете, в частности, на нашем форуме 
Юр: //1а618.1ри.г$31.ги/огит/Рогит.азр. Так что, возможно, тематику книги 
частично формировали и вы, если задавали где-то в Интернете свои вопросы. 
Правда, сразу оговоримся, что хотя тематику мы черпали из задаваемых во- 
просов, но во всех случаях ответы давали свои. Во многих случаях они не сов- 
падают с теми советами, которые были даны участникам конференций. А если 
иногда и близки к ним, то отличаются развернутыми пояснениями и примера- 
ми, которые просто не могли из-за специфики Интернета дать мастера 
С+-ВиПаег, отвечавшие на эти вопросы. Но должны сказать, что мы с вели- 
чайшим уважением относимся к Мастерам С++ВиИаег (именно Мастерам 
с большой буквы), которые щедро делятся на страницах многочисленных сай- 
тов своим опытом. Огромная благодарность этой армии известных и неизвест- 
ных любителей С++Ви!@4ег, заочно подсказавших нам многие темы, рассмот- 
ренные в данной книге. 


Чем отличается данная книга от предшествующей 


В заключение стоит сказать об отличиях данной книги от ранее опублико- 
ванной «Приемы программирования в С++ВиИаег. Механизмы У\У/ш94о%\з, 
сети». Прежде всего, в данной книге учтены особенности версии С++ВиЦаег 
2006, которая в момент выпуска предыдущей книги отсутствовала. Но, кроме 
того, в книгу внесено немало нового. В частности, добавлены 2 главы. Новая 
глава 7 «Разработка справочной системы (создание файлов .Пр)» дает сведения 
о создании и использовании справочных систем приложений. А новая глава 8 
дает подробное описание около 300 функций АР! У/114о\з. Введение этой главы 
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позволило очистить текст предшествующих глав от излишних справочных дан- 
ных, и позволило дать информацию о многих функциях, которые ранее в книге 
только упоминались или вообще не рассматривались. Добавлена, фактически, 
новая глава «Предметные и тематические указатели к книге», которая, как мы 
надеемся, существенно облегчит читателям поиск в книге нужной информации. 

Введен ряд новых разделов. Отметим только основные из них: «Введение. 
С-+ВиПаег 6 и 2006», 1.16 «Атомы», 2.4.5 — 2.4.7 «Изображения курсоров, 
анимированные курсоры, системная информация о курсорах», 6.1.2 «Получе- 
ние информации. о физических и логических дисках функцией Пеу1сеоСоп- 
{го|», 6.1.3 «Управление дисководами СО-ВОМ», 6.13 «Запоминание в файлах 
состояния компонентов и форм», 9.1.2 «Идентификаторы ресурсов», 9.5 «Ком- 
поненты Пщфегпе$ П!гес% (194у)»›, 10.7 «Преобразования ОВЛ», 11.4 «Обмен дан- 
ными. между клиентом и сервером», 11.7 «Приложение со связанными табли- 
цами». Кроме того, переработано множество других разделов. 

Надеемся, что в результате всех этих добавлений книга стала более инфор- 
мативной и удобной для читателей. 


Введение. С++ВиПаег 6 и 2006 


Материал данной книги можно использовать при работа с различными ва- 
риантами системы проектирования: С++Виаег 2006, С++Ви!аег 6 и предште- 
ствующими версиями. Но так как, вероятно, большинство читателей знакомы 
с С+--+Воа!П@аег 6 или более ранними версиями, я решил в этом введении коротко 
остановиться на том, чем отличается С++Ви!аег 2006 от более ранних версий. 
Очень коротко, так как предполагается, что данная книга предназначена тем, 
кто уже неплохо освоился с одной из версий С++Ви!аег. 

Отличий в С++Ви!аег 2006 от С++Ви!аег 6 не так уж много. Появилась 
новая стандартная библиотека, и добавилось несколько компонентов УСГ. По- 
жалуй, основное нововведение — это новая и очень удобная Интегрированная 
Среда Разработки. Вот на этом отличии я и становлюсь. А также на тех под- 
водных камнях, которые могут встретиться при переводе в С++Ви!аег 2006 
проектов, созданных в предшествующих версиях. 


Различия в Интегрированной Среде Разработки 


Внешне основные окна среды в С++Ва!ег 6 (рис. В1) ив С++Ви!аег 2006 
(рис. В2) не очень похожи друг на друга. В С+-+Ви|Цаег 6 имеются отдельные 
окна различных инструментов, а в С++Виаег 2006 все инструментов встрое- 
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Рис. В1. Окно среды разработки С+-+ВиИаег 6 


Введение. С++ВийЙаег 6 и 2006 


№ РгоуесЕТ5 - ВоНапд БеуеЮрег $цифо 2006 - И.о Е п к 
Ре ЕФ беэсВ Чем  ВеРабог Ргоес Вип Сотропеге Тооб УмТеат он р 


Го до аъ Им 5 


& нисвиге в х. Я ‘некое Раде 5 о брр.. 


| эх ++ 
= У юим | 


‚ТЫ ВуКоп1 
‚2 сотбоВох1 
‚1 гаБеечесд1 
= 15] ВЕВЕФЕ 


Е ОБес тивресог и х 
| вы т ми. Я 


[Ргорете5 | Емегис 

| Ап с аМопе 
‚АНогААйЕНг Рае 

Е], АпсРог$ [аК-еЁ,эКТо. 

| 'докобозЕРаве 
‚дибоСогтртие 
‚дибоСотЕ 500 
‘дикобгор_абе 

[Я 'Веуе!ЕЧде [Бе еРЕБетс 
‚Веуе!плеь“Расед 
‚ВеуеКпа:ЬМопе 
'ВемеЮцкеБ\омеге4 
‚ВОМоде Басе Тов 


3. | реа х 1ауя "| д ‚, 


2 22; а Р'оесЕ75.54ёрго) - Роесе... # Ж 


57 добуие т [Е Ме Г 


И 
.: т Е р годесеСгоир20 


= 3 Ргоуес(7Т5.еке 


> Е Ргое(Е75.срр 
Е) РгоесЕ75 тез 


- ГД 
; 


И О ты 


: № То! раеие 
А? 
| 5008 | 
‚ 2 Авейюты 
‚ 2] ТИВ 

| Т5реедВиКоп 
16. ТМазКЕДК 
: 1% ТЗБ9биЯ 
{ ТОгам би 
|| ‚1 Т/паде 

> ТНаре 


‚СВагСазе’ есМогиз| Е 
| сою Д]Мочом | —.! ТВе\е! 
| ЕВ] Сопяхат (ТугеСоп 6 ‹ Е ТбегойВох 


оно оли о 
| АБ 5Номи < ТоНески$вВох 


Рис. В2. Окно среды разработки С-+-+ВиНаег 2006 


ны в единое окно среды разработки. Правда, выбрав в списке в верней правой 
части экрана значение С!аз;х< УпдосКеа вместо принятого по умолчанию значе- 
ния Оеюи! [ауош, можно и в С+-+Ви!аег 2006 сделать большинство (но не все), 
окна отдельными. 

Существенно различается в версиях 6 и 2006 палитра компонентов. 
В С+-+ВиПаег 6 это многостраничная панель в верхней части экрана, а в С++Ви!- 
4ег 2006 палитра инструментов (не только компонентов) расположена в правом 
нижнем углу (см. рис. В2) и состоит из ряда разделов. В зависимости от того, с ка- 
ким инструментом вы в данный момент работаете, в палитре могут отображаться 
компоненты, типы приложений, фрагменты кода, которые вы можете перенести 
в свое приложение. Поскольку число компонентов очень велико, в палитре преду- 
смотрена возможность сворачивать и развертывать отдельные категории. Для это- 
го используются значки «+» и «-» около соответствующей категории. Вы можете 
также щелкнуть в окне палитры правой кнопкой мыши и выбрать из контекстного 
меню раздел Со|арзе А! — свернуть все категории, или Ехрапа А! — развернуть все 
категории. Быстрое перемещение по категориям обеспечивает кнопка Саедопез. 
Щелчок на ней открывает список категорий, из которого вы можете выбрать тре- 
буемую. Эта категория станет видна в окне в развернутом виде. 

Если вы не помните, в какую категорию включен нужный вам компонент, 
можете ввести начальные символы его идентификатора. При этом будет прово- 
диться фильтрация: в панели будут отображаться только те компоненты всех 
категорий, в которых названия начинаются с введенных вами символов. 
Фильтрацию можно проводить в любом режиме. Но удобнее предварительно 
нажать кнопку Е ег ог опй|ег Не ситеп! Нетз, расположенную справа от кнопки 
Саедойез5. Если нажать кнопку фильтрации, то вводимые вами символы будут 
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отображаться вверху палитры, и вы будете видеть, что именно вводите и не 
ошиблись ли, нажав не тот символ. 

В целом надо отметить, что палитра в С++ВиПаег 2006 намного удобнее, 
чем в С++Ви!аег 6 и в более ранних версиях. Основные достижения, на мой 
взгляд, — это возможность сворачивать и развертывать категории, а также 
возможность фильтрации. 

Много приятных усовертенствований сделано в С++ВиПаег 2006 в Редак- 
торе Кода. Переключение в окно Редактора Кода осуществляется или так же, 
как в С++ВиИ4ег 6 — кнопкой Тодае Гогт/Упй (третья слева на инструмен- 
тальной панели на рис. В2), или закладками внизу поверхности проектирова- 
ния. Среди нововведений я бы отметил, прежде всего, отслеживание скобок: 
в предложении, содержащем много скобок очень приятно, что, когда курсор 
подводится к одной из скобок, выделяется цветом парная ей — закрывающая 
или открывающая. Это существенно облегчает поиск ошибок, связанных с не- 
верной расстановкой скобок. 

Добавлено также завершение многих фрагментов кода. Например, если вы 
написали открывающуюся фигурную скобку и нажали Епег, то автоматически 
в код занесется в отдельную строку закрывающая фигурная скобка, и курсор 
остановится в строке между скобками. Это избавит вас от очень частых оши- 
бок, связанных с тем, что вы где-то забыли закрыть блок, начатый фигурной 
скобкой. Если вы напишете какой-нибудь сложный оператор, например, # 
или змЦев, и нажмете пробел, то в текст вставится шаблон этого оператора, 
и вам останется только заполнить его. 

Очень удобны также выделение цветом в окне Редактора Кода последних 
несохраненных изменений, возможность включить выделенный фрагмент 
кода в качестве блока в какую-то структуру или комментарий (команда 
Зитоипа контекстного меню) и многое другое. 

Теперь остановимся на очень, на мой взгляд, полезной возможности про- 
смотра и сравнения различных версий приложения. Любое приложение разра- 
батывается поэтапно. Вы что-то добавили в файл модуля, изменили какие-то 
операторы, сохранили файл, выполнили приложение. Обнаружили что-то, не 
удовлетворяющее вас, опять что-то подправили в коде ит.д. В процессе подоб- 
ной работы вы можете придти к выводу, что один из предыдущих вариантов 
работал лучше. Что же делать? Ведь вы уже не помните, чем именно тот вари- 
ант отличался от текущего. 

Решить подобную проблему позволяет страница Ногу (История) поверх- 
ности проектирования. Перейдите в окне Редактора Кода в интересующий вас 
модуль и нажмите закладку Н! югу в нижней части окна. Перед вами откроет- 
ся окно истории данного модуля, показанное на рис. В.3. Оно имеет внизу три 
закладки: Сощеп!5, пю и ОМ. На странице Сотмет5, показанной на рис. В.З а, 
вы видите строку с надписью «ЕЦе» и ряд других строк. Строка Не соответст- 
вует текущему файлу проекта, а остальные строки относятся к ранее запом- 
ненным вами состояниям этого файла. Правда, эти копии прошлых вариантов 
файла сохраняются, если у вас включена опция Сгесе БасКор Нез, состояние 
которой вы можете проверить, выполнив команду Тооб5 | ОрНопз и выделив | 
в открывшемся окне вершину Ед Ног ОрНоп$. По умолчанию опция Сгефе БасКир 
Нез включена, так что версии файла сохраняются. Число сохраняемых версий 
можно установить в окне Не БасКур Штй. По умолчанию число сохраняемых 
версий 10, но вы можете задать любое другое число от 1 до 90. | 

В каждой строке в столбце Ва указана дата и время, когда был создан со- 
ответствующий вариант файла. А если вы выделите какую-то из строк, то 
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в нижней части окна увидите соответствующий код. Есл: 
надо вернуться к какой-то из прошлых версий, можете : 
на странице Сотщепв и нажать быструю кнопку Кеуен (с к] 
ва на рис. В.3З а) или выбрать раздел Кеуей в контекстном 
казано окно с текстом предупреждения. Если вы ответи 
дактор Кода загрузится указанная вами прошлая версия 
вы сохраните этот код в файле, то ваше приложение полн 
бранному вами прошлому состоянию. 

Таким образом, вы в любой момент можете восстанови 
версий файла. Но ведь прежде, чем восстанавливать, хотел. 
одна версия отличается от другой! Вряд ли это можно вси. 
только на дату той или иной версии. Создатели С+-+Во!ае: 
проблему. Выберите в окне истории закладку ОМ. Откроет 
ная на рис. В.З 6. Она позволяет сравнить коды двух любы: 
сий надо выбрать в списке левой панели ОНегепсез гот, а в" 
вой панели То. В окне в нижней части страницы вы увиди' 
несовпадающие операторы кодов. Зеленым цветом будет вь 
из левого списка, а голубым — операторы версии правог‹ 
около соответствующей строки будет показывать, что эта с 
или изменена в нем, а символ «-» говорит о том, что стро 
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Рис. В.З. Окно истории файла: страница Сог{еп{5 (а) 
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Рис. В.3. Окно истории файла: страница ОН} (6) 


Строка ВоНег в списке правой панели указывает вариант с изменениями, 
которые были сделаны в коде окна Редактора Кода, но, может быть, еще не со- 
хранялись в файле. Быстрые кнопки Со ю пех аЁМегепсе и Со Ю ргемоцз 
ЧШНегепсе (четвертая и пятая слева на рис. В.З 6) позволяют перейти к следую- 
щему или предыдущему несовпадению кодов. Кнопка Зупсйготте $сгой! (третья 
слева) позволяет синхронизовать положение курсора в коде в окне истории 
и в коде окна Редактора Кода. Если эта кнопка нажата, и вы поставили курсор 
в какую-то строку кода в окне история, а потом переключились в Редактор 
Кода, то в нем курсор окажется на той же строке. 

Как видите, окно истории дает прекрасный инструментарий для работы 
с различными версиями приложения. 

На этом, пожалуй, я остановлюсь в описании отличий среды разработки 
С+-+-ВиПаег 2006 от предшествующих версий. Я отметил нововведения, наибо- 
лее полезные с моей точки зрения. Но имеется и много иных усовершенствова- 
ний: автоматизация создания шаблонов (команда Ее | Мем | ОМег | О!ег Е!6з, 
пиктограмма Соде Тетр!<!е), возможность создания макросов, удобные инстру- 
менты упорядочивания расположения компонентов. Подробное рассмотрение 
всех особенностей среды разработки С++Виаег 2006 выходит, естественно, за 
рамки данной книги. Это сделано в книге [5]. А в заключении следует сказать, 
что среда, конечно, стала намного удобнее, так что новые проекты стоит разра- 
батывать именно в С++Ви!аег 2006. И даже, пожалуй, стоит пойти на реше- 
ние некоторых проблем, описанных в следующем разделе, чтобы перевести 
прежние проекты в новую среду разработки. 
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Перевод в С++ВиЙдег 2006 проектов предыдущих 
версий, конфигурации проектов 


В предыдущем разделе были показаны значительные преимущества среды 
разработки С++Ви!Паег 2006. Поэтому возникает естественное желание пере- 
нести в эту среду разработки, сделанные в прежних версиях С++Ви!Паекх, что- 
бы продолжать работу с ними. 

Для начала перевода прежнего проекта на платформу С++ВиЦаег 2006 
просто откройте прошлый проект в среде С++ВиИаег 2006. Вы увидите окно, 
показанное на рис. 6.4. Смысл текста этого окна — вопрос, хотите ли вы обно- 
вить проект до версии С++Ви!аег 2006. Ответьте утвердительно, и на этом 
иногда перевод проекта в С++ВаПаег 2006 может успешно завершиться. Далее 
вы откомпилируете обновленный проект, и сможете его исполнить. 


Рис. В.4 . ИлГогтабоп 


Окно зап роса РАТеЕхатр\СВийдег20065\5еа\!аг\5еа\аг.Брг аз Бееп ирдаед Ко мегяоп 10.0 
оп реоб разовании проекта |. 1 Рог гпоге пРогтаНоп оп Ве сНапдез таде сйсК оп Ле Бер БуКоп. 


Но нередко в процессе компиляции появляются сообщения об ошибках. 
Например: 
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Или появляются диалоговые окна с сообщениями, что невозможно найти 
какие-то пакеты. Обычно подобные неприятности связаны с путаницей моду- 
лей прежних и новой версии С++Ви!аег. Наиболее простой выход из положе- 
ния следующий. 

Откройте новый проект, удалите из него модуль с появившейся пустой 
формой, и добавьте в проект вместо него модуль главной формы исходного 
проекта. Если в проекте несколько форм, то добавьте и остальные формы. 
‚ Скомпилируйте проект. Если компиляция пройдет без ошибок, то сохраните 
проект под прежним именем. 

В большинстве случаев описанный способ позволяет перенести прежний 
проект на платформу С++Ви!аег 2006. Правда, бывают ситуации (к счастью, 
очень редко), в которых это не срабатывает. Тогда остается более надежный, 
но и более трудоемкий путь. Надо создать новый проект и привести в нем раз- 
меры формы к размерам главной формы исходного проекта. Затем открыть 
форму исходного проекта, нажать клавиши СШ-А — выделение всех компонен- 
тов, а затем нажать С\-С.— копирование их в буфер обмена. Затем перейти 
в форму создаваемого проекта и нажать СШ-У — копирование компонентов из 
буфера обмена. Затем надо поочередно создавать в новой форме требуемые об- 
работчики событий и переносить в них код из исходной формы. В заключение 
можно сохранить проект и его формы (если требуется, то можно сохранять под 
именами прежнего проекта). Конечно, этот путь достаточно нудный, но зато 
безотказный. Во всяком случае у меня он ни разу не отказал. 

Впрочем, некоторые приложения в принципе невозможно напрямую пере- 
нести в С++Ви!аег 2006. Это связано с тем, что не все компоненты, имевшиеся 
в предыдущих версиях, имеются и в С++ВиПаег 2006. Например, в С++Вий- 
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ег 2006 исчезли страницы библиотеки Газ Ме!, Оеззюпт Сибе, ОКерой, АсНуеХ, да 
и на некоторых имеющихся страницах нет ряда прежних компонентов. Так что 
большинство примеров, рассмотренных в гл. 10 и 11 и использующих такие 
компоненты, переводу в С+-+Ви!Паег 2006 не подлежат. Конечно, их можно реа- 
лизовать на иных компонентах, но это уже серьезная модернизация проектов. 

Если вы создали проект в С++ВиПаег 2006, или модернизировали преж- 
ний проект, то учтите, что его исполняемый файл .ехе вы найдете не в каталоге 
данного проекта, а в его подкаталоге Рерих ВиИА. В этот подкаталог по умол- 
чанию помещаются отладочные варианты исполняемых модулей. Это соответ- 
ствует принятой по умолчанию отладочной конфигурации Оебод Виа. Конфи- 
гурации различаются множеством опций, которые вы можете установить для 
своего проекта. 

Доступ к различным конфигурациям и свойственным им опциям вы мо- 
жете получить, выполнив команду Ргоес! | ОрНопз. На любой странице этого 
окна опций проекта (см. рис. В5) в верхней части вы увидите выпадающий 
список ВуЙа Сойаугайоп, в котором можете выбрать конфигурацию ОеБоа 
Виа — отладочная, или Кееазе Виа — конфигурация окончательного вариан- 
та, или раздел А! СойНдиганоп$ — все конфигурации. Тогда на страницах опций 
‘проекта вы увидите, какие опции включены в выбранной конфигурации. Мо- 
жете при желании изменить какие-то опции. Если вы при этом включите ин- 
дикатор Оеюи! в нижнем левом углу окна, то установленные вами опции будут 
присущи данной конфигурации. 
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Рис. В.5. Окно выбора конфигурации проекта 
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Кнопка СоНдугаНоп$ открывает окно со списком всех конфигураций. 
В этом списке вы можете выделить конфигурацию и нажать кнопку АсНуае. 
Тогда выбранная конфигурация станет активной и будет применяться к про- 
екту. Например, если вы выбрали конфигурацию Кееазе Ви|а и провели ком- 
пиляцию проекта, то исполняемый файл .ехе появится в подкаталоге 
Вёаеазе_ВииИА. | 

Можно в том же окне, вызываемом кнопкой СоЙхига оп$, создать кноп- 
кой Ме\м новую конфигурацию, задать ее имя, а далее, выбрав ее в списке Вийа 
СоНаиганоп окна рис. В.5, задать опции. Например, вы можете создать две раз- 
ные конфигурации Кееазе, оптимизирующие исполняемый файл по скорости 
и по размеру. Сравнив результаты, вы можете обоснованно остановиться на од- 
ном из них. 

Задать ту или иную конфигурацию для текущего проекта можно коман- 
дой Ргоес! | Виа СовдиганНопз. 

В заключение следует сказать, что размещение исполняемого файла’ .ехе 
не в том каталоге, в котором находятся файлы проекта, а в подкаталогах 
Ребиг Вийа, ЕК@ёеазе_ВийПа и т.п. требует внимательности. Например, если 
приложение должно читать какие-то файлы или иные ресурсы, подразумевая, 
что они находятся в текущем каталоге, то следует перенести файлы этих ре- 
сурсов в соответствующий подкаталог. Иначе приложение будет выдавать 
ошибки. 


\ 


миа 


С+-+-ВиНаег 
и механизмы МЛпао\м/$ 


Взаимодействие 
приложений С++ВиПаег 
с операционной системой 


1.1 Обработка ошибок выполнения функций 
АР! \МИпЧо\!$ 


При работе вашего приложения могут возникать всевозможные ошибки, 
связанные с неправильными исходными данными, ошибками пользователя, 
ограничениями системы и т.д. Имеется несколько механизмов обработки по- 
добных ошибок. Ошибки выполнения операций и библиотечных функций С++ 
обычно обрабатываются с помощью механизма исключений. Работа с исклю- 
чениями подробно рассмотрена в источниках [1] — [5], так что останавливать- 
ся на этом достаточно хорошо известном вопросе мы не будем. Не будем обсуж- 
дать и вопросы, связанные с управляющим словом ЕРО, которое определяет 
обработку ошибок выполнения операций с плавающей запятой. Эти вопросы 
также подробно рассмотрены в источниках [1] — [5]. В данной книге в основ- 
ном будут использоваться функции АРТ У/1т4о\в. А в них принят несколько 
иной подход к фиксации и обработке ошибок. | 

Большинство функций АР \У/т4оу\у/з возвращают результат, который по- 
зволяет понять, произошла ли ошибка при выполнении функции. Это может 
быть булево значение Ё#а]$е, свидетельствующее об ошибке, значения МОТ, 
ОхЕЕЕЕЕЕЕЕ, -1 и др. При этом система вырабатывает некоторый код ошибки 
в виде 32-разрядного числа. 

Выполнив вызов какой-то функции АРТ \!114о0о\3 и поняв по возвращенно- 
му результату, что произошла ошибка, код этой ошибки можно определить, 
вызвав функцию Се Таз Еггог. Она объявлена в файле илтЬазе.й следующим 
образом: 


РИОВР Сееаз®Егкгохк (\УОТр); 


Функция возвращает код ошибки в виде целого числа. Вызывать Че ТГ.а5 Еггог 
надо сразу после вызова функции, ошибку выполнения которой требуется 
определить Дело в том, что многие функции при своем успешном выполнении 
задают код ошибки, равный 0, и тем самым стирают код ошибки, связанной 
с вызовом предыдущей функции АРТ \У/тдо\з. 

Вы можете и в своих собственных функциях использовать аналогичный ме- 
ханизм сообщений об ошибках. Это делается с помощью функции Зе Га$&Еггог: 


УОТО ЗееЬазЕЕггог (ТМ РМОВО АмЕггСоае); 


Аргументом при вызове этой функции задается устанавливаемый вами код 
ошибки. Код должен содержать 1 в 29-ом бите. Этот бит указывает, что код задан 
приложением. Во всех системных кодах 29-ый бит равен 0. Так что установка его 
в 1 гарантирует, что ваш код не перекроется с каким-то системным кодом. 


32 Глава 1. Взаимодействие приложений С++ВиНаег с операционной системой 


Список системных кодов ошибок дается в файле У1ММТ.Н. Но этот список 
кодов мало о чем говорит. В С+-+ВиПаег имеется функции ЗузЕггогМеззаее, ко- 
торая позволяет получить текстовое объяснение ошибки, причем на русском 
языке. Функция объявлена в файле бузО113.Йрр следующим образом 


Ап$156г1па __Еаз®са11 бузЕггогМеззаде (1пе ЕггогСоае); 


Единственный параметр этой функции — код ошибки. А возвращаемое ею 
значение — это текстовое пояснение. 

Вызовы функций Се Газ Еггог и Эу5ЕггогМеззахе удобно объединить, 
введя в свою библиотеку, например, следующую функцию: 

Апз15Ег1па ЕггогСоае (уо19) 


{ 


гесигп бузЕггогМе$заде (СееТазеЕггог ()); 


} 


Она возвращает строку, соответствующую коду ошибки. Вызывать подоб- 
ную функцию надо только в случае, если по результатам предшествующего 
вызова функции АРТ \У/1п4о\мз ясно, что ошибка есть. Тогда вызов вашей 
функции, сообщающей об ошибке, может быть оформлен, например, следую- 
щим образом: 


ЗРомМеззасде ("Ошибка: " + ЕггогСоае ()); 


Можете проверить работу этой функции на простом примере. Перенесите 
на форму окно редактирования ЕЁ и кнопку, в обработчике щелчка на кото- 
рой напишите код: 

Ап$15Ег1па 5 = Еа1Е1->Техе; 

1Е(! Ре1еееЕ11е (5) ) 
ЗВомМеззасе ("Ошибка при удалении файла '" + $ +"':\п" + ЕггкогСоае ()); 

В этом коде вызывается функция АР1 \Ушдомз РеаееЕ\е, которая удаля- 
ет файл, имя которого передано в нее в качестве аргумента. Функция возвра- 
щает #Ёа[5е, если при ее выполнении произошла ошибка. В этом случае в приве- 
денном коде вызывается функция ЭВомМеззасе, в которую передается сооб- 
щение об ошибке, возвращаемое нашей функцией ЕггогСоде. Выполните при- 
ложение и посмотрите на его реакцию при различных текстах в окне Ед 1. Вы 
получите сообщения “Не удается найти указанный файл”, "Синтаксическая 
ошибка в имени файла, имени папки или метке тома”, “Отказано в доступе” 
и др. Как видите, очень простым оператором безо всяких проверок типа Ё# или 
5\Цев вы получили очень нёплохую и разнообразную диагностику ошибок. 

Иногда в приложении все-таки надо знать, о каких ошибках сообщает тот 
или иной код. Тогда в зависимости от значения кода можно с помощью опера- 
торов Ш и змЦеВ предусмотреть те или иные действия. Приводить в данной . 
книге полный перечень ошибок очень накладно: он займет более 70 страниц — 
целую главу. Но вы легко можете получить подобный перечень сами. Помести- 
те на форму компонент Мето и кнопку ВиЦоп, в обработчик щелчка которой 
запишите код: 

Ап$156г1па ВаЕЕ; 


Гог (ОИОВО егу=0; егх < 600000; егг++) 
{ 


ВаЕЕ =бузЕггогМеззасще (егг); 

1Е(ВчЕЕ != "") 

Мемо1->11пез->АЗА (Апз15Ег1па (егг) + " " +ВаЕЁЕ);. 
} 
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Вы получите в окне Мето]1 список всех ошибок в формате: код ошибки, пояс- 
нение. Можете сохранить его в текстовом документе и использовать, когда по- 
требуется. Часть этого списка приведена ниже: 


Операция успешно завершена 

Неверная функция 

Не удается найти указанный файл 

Системе не удается найти указанный путь 
Системе не удается открыть файл 

Отказано в доступе 

Неверный дескриптор 

Повреждены управляющие блоки памяти 
Недостаточно памяти для обработки команды 


©  млюъшрьюмо 


Помимо функции Зуз$ЕггогМе$5 асе, введенной в С++Ви|аег, имеется бо- 
лее мощная функция Еогта Меззаге, объявленная в АРТ У/ш4о\мз: 
РИОВО ЕКогпа*Меззасве (ОМОВО АмЕ1ачз, БРСУОТО 1]рбоигсе, 
РИОВР аАмМез$5адета, ОМОВКР АмЪапатачета, 


.РТЗТВ 1рВоЕЕег, ОМОВО пб12е, 
уа_115Е *Агаимепе $); 


Параметр Ч4м Е 1а7$ является множеством флагов, определяющих параметры 
процесса форматирования. Параметр 4мМеззасе!4 определяет идентификатор 
требуемого сообщения, параметр 4мГапгиаре!4 задает идентификатор языка 
выдаваемого сообщения. Параметры 1рВиЁег и п512е определяют буфер, в кото- 
рый будет помещено сообщение, и его размер. Параметр Агхитепт{$ является 
указателем на массив значений, которые используются для вставки в отформа- 
тированное сообщение. Честно говоря, я так и не смог придумать разумный 
пример, когда имело бы смысл использовать функцию РЕогта Мез5асе вместо 
рассмотренной выше функции ЗузЕггогМеззасе. Так что не будем останавли- 
ваться на описании многочисленных параметров этой функции. Вы можете по- 
смотреть их во встроенной справке С++Ви!аег. Ограничусь примером задания 
этих параметров, который чаще всего используется на практике: 

ТРТЗТВ МзаВчЕЁ; 

Гогма<Меззаде (ГОВМАТ МЕЗЗАСЕ АГГОСАТЕ ВОЕЕЕК | 

ГОВМАТ МЕЗЗАСЕ ЕВОМ ЗУЗТЕМ, МОТ, СееразЕЕггохг(), 


0, (ТРТЗТВ) &МзаВаЕ, 0, МО); 
Таре11->СарЕ1оп = МзаВчуЕ; 


В первом аргументе задан флаг ЕОВМАТ МЕЗЗАСЕ_АГГОСАТЕ_ВОЕ- 
ЕЕК, указывающий, что сообщение должно заноситься в буфер, и флаг ЕОВ- 
МАТ МЕЗЗАСЕ_ЕКОМ_5УЗТЕМ, определяющий, что берутся системные со- 
общения. Функция может брать и другие виды сообщений из модулей, ресурсов 
ит.п., но на этой экзотике мы не будем останавливаться. В качестве индекса со- 
общения 4мМеззасе1ТА задается значение, возвращающееся функцией Се{Га$$- 
Еггог. Переменная М$=Ви{ указывает на буфер, в который заносится сообще- 
ние. Остальные аргументы в вызове функции заданы нулевыми, что обеспечи- 
вает стандартный вид сообщения на языке, установленном по умолчанию. Как 
видите, даже упрощенный вариант использования Еогта Меззахе намного бо- 
лее громоздкий, чем вызов функции ЗузЕггогМеб5абе, при тех же результатах. 


1.2 Определение версии \\Ип4о\/$ 


У/Лшпао\з постоянно совершенствуется, выпускаются новые версии систе- 
мы, а в них предусматриваются новые интересные возможности. Так что при 
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разработке приложений нередко приходится решать сложную дилемму. С од- 
ной стороны, хочется украсить свое приложение достижениями, которые пре- 
доставляют новые версии \/1п4о\мз. А с другой стороны, от приложения требу- 
ется универсальность: вы не знаете, какая версия системы будет поставлена на 
компьютере будущего пользователя вашего приложения. И надо, чтобы на лю- 
бых возможных версиях ваше приложение нормально работало. 

Для успешного решения подобной проблемы надо, чтобы приложение во 
время выполнения умело определять версию \!114о\з. Тогда в зависимости от 
версии оно сможет наиболее эффективно использовать те или иные возможно- 
сти системы. | 

Имеются две функции, позволяющие получить информацию о версии 
У/1п4ожз: Че Уегюп и Се УегзюопЕх. Первая из них объявлена в файле 
илпфазе.й следующим образом: 


РИОВКО СесУегз1лоп ( УОТРр ); 


Эта функция сейчас считается устаревшей, и в новых приложениях реко- 
мендуется применять Се УегзопЕх. Но я, все-таки, рассмотрю коротко 
и функцию Се Уегз1оп, так как есть случаи, когда она удобнее. Функция воз- 
вращает значение, содержащее в младшем слове номер версии \!1140о%з, а 
в старшем — информацию о платформе операционной системы. 

Младший байт младшего слова содержит основной номер \У114о\з в шест- 
надцатеричном виде, а его старший байт (в версиях, кроме У\//т4о\уз 95) содер- 
жит дополнительный номер (модификацию) тоже в шестнадцатеричном виде. 
Таким образом, при распознавании версий можно руководствоваться следую- 
щей таблицей: 


Платформа Старший бит | Младший байт (основной номер версии) 


М/Лтпаомз МТ 


Следующий пример демонстрирует дешифрацию этой информации (он со- 
держится в каталоге Ит4ошз в проекте РИтУег на приложенном к книге 
диске): 


#10с1аае "илпаеЕ.Ъ" 


5Ег1па СееМзпаомз$Уегзтолп () 


{ 
МогА АмВи11а; 


ЗЕг1па 95; 

ОМога АмУегз1оп = 'СееУегз1оп (); 

Йога АмМа}огУегз1оп =  (Вубе) ((Мога) амУегз1оп); 
Мога АмМ1похУегз1оп = НТВУТЕ ( (Мога) амУегзтоп) ; 


1Е (АмУегзлоп < 0%Х80000000) 
{ 


$м1Еср (АмМа)огУегз1оп) 


{ 


сазе 4: $ = "И1паомз$ МТ"; 
Ьгеак; 
сазе 5: 1Е (АмМ1погУегз$1опт == 0) 
5 = "М1паом$ 2000"; 
е1зе 1ЁЕ (АмМ1погУегз1оп == 1) 


$ = "М1тпаомз ХР"; 


1.2 Определение версии \М/тао\ми$ `35 


е1з5е $5 = "Неизвестная версия М1пЧомз МТ"; 
Бгеак; 
АеЁаз1%: 5 = "Неизвестная версия М1паомз МТ"; 


} | 
ЯмВи11А = НТМОВР (АмУегз1оп); 
} 
е1зе 1Е (АмМа]огУегзтоп < 4) 
{ 
5 = "МИ1рпаом$ 3.1"; 
ЯмВи11Я = НТМОВР (АмУегз1лоп} & ОХ7ЕРЕЕРЕЕ; 
} 
е15е 
{ 
1Е (ЧА“МазогУегзлоп == 4) 
$м16СсП (АмМ1погУегз1оп) 


{ 


сазе 0: $5 = "М1паом$ 95"; 
БгеаКк; 
сазе 10: 5$ = "М1паом$ 98"; 
Бгеак; 
сазе 90: 5$ = "М1паомз$ МЕ"; 
ЬгеаКк; 
ЧеЁац1*: $ = "Неизвестная версия М1паом$ 9х"; 


} 

ЯиВи11а = 0; 

} 
1Е (ЯмВо11а > 0) 
5 = $З+1, модификация " + ТпЕТоЗЕг (амВа11а); 
гебагп 5; 


} 


01а __Еаз®са11 ТГоги1: :Ваеоп1С11сКк (ТОр]есе *5епаег) 
{ 


Мето1->ТехЕ = Сеем1пдомзУегз1опт ();, 


} 


Пример работы этого кода приведен на рис. 1.1 (верхняя строка). Функ- 
ция Се \тдомзУег$10оп формирует строку с обозначением версии \У/1т94о\з, 
а обработчик щелчка на кнопке ВиЙоп1 заносит результат в окно Мето1. 


Рис. 1.1 |= информация о \Мпдоме: 
Идентификация версии \\пдо\5. чИпдоие ХР, модификация 2600 

Модификация бегисе РасК 1 2600 
Операционная система \/пдомз ХР Ргоеззюопта|. 


С емт | 


Функция Се Уегз1оп удобна, если не требуется информация о версиях, 
а надо только определить, относится ли УтЧ9омз к группе МТ, или к группе 
9.х. Для этого достаточно выполнить оператор: 
1Е (СекУегзлоп() < 0х80000000) 
{...} 
Такую проверку удобно оформить в виде функции. и включить в свою биб- 
лиотеку: 
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Боо1 ТЭЗМТ () 


{ 
гебсагп (СееУегз1оп() < 0х80000000); 


} 


В приложении РИ/пУег вызов этой функции оформлен следующим образом: 


1Е (Т$®МТ) 
Мепо1->ТехЕ = "\М1паом$ МТ\\2000\ \МЕ\ \ХР"; 
е15е Мемо1->Техе = "М1паом$ 9.х"; 


Если требуется более подробная информация о \/1190%з, то, как уже было 
сказано, намного удобнее работать с более современной функцией Се УегыопЕх: 


ВООТ, беф\егэ1опЕх (_ОЗУЕВЗТОМТМЕО *]рУегзтопТпЕо); 


Ее единственный параметр указывает структуру типа _ОЗУЕВКЗТОМ 1ИУРО. 
Поля этой структуры содержат следующую информацию: 


Описание 


О\’ОВО 4\*0О5Уегз1оп ШФо- | Размер структуры. Должен задаваться до вызова 
517е Се УегзопЕХх. | 


ОМОБВР 4*\Ма]огУег510п 
О\ОКВО 4“МтогУег$10оп 


О\ОКВО 4\уВи|ИаМишег Для Уш4омз МТ — номер модификации. Для 
\У/т4омз$ 9.х младшее слово — номер модифика- 
ции, старший байт старшего слова — основной 
номер версии (то же, что 4мМауогУег$10п), млад- 
ший байт старшего слова — дополнительный но- 
мер версии (то же, что аиМтогУег$1оп). 


Основной номер версии. 


Дополнительный номер версии. 


О\ОВО 4уР1аМогш а Платформа операционной системы: 


‚ УЕВК_РГАТЕОВКМ_\1М№325$ — Упдомз 3.1 

с \!11 32$, 
УЕК_РГАТЕОВМ_М1М32_\МТМРОМ5 — Уш- 
4о\з 95 (точнее, У/тЧо\з 9.х) с \/1т32, 
УЕВ_РГАТЕОВКМ_\МТМ32_МТ — Ут9домз МТ 
(2000\ХР) с \! 1132. 


СНАВ 52С5РУегаоп[ 128 | Необязательная дополнительная инф 


При использовании функции де УегзопЕх пример дешифрации инфор- 
мации о \У/т949омз$, аналогичный приведенному ранее, может выглядеть так 
(см. проект РИ/тУег в каталоге Итаоиз на приложенном к книге диске): 


ормация. 


ЗЕг1па СеемМ1паомзУегз1опЕХх () 
{ 
ТОЗУегзлопТптЕо ОбУ\Уег; 
Ап$15Ег1па 5; 
гегоМептогу (&О5\Уег, з12еоЕ (О05Уег)); 
озУег .аАмо5Уег1опТпЕоб1хе = з12е9Е (ТОбУегзлоп1ТтЕо); 
1Е ( ! СебУетзтопЕх (&05Уег) ) 
гебагп СеЕ\1паом$У\Уегзтоп (); 
$м1Еср (О5Уег.амР1аЕЕокшТа) 
{ 
сазе УЕВ РЪАТРОВМ ИТМЗ25$: 5$ = "М1паомз$ 3.1"; 
Ьгеак; 
сазе УЕВ_РЪАТЕОВМ И1М32_ИТМРОйЗ: 
1Е (ОЗУег.АмМа)огУегз1оп == 4) 
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зм1Еср (О5Уег.амМ1погУег$1оп) 


{ 


сазе 0: 5 = "М1паом$ 95"; 
Ьгеак; 
сазе 10: 1Е(О5Уег.5з7С6рУегз1оп [1] == 'А') 
5 = "М1паом$ 988Е"; 
е1зе $5 = "И1паомз$ 98"; 
Бгеак; 
сазе 90: 5$ = "М1паомз МЕ"; 
Бгеак; 
ЧеЁаа1*: $5 = "Неизвестная версия Млпаомз$ 9х"; 


} 
Бгеак; 
сазе УЕВ_РТАТЕОВМ ИТМ32_МТ: 
$и1Еср (О5Уег.АмМа)огУегз1оп) 


{ 


сазе 4: 5 = "И1паом$ МТ"; 
сазе 5: 1Е (ОЗУег .АмМлпогУегз1оп == 0) 
$ = "И1паом$ 2000"; 
е1зе 1Е(О5Уег.аАмМтпогУегзтоп == 1) 
$ = "ИМ1паом$ ХР"; 
е1зе $5 = "Неизвестная версия М1п9омз МТ"; 
ЧеГаз1*: 5 = "Неизвестная версия М1паом$ МТ"; 


} 
} 


гебигп 5 + "\г\пмодификация " + (5&г1па)}ОЗУег. з2С5рУегз1оп + 
'' + ТоЕТо5екг (ОбУег .амВи11амапрег); 


} . 


у01А __Еаз®са11 ТКГоги1: :ВаЕ®оп2С11ск (ТОБ]есе *5епаег) 


{ 
Мепо1->ТехЕ = СееМ1паом$Уегзтол (); 


} 


Просмотрев этот код, вы увидите, что означают и как надо анализировать 
поля записи ТОЗУег1оп Шо. Обратите внимание, что в приведенном коде 
функции Се \УтдомзУег1опЕх проверяется значение, возвращаемое библио- 
течной функцией Се УегзопЕх, и если вызов Се Уегз1опЕх закончился не- 
удачей, то вызывается рассмотренная ранее функция детдом Уег$10оп. 
Дело в том, что нередко с функцией Се УегзопЕх могут быть проблемы. Так 
что уж лучше подстраховаться. 

Еще большие возможности дает вызов функции Се Уегз1опЕх с использо- 
ванием записи типа ТОзУегзоп ПТоЕх. Ниже приводится соответствующий 
код из того же приложения РИтУег. 


ЗЕглпа СеЕе\1паомзУегз1опЕхЕх (5Ег1па &5аор) 
{ 


ЗЕкисЕ ТОзУегз1опТроЕоЕх 
{ 
ТОЗУегз1опТпЕо 01а; 
МОВБР мбег\у1сеРаскКМа)ог; 
МОВКР мзбегу1сеРаскКМ1пог; 
МОВО м5и1ЕеМазКк; 
ВУТЕ мРГЕОоЧас® Туре; 
ВУТЕ мВезегуеа; 
} УегТоЕо; 


2егоМетоку (&УегТпЕо, $з17е0Е (УегТпЕо)); - 
УегТпРо.о1а.Ямо5Уегз1оп1ТпЕо$12е = $з12еоЕ (ТОзУегз1опТпЕоЕх); 
1Е( ! СекУетзторЕх (&УегТпрЕо.о1а) ) 

гебигп СееМ1паомзУегзтолп (); 
бЕг1па 5 = Сее\1паом$Уегзтоп (); 
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баор = "Модификация " + (5%г1па)УегТпЕо.о1а. 52С50\Уегз1оп + 
'! + ТоЕТобег (УегТплЕо.01а.амВи1]АМоатЬег) + "\г\п"; 
3м16ср (УегТпЕо.мРгоаас&Туре) | 
{ 
сазе УЕВ МТ МОКБКЗТАТТОМ: 
ТЕ (5$.5ар5Ег1па (1, 5.Ро$(',') - 1) == "М1паом5 МТ") 
оаор = 54ор + 
"Операционная система ИМ1п4омз МТ 4.0 Могкэкаелоп. \х\п"; 
е1зе 1Е (5$.5а65ег1па (1, $.Ро5(',') - 1) == "Мупаом$ 2000") 
бор = 5аор + 
"Операционная система М1пЧом$ 2000 РгоЕез5$1опа1.\г\п"; 
е1зе 1Е (5.За55Ег1па (1, 5.Р0$(',') - 1) == "М1паомз ХР") 
54ор = 5аор + 
"Операционная система М1паомз ХР РгоЁе$5$1опа1.\гх\п"; 
Ьгеак; 
сазе УЕВ_ МТ РОМАТМ СОМТВОТЬЕВ: 
бор = Заор + 
"Операционная система является контроллером " + 
"домена. \г\п"; 


ЬгеаКк; 
сазе УЕК_МТ_5ЕВУЕБ: 
баор = 5аор + "Операционная система является сервером. \х\п"; 


} 
1Е (УегТпЕо.им5и1ееМазк & УЕВ 5ОТТЕ_ ВАСКОЕЕТСЕ > 0) 
баор = 54ор + 
"Установлен компонент М1сгозоЕ® ВасКкКоОЕЕ1се. \х\п"; 
1Е (УегТпЕо.иба1ееМазКк & УЕВ 5ОТТЕ ВТАРЕ > 0) 
Заор = $54ор + 
"Установлен компонент ИМ1паомз$ „МЕТ Меь Зегуег.\г\п"; 
1Е (УегТпЕо.м5и1ееМазк & УЕВ 5ОТТЕ РАТАСЕМТЕВ > 0) 
баор = 5аор + 
"Установлены М1паом$ 2000 или компонент М1лпаом$ " + 
".МЕТ Рабасепеег Зехуег.\г\п"; 
1Е (УегтпЕо.ми5и1ееМмазк & УЕВ 5ОТТЕ_ПРАТАСЕМТЕВ > 0) 
Заор = 54аор + "Установлен И1паомз 2000 Аауапсеа 5егуег " + 
"или компонент ИМ1паомз „МЕТ Епбегрг1зе 5егкуег.\х\п"; 
1Е (УегТпЕо.м5и1ееМазк & УЕВ 5ОТТЕ РЕВЗОМАГ > 0) 
бор = 54аор + 
"Установлена версия И1паомз$. ХР Номе ЕЯ1Е1оп.\к\п"; 
1Е (УегТпЕо.м5$и1ееМазкК & УЕВ 5ОТТЕ_ ЗМАЬБЬВО$ТМЕ$5 > 0) 
баор = 54ор + 
"Установлен М1сгозоЕе 5та11 Воаз1пез$ Зегуег. \г\п"; 
1Е (УегТпЕо.мби1ееМмазк & УЕВ 5ОТТЕ ЗМАГТВО$ТМЕ$ $ ВЕЗТВТСТЕО 
> 0) 
баор = 5З4ор + "Установлен М1сгозоЕЕ 5та11 Ва$1пезз$ " +. 
"бегуег с ограничительной лицензией для клиентов. \г\п"; 
1Е (УегТпЕо.мби16еМмазКкК & УЕВ 5ОТТЕ ТЕВМТМАТ > 0) 
ЗАор = 5аор + "Установлен компонент Тегм1па1 Зегху1сез.\г\п"; 
хесигп 95; | 


} 


\о1а __Еазеса11 ТГоги1: : Ви оп4С11сКк (ТОБзесеЕ *5епаег) 
{ 

ЗЕг1па 54ор; 

Мепо1->С]еаг(); 

Мепо1->1пез->АЧа (бСеЕ\1паомзУег1опЕхЕх (5аор)); 
1Е(5аор != "") 

Мепто1->1пез->Ааа (5аор); 

Мемо1->5е15$агЕ = 1; 

Мемо1->РегЕогм (ЕМ ЗСВОШТСАВЕТ, О0, 0); 
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Работа с функцией Се Уег$1опЕх с использованием записи типа ТО$Уег- 
$101 П1оЕх оформлена в виде функции Се \УштдомзУегопЕхЕх. Она возвра- 
щает строку характеристики операционной системы, вызывая описанную ра- 
нее функцию бе т@4о\м$Уегз1оп. А если удается, то в параметр 54ор возвра- 
щается строка дополнительной информации. Схема работы с функцией 
Се{Уегз1опЕх с использованием записи типа ТОзУегзоппТоЕх выглядит так. 
Объявляется тип ТОзУег$1оп шРоЕх так, как показано в приведенном коде. 
Поле о] — это запись рассмотренного ранее типа ТОзУегз1юоп Шо. А осталь- 
ные поля записи позволяют получить дополнительную информацию об опера- 
ционной системе, как видно из приведенного кода. 

Перед вызовом де Уег$1опЕх в поле 4мО$Уегз1оп п#09512е записи, на ко- 
торую указывает поле о], заносится размер записи ТОзУегзюоп {о Ех (обра- 
тите внимание, именно ТОзУег$1оп ох, а не ТОЗУегз1оп Шо). Таким обра- 
зом, отводится место для дополнительной информации. Далее следует вызов 
СегУег$1опЕх с передачей в него записи из поля 014. Если вызов закончился 
неудачей, значит, версия соответствующей системной ОЬЁ не поддерживает 
выдачу расширенной информации. В этом случае вызывается описанная ранее 
функция Се \Ут@4омз Уег$10п, возвращающая стандартную информацию о 
системе, и выполнение завершается. Если же вызов Че Уегз1опЕх прошел ус- 
пешно, то после получения стандартной информации вызовом функции 
Се \ том Уегз1оп следует анализ полей мРгодисё Туре и мЗицеМазК запи- 
си типа ТОзУегзоп о Ех и в параметр Э4ор заносится дополнительная ин- 
формация о системе. Параметр мЗицеМаз$К является комбинацией флагов, 
определяющих наличие некоторых компонентов операционной системы. Их 
смысл, вероятно, ясен из приведенного кода. 
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Очень часто в приложениях надо иметь возможность программно опреде- 
лять и устанавливать различные системные параметры. Для получения и уста- 
новки многих системных параметров профиля пользователя очень удобна 
функция ЗузбетРагате ег шо. Она определена в файле У/тизег.й следую- 
щим образом: 

ВООЪ бузсемРагамефегТпЕо (ТМ ОТМТ и1Асетоп, 

ТМ ОТМТ оа1Рагап, 


ТМ ОЧТ РУОТВО руРагам, 
ТМ ОТМТ ЕМ1оТот1); 


Параметр \Асйоп определяет выполняемую функцией операцию и в за- 
висимости от этой операции меняется смысл параметров шРагат и руРагат. 
Ниже приведено только несколько возможных значений параметра шАейоп, 
имеющих прямое отношение к задачам, рассматриваемым в данной книге. 
Полное описание всех значений см. в гл. 8. Там вы найдете немало интересных 
вариантов, которые, возможно, помогут организовать взаимодействие ваших 
приложений с У/т4о\з. 


‚ 5РГ_СЕТРЕЕАОТТИХ- Определить раскладку клавиатуры для языка по 

 РОТЕАМ@ ‘умолчанию. Параметр руРагат указывает на 32-бит- 
‘ную переменную, в которую возвращается дескриптор 
‘раскладки клавиатуры по умолчанию. Параметр шРа- 


| | 
о оеааы ооо т 
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ЭРТ_СЕТТСОМТТТГЕ- 
ГОСЕОМТ 


$РТ СЕТЗСКЕЕМ$А- 
УЕАСТТУЕ 


УЕТТМЕОСТ 


РГ СЕТ\УНЕЕ!- 
$СВОГЛАЛМЕ$ 


эРТ_5ЕТВЕЕР 


`ЗРТ. ЗЕТРЕРАОТГ.Т- 
МРОТГАМС 


РГ _ЗЕТРЕ$К- 
УГАТТ.РАРЕК 


$РГ СЕТЗСКЕЕМ$А- 


‚ используется. 


ЗРТ СЕТ\УОВКАВЕА 


Получить информацию о текущем шрифте заголовков 


пиктограмм. Параметр руРагаш указывает на струк- 
туру типа СГОСЕОМТ (см. ее описание в разд. 1.14), 

а параметр шРагат определяет размер структуры — 
$17е0о{(ГОСЕОМТ). Все поля структуры заполняются 
функцией. Основные из них следующие (см. подроб- 
нее в справке С++Ви!аег). В поле ННееВ& заносится 
величина, определяющая вертикальный размер шриф- 
та: 0 — используется размер по умолчанию, ненулевое 
значение — высота в логических единицах. В поле 
УГ ес передается толщина линий от 0 до 1000 
(нормальная — 400, жирный — 700). Поле ШРасеМа- 


ше содержит имя шрифта. Поле НОмещайоп указы- 
вает. угол наклона текста в десятках градусов. 


Определить, включен ли режим автоматического запу- 
| 
| 


‘ска хранителя экрана. Параметр руРагаш должен 

указывать на булеву переменную, в которую возвра- 
щается фгие, если режим включен, и Ёа[$е в против- 
ном случае. Параметр и1Рагат не используется. 


Определить задержку в секундах автоматического за- 
пуска хранителя экрана. Параметр руРагаш должен 
указывать на целую переменную, в которую возвраща- 
‚ется затребованная величина. Параметр шРагат не 


Только для У ш4омз МТ: определить заданное число 
строк, прокручиваемых при вращении колесика 
мыши. Параметр руРагат должен указывать на пере- 
менную типа ОТМТ, в которую возвращается затребо- 
ванная величина. Значение по умолчанию — 3. Пара- 
метр \1Рагашт не используется. 


Определить размер рабочей области экрана, не заня- 
той полосой задач. Параметр руРагат должен указы- 
вать на структуру типа ВЕСТ, в которую функция 
возвращает размер области. 


Включить или выключить звуковую индикацию оши- | 
бок. Параметр и1Рагат надо установить в 0, если надо | 
выключить индикацию, и установить в 1, если надо = 
включить ее. Параметр руРагат не используется | 
и должен быть равен МОЁГ.. - 

| 


Установить язык по умолчанию. Параметр руРагат 

должен указывать на 32-битную переменную, в кото- 
рой указан дескриптор раскладки клавиатуры по 
Установить обои Рабочего стола. Параметр руРагат 
‚должен указывать строку с полным именем графиче- | 


умолчанию. Параметр \Рагат не используется. __ 
ского файла обоев. Параметр и1Рагат не используется. 
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`ЗРТ ЗЕТТСОМ- Задать характеристики шрифта заголовков пиктог- 
ТИТЕГОСЕОМТ рамм. Параметр руРагаш указывает на структуру 
типа ГОСЕОМТ (см. ее описание в разд. 1.14), а пара- 
„метр шРагат определяет размер структуры — з12е- 
о ГОСЕОМТ). Основные поля структуры, которые 
‘надо заполнить, следующие (см. подробнее в справке 
 С++ВиПаег). В поле ННееВ& заносится величина, 
| определяющая вертикальный размер шрифта: 0 — ис- 
‹ пользуется размер по умолчанию, ненулевое значе- 
'ние — высота в логических единицах. В поле И\е- 
120% передается толщина линий от 0 до 1000 (нормаль- 
‘ная — 400, жирная — 700). Поле ИРасеМате содер- 
`жит имя шрифта. Поле МОмещайоп указывает угол 
наклона текста в десятках градусов. 


ЭРГ_ЗЕТГАМС- Задать горячие клавиши, переключающие используе- 
ТОССТЕ мый язык. Параметры 1Рагашт и руРагаш не исполь- 
зуются. Сочетания горячих клавиш читаются из ре- 
естра, где они предварительно должны быть записаны. 
Сочетания хранятся в ключе НКЕУ СУККЕМТ Ц$ЕК \ Кеу- 
`Боага [ауощ \ Тодае. Возможные значения параметров: 
|] — АНЗНЯ, 2 — Сн|-5Н#, 3 — не заданы. 


ЭРТ_ЗЕТМООЪЗЕ- ' Изменить или восстановить назначение кнопок мыши. 
| ВОТТОМ МАР ' Если в параметр иРагашт записать 1, функции левой 
[и правой кнопок мыши поменяются: правая станет 

` основной, а левая вспомогательной, вызывающей кон- 
| текстные меню ит.п. Если в параметр шРагат запи- 
‘сать 0, то восстановятся исходные функции кнопок. 
‚Параметр руРагат не используется и должен быть ра- 


‚вен МОЕГ. 
Аи ОНИ 
5РГ_ЗЕТРО\/ЕКВОЕЕ- |Только для У/т4омз 95: включить или выключить ре- 
АСТТУЕ ‚ жим автоматического отключения питания при работе 


хранителя экрана. Задание и1Рагат = 1 соответствует 
включению режима, а значение О — отключению. Па- 
‚раметр руРагат не используется и должен быть равен 


‚ МОЕЕ. 
5РТ ЗЕТРО\МЕКОЕЕ- Только для У/ш4о\з 95: задать задержку автоматиче- 
ТТМЕООТ ‚ ского выключения питания при работе хранителя экра- 


'на. Задержка задается параметром шРагашт. Параметр 
руРагат не используется и должен быть равен МОТГ.. 


ЭРГ_ЗЕТЪСВЕЕМ- Включить или выключить режим автоматического за- 
| эЭАУЕАСТТУЕ пуска хранителя экрана. Задается параметром шРа- 
гат: 1 — включить, 0 — выключить. Параметр руРа- 
гат не используется и должен быть равен МОТ... 
ЭРТ_ЗЕТЭСВЕЕМ- ‚ Установить задержку в секундах автоматического за- 
5АУЕТТМЕООТ пуска хранителя экрана. Задается параметром шРа- 
‚ гат. Параметр руРагат не используется и должен 


быть равен М. 
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—=—— 


| Только для Утаомз МТ: задать число строк, прокручи- 
ваемых при вращении колесика мыши. Это число зада- 
ется параметром шРагат. Если задать значение 0, про- 
‚ крутки не будет. Значение по умолчанию — 3. Если за- 
дать число больше, чем число видимых строк, или за- 
дать равным \УНЕЕГ РАСЕЗСКОТГ, (соответствует 

‚ ОТМТ_ МАХ), то вращение колесика интерпретируется 
как щелчок на полосе прокрутки над или под движком. 


$РГ ЗЕТ\УНЕЕ!-- 
ЗСВОГЕЛМЕЗ 


Выше приведен сокращенный список возможных значений параметра 
и1Асйоп. Смысл параметров шРагаш и руРагаш, как видно из таблицы, опре- 
деляется параметром и1АсИоп. Если параметр шРагат не используется, он 
должен быть равен 0. Если параметр руРагат не используется, он должен 
быть равен МОТ. 

Параметр Ё\ т при режимах установки системных параметров опреде- 
ляет, должен ли обновиться профиль пользователя и следует ли послать всем 
окнам верхнего уровня сообщение \УМ_ЗЕТТТМССНАМСЕ, извещающее об 
изменении системных параметров. Параметр Ут может быть равен 0, или 
может равняться одному из следующих значений: 


Записать новые параметры в в профиль пользо- 
‘ вателя. 


Разослать сообщения \М_ЗЕТТИМССНАМСЕ | 
‚ после обновления параметров, не записывая 
‚ параметры в профиль пользователя. 


`_ Идентично ЗР1Е_ЗЕМОСНАМСЕ. 


При значениях ЭРТЕ_ЗЕМОСНАМСЕ или ЭР ЗЕМОМУМИМСНАМСЕ 
новые параметры будут действовать только во время текущего сеанса работы 
данного пользователя. При перезагрузке \/119о0\з или при смене пользователя 
восстановятся прежние значения параметров. 

Функция ЗузетРагатеег шо возвращает ненулевое значение в случае 
успешного завершения. 

Рассмотрим несколько примеров использования функции ЗузетРагате- 
фег$шРо. Немало других, более развернутых примеров вы встретите в после- 
дующих разделах книги. 

Оператор 


# 10с1иае <УРЕС.Юрр>// используется только в том случае, 
// когда используется формат 7]ред 
бузкемРагамекег$ТпЕо (5РТ_ЗЕТРЕЗКИАГГРАРЕВ, О0, 
Орепр1а1о0о31->Е1]еМаме.с_56г(), ЭРТЕ_ ЗЕМОСНАМСЕ); 


устанавливает на’рабочем столе обои из графического файла, выбранного по- 
льзователем в диалоге ОрепР1сёаге01а10о51, и обновляет Рабочий стол, так что 
новые обои немедленно появятся на нем. Но они не будут зафиксированы в ре- 
естре. Поэтому после перезагрузки У/ш@4о\мз на экране опять появятся преж- 
ние обои. А если в приведенном операторе вы замените значение последнего 
параметра на ЭРТЕ_ОРОАТЕТГМТЕШ.Е, то новые обои будут зафиксированы 
в реестре, и вы увидите их снова в следующем сеансе работы. 

Следует отметить, что если вы хотите в приведенном выше операторе рабо- 
тать, в частности, с файлами формата ./рё, то для этого необходимо подклю- 
чить файл УРЕС.Йрр. 
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Следующие операторы занесут в переменную Г. значение фгие, если режим 
автоматического запуска хранителя экрана включен, и значение #а[5е, если он 
выключен: 


Боо1 1; 
бузфетРагамесехТпЕо (5РТ СЕТЗСВЕЕМЗАУЕАСТТУЕ, 0, &1, 0); 


А оператор 


бузсемРагамекегзТпЕо (5РТ ЗЕТЗСВЕЕМЗАУЕАСТТУЕ, 1, МОШ, 
ЗРТЕ ЗЕМРСНАМСЕ); 


включит режим автоматического запуска хранителя экрана. 


Следующие операторы определяют характер упорядочивания свернутых 
окон: 


МТМТМТАЕРМЕТВТС5 ММ; 


ММ. соб1хе = 517еоЕ (МТМТМТЕЕОМЕТВТС$); 

сузсемРагамек ег ТптЕо (5РТ_СЕТМТМТМТОЕРМЕТВТС$, ММ. СБ ее, &ММ, 
0); 

ММ.1Аггапае = АКМ ВОТТОМЬЕЕТ || АВМ_О9Р; 

бузсетмРагаме<егзТптЕо (5РТ_5ЕТМТМТМТОЕРМЕТВТС$, ММ.сЮ$12е, &ММ, 
ЗРТЕ ОРРАТЕТМТЕТИЬЕ); 


Первый вызов Зу$зетРагатеег$ шо заносит в структуру ММ текущую 
метрику свернутых окон. Следующий оператор изменяет только одно поле, за- 
нося в него флаги, устанавливающие упорядочивание свернутых окон вверх от 
левого нижнего угла. Последний оператор фиксирует эти изменения в профи- 
ле пользователя. Теперь подобный характер упорядочивания будет действо- 
вать во всех приложениях. Можете это проверить, например, при работе 
с М\ога. 
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Хранитель экрана или заставка — это программа, срабатывающая, если 
пользователь в течение заданного отрезка времени не нажимал клавиш или 
кнопок мыши. 

Для того чтобы вызвать из своего приложения хранитель экрана, установ- 
ленный на данном компьютере как хранитель по умолчанию, достаточно вы- 
полнить команду | 


бепаМеззаде (НапЯ1е, ММ 5У5СОММАМОР, $5С ЗСВЕЕМЗАУЕ, 0); 


Впрочем, если вы знаете полное имя файла хранителя (далее будет показа- 
но, как его можно узнать), то более быстрый и качественный запуск заставки 
можно осуществить функцией ЭВе|Ехесще: 


5Ве11Ехеси®е (Напа1е, МОЬЬ, имя файла, "", МОБ, $М ЗНОММОВМАТ); 


Информация о хранителе экрана содержится в реестре в ключе 
НКЕУ_СОККЕМТ_ЧЦЗЕК \ Сопно! Рапе! \ ОезКюор. Параметр Зсгееп5ауеАснуе этого 
ключа определяет, предусмотрено ли автоматическое включение хранителя: 
О — не предусмотрено, 1 — предусмотрено. В параметре $сгееп5$ауе теО хра- 
нится время в секундах, через которое автоматически включается хранитель 
экрана. Параметр 5сгееп5ауе$5есиге определяет, защищен ли хранитель экра- 
на паролем: 0 — не защищен, 1 — защищен. 
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Параметр 5СКМФА\УЕ.ЕХЕ указывает файл хранителя экрана. Расширения 
этих выполняемых файлов .зсг, и хранятся они обычно в каталоге \У/1т4о\з 
оузет32 (может быть найден функцией Се ЗузетО1гесфогу), в котором хра- 
нится и статически связываемая с ними библиотека ЗСАМЗАУЕ.ГВ. 

Ниже приведен простой пример функции, позволяющей пользователю вы- 
брать в диалоге хранитель экрана и запустить его. Предполагается, что на фор- 
ме размещен диалог открытия файла Ореп 11051, в котором задан параметр 
Регап Ехё = "зсг", и фильтр ЕЩег =" Хранители экрана!*.зсг”". 


#1пс1аае "гед1зеку.Врр" 


у0о1А __Еаз®са11 ТГогм]1 : Вик оп1С11сК (ТОБ]есЕ *5епаег) 


{ 
ТКед1$егу *гед = пем ТВедазегу (КЕУ ИВТТЕ); 


гедз->Коо&Кеу = НКЕУ СОВБВЕМТ О5ЕВ; 

’ геа->ОрепКеу ("СопЕго1 Рапе1\\РезКф ор", Еа1зе); 
Орепр1а1о31->Е11еМаме = гед->Веаа$г1па ("5СВМЗАУЕ.ЕХЕ"); 
1Е (Орепр1а1о91->Ехесиее ()) 

{ 
геч->Мг1$се5ег1па ("ЗСВМЗАУЕ.ЕХЕ", ОрепО1а1о31->Е11еМаме); 
зепаМеззаде (НапЯ1е, ММ 5У$СОММАМО, $5С_ЗСВЕЕМЗАУЕ, 0); 


} 


гед->Егее (); 


} 


Приведенный код сначала читает в свойство ЕЦеМате диалога значение па- 
раметра ключа ЗСКМФА\УЕ.ЕХЕ в качестве начального приближения, задающего, 
в частности, каталог файлов хранителей экрана. А затем, если пользователь вы- 
брал хранитель экрана, имя выбранного файла заносится в реестр, и выбранный 
хранитель экрана запускается с помощью посылки сообщения функцией 
Зеп@Меззасе. Аналогичным образом нетрудно предусмотреть установку задерж- 
ки автоматического запуска хранителя и включение или выключение пароля. 

Впрочем, возможен и даже предпочтительнее другой вариант запуска хра- 
нителя экрана, который не изменяет запись в реестре, т.е. не нарушает устано- 
вок по умолчанию. Основной код может выглядеть так же, но после выбора 
пользователем вместо записи в реестр и посылки сообщения функцией Зепд- 
Мез5асе достаточно выполнить оператор: 


5ре11Ехесиее (Напа1е, МОГЬ, (Орепр1а1о31->Е11еМаме. с _$ег()), 
"", МОБ, 5И _5НОММОВМАТ) ; 


Вы не только не измените реестр, но и вызов хранителя будет произведен 
быстрее и качественнее. 

Многие хранители экрана предусматривают диалоговые окна настройки 
параметров. Эти окна можно вызвать, если выполнить файл хранителя функ- 
цией \/тЕхес или СгезжфеРгосе$$. Далее будет рассмотрен подобный вариант. 

В ключе НКЕ/ СОККЕМТ ЧЕК \ Сопно! Рапе! реестра для тех хранителей эк- 
рана, для которых задавались параметры настройки, имеются соответствую- 
щие разделы. Их имена начинаются с текста “"Бсгееп Зауег.”", после которого 
следует имя хранителя экрана. Например, для заставки "Бегущая строка” со- 
ответствующий раздел имеет имя “Зсгееп Зауег.Магацее”. В этом разделе, 
в частности, имеется параметр Техё, содержащий текст строки. Так что вы 
программно можете изменять этот текст в зависимости от состояния приложе- 
ния. Ниже приведен пример, задающий текст бегущей строки и запускающий 
этот хранитель экрана: | 
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#1п0с1аае "гед1зЕгу.Врр" 


\01А __Еаз®са11 ТЕогм1: : Ви оп1С11сК (ТОБ)есЕ *5ераег) 


{ 
ТРед156гу *геа = пем ТВедазегу(КЕУ ИВТТЕ); 
хед->ВооеКеу = НКЕУ СОВВЕМТ _О5ЕБ; 
хеа->ОрепКеу ("СопЕго1 Рапе1\\5сгееп бауег.Магацее", гие); 
хеч->Иг1ее5ег1па ("Техё", 
"Сейчас приложение реорганизует БД. Не трогать !!!"); 
хедч->С1озекКеу (); 
геч->Егее (); 
5Ре11Ехесиее (Напа1е, МОГЦ, 
"а: \ \Итпаоиз \ \ бузем32\\ззмагаие.зсг", 
"", МОБЬ, $М_Э5НОММОВМАЬ); 
} 


В этом примере, конечно, системный каталог надо заменить тем, который 
имеется на вашем компьютере, или получить его функцией Се Зузет- 
Плгесфогу. | 

В ресурсах файлов заставок первой строкой хранится название заставки, для 
русифицированных версий — на русском языке. Эти строки полезны, если надо 
предоставить пользователю возможность выбрать одну из нескольких заставок. 

Выше рассмотрен доступ к информации о хранителе экрана через реестр. 
Но доступ к подобной информации можно получить и с помощью функции 
ЗузбетРагатеф ег Шо (см. разд. 1.3). Например, следующие операторы зане- 
сут в переменную Ё, значение фгие, если режим автоматического запуска хра- 
нителя экрана включен, и значение #а15е, если он выключен: 


Боо1 1; 
зузсемРагаме+ ег ТпЕо (5РТ_ СЕТЗСВЕЕМЗАУЕАСТТУЕ, 0, &6, 0); 


После каких-то изменений значения переменной Г, сделанных пользова- 
телем или программой, ее можно записать в систему операторами 


Сага1па1 $5еф55; 


Е (1) 
5еЕ55 = 1; 
е1зе 5е$55 = 0; 
сузсемРагаме®егТпЕо (5РТ_ЗЕТЗСКЕЕМЗАУЕАСТТУЕ, $5е%55$, МОБ, 
ЗРТЕ _ЗЕМОСНАМСЕ); 


Приведенные ниже операторы читают в переменную Типе заданную в сис- 
теме задержку срабатывания хранителя экрана: 


106 Т1пе; 
бузсетРагамефегзТпЕо (5РТ_СЕТЗСКЕЕМЗАУЕТТМЕОЧТ, 0, &Т1те, 0); 


А следующий оператор запоминает в системе значение задержки, храня- 
щейся в Тише: 


бсузсемРагамек ег ТптЕо (5РТ_ЗЕТЗСКЕЕМЗАУЕТТМЕООТ, Т1ме, МОБГ,. 
ЭРТЕ ЗЕМОСНАМСЕ); 


В приведенных примерах установки, заносимые в систему, действуют 
только в текущем сеансе работы пользователя. После перезагрузки системы 
они исчезнут. А если последний параметр функции ЗузбетРагатеф ег шо 
при записи будет иметь значение не ЭРГЕ_ЗЕМРСНАМСЕ, а ЭРТЕ_ОРРАТЕ- 
ПМТЕШЕ, то сделанные установки зафиксируются в реестре и сохранятся по- 
сле перезагрузки системы. | 
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Можно также предоставить пользователю возможность выбрать и настро- 
ить хранитель экрана с помощью вызова окна свойств экрана. Этот вызов осу- 
ществляется следующим оператором (см. разд. 1.12): 


И1тпЕхес ("Сопёго1.ехе аезКк.ср1", $И_ВЕЗТОВЕ); 


То же самое можно сделать с помощью функции СтезеРгосе5$ или функ- 
ции ЭвВе|Ехесце: 


З5Ре11Ехесиее (Напа1е, МОТ, "Сопего1.ехе", "аезк.ср1", МОШЦ, 
$И _ЗНОИМОВМАЬ) ; 


Рассмотрим теперь развернутый пример, демонстрирующий все возмож- 
‚ ности, изложенные выше. Это пример 5сгеепбаиег, который имеется на диске, 
приложенном к книге, в каталоге И1таоиз. Окно приложения во время вы- 
полнения приведено на рис. 1.2. Верхняя панель окна позволяет пользователю 
выбрать один из хранителей экрана, установить его параметры, протестиро- 
вать заставку. Выпадающий список (его имя в тексте примера СотфоВох!.) со- 
держит список строк описания всех доступных хранителей экрана. Кнопка 
Другой (имя ВЕ19) дает возможность выбрать с помощью стандартного диало- 
га открытия файла отсутствующий в списке хранитель экрана, лежащий в ка- 
ком-то другом, не системном каталоге. Этот файл запоминается приложением, 
и его информационная строка добавляется в список СошфоВох1. 


Рис. 1.2 Ин: Хранитель экрана се т о 1х 
Окно примера работы с хранителями экрана ‹ Выбор файла хранителя экрана’ ^^^ 


Файл з<Нифох. $ с! 


| Метаморфозы * 


Другой | 


:`Параметры - ее еее ная и 


Использовать ^^^: 


‚ {$ всегда 


‚ С вданном сеансе 


‚ М Применять 
Установить | 
‹ Г Пароль. 


‚ Окно "Свойства экрана" - -—- ^^^ 


Если пользователь выбрал хранитель экрана из списка или с помощью 
кнопки Другой, в панели Рапе!1 появляется тестовое окно, в котором в умень- 
шенном виде отображается работающая картинка заставки. 

Кнопка Параметры (ВРагат) открывает для выбранного в списке храните- 
ля экрана присущий ему диалог задания параметров. Если такого диалога нет, 
выдается текст: «Эта заставка не имеет настраиваемых параметров». Кнопка 
Просмотр (ВТе$$) позволяет посмотреть заставку с заданными параметрами, но 
уже не в тестовом окне, а развернутую на весь экран. 
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Панель Параметры в средней части окна позволяет запомнить в качестве 
хранителя по умолчанию файл, выбранный в верхней панели. Группа радио- 
кнопок Использовать позволяет указать, будут ли работать заданные установки 
всегда, или только в текущем сеансе работы пользователя. Окно Интервал 
(ЭЗртЕЧЕТ) задает задержку срабатывания хранителя в минутах. Индикатор 
‘’ Применять (СвесКВох1) определяет, будет ли задан режим автоматического 
включения хранителя экрана. Индикатор Пароль (СВескВох2) указывает, бу- 
дет ли заставка защищена паролем. Кнопка Установить (В\УтЦе) заносит все ус- 
тановки в систему, включая файл хранителя, выбранный в списке СотЪо- 
Вох1. При этом группа радиокнопок Использовать (Ва41оСгоир1) определяет, 
будет ли действовать установка только в течение данного сеанса работы поль- 
зователя, или она будет постоянной. 

Кнопка Вызвать (ВСРапе!) в нижней панели окна вызывает окно свойств 
экран, в котором пользователь может задать установки хранителя средствами 
УИ тао\з. Заданные установки отобразятся в окне данного приложения. В на- 
чале выполнения приложения все окна и индикаторы приложения также ото- 
бражают текущие установки системы. 

Ниже приведен текст этого приложения. 

Описание класса формы в заголовочном файле Зсгеепбауег.й: 


с1аз$5 ТЕГогм1 : роаБ]11с ТРогм 


{ 
рг1уафе: // Изег аес]агаЕ1оп5$ 


у0о1А __Еазса11 ММАСТТУАТЕ (ТИМАСЕ1уа*е&); 
У01А __Еаз®са11 Веаа5ауег(); 
руЮ11с: // И5ег 4ес]1агаЕ1опз$ 
ВЕСТМ_ МЕЗЗАСЕ МАР 
МЕЗЗАСЕ _НАМОТЪЕВК (ИМ АСТТУАТЕ, ТИМАС®1уафе, ИМАСТТУАТЕ); 
ЕМР МЕЗЗАСЕ МАР (ТСомропеп®); 


} 
Файл реализации: 


#10с1а4е <ус1.6> 
#ргадма Юахгз®ор 


#1пс1аае "5сгеепбауег.В" 
#10с1аае "гедтзегу.Юрр" 
#1п0с1аае "и1пБазе. в" 


Ёргадчта раскаде (зщаг® 1п14) 
#ргачта 11пК "С5РТМ" 
#$ргачта гезоцгсе "*.аАЁм" 
ТЕоги1 *РГогш1; 


сраг ТРапе1 = ' #!; 

ТВед1$6гку *гед; 

Т5Ег1па1$6е *113$6; 
ТзбагсарТпЕо баг ТпЕо; 
ТРгосеззТпЕогма®1оп РгкосТпЕо; 
106 Т]име, 1гез; 


у01А _ Еаз®са11 ТГогм]1 : : Веаабауег () 
{ . 
106 Т]ие, 1гез; 
роо1 Г; 
ТбеагспВес 58; 
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Ап5156г1па ПО1гбауег, СаггкепЕбауег, разз; 
НМОРОТЕ Напа; 
сраг Маме [МАХ _РАТН]; 


гедч->КооеКеу = НКЕУ СОВВЕМТ О5ЕБ; 
зузсемРагате® ег ТпЕо (5РТ СЕТЗСВЕЕМЗАУЕАСТТУЕ, 0, &1, 0); 
Гоги1->СвескКВох1->Сцескеа = 1; 
зузсемРагамекег$ТпЕо (5РТ_ СЕТЗСВЕЕМЗАУЕТТМЕОЧТ, 0, &Т1пе, 0); 
Гоги1->С$р1пЕЗ1{1->Уа1ае = Тлше / 60; 

Т = геа->ОрепКеу ("СопЕго1 Рапе1\\РезкКвор", Еа1зе); 
СиггепЕбауег = гед->Веаа5 © г1па ("ЗСВМЗАУЕ.ЕХЕ"); 


раз$ = гед->Кеаа$Ег1па ("бсгеепбауегТз 5есиге"); 
`гед->С1озеКеу(); 
СпескКВох2->СПескеЯ = (раз$ == "1"); 


Орепр1а1о91->Е11еМаще = СиггепЕбауек; 
21гбауег = Ехегас®Е11ер1г (Саггепебауег); 
ТМапе->Сар®1оп = "Файл " + Ехегас®Е11еМаме (СаггепЕебауег); 
Т1$6->С1еаг(); 
СопроВох1->С1еах (); 
1гез = Е1паЕ1т5$% (01гбауег + "\\*.5зсг", ЕаАпуЕ11е, 58); 
\р1]1е (1гез == 0) 
{ 
115Е->ААА (21хгбахег + "\\" + 5В.Мапе); 
Напа = ГоаЯТ1фгахгу ( (2Р1гбауег + "\\" + 5В.Маше).с_$Ех()); 


1Е (Напа == 0) 
РГогп1 ->СомбоВох1->ТЕет5->Ааа (5$В.Маме); 
е1зе 


{ 
Тоаа5х1пд (Напа, 1, Маме, МАХ _РАТН); 
ЕгееГ1Ьгагу (Напа); 
СопроВох1->Т$етз->АЯа (Мапе); 
} 
1гез = ЕлпамМехе (58); 
} 
Р1паС1озе (58); 
СопЬоВох1->Т+&епйТпаех = 11$5Е->ТпаехОЕ (СаиггхепЕбауег); 
СопроВох1С1о5е0р (Гогм1); 


\01Аа _ Еаз®са11 ТЕогш1:; :ГогиСгеаее (ТОБ]ес® *5бепаег) 
{ 

ге = пем ТКед1$6гу(); 

15 = пем Т5Ег1п91156Е; 

гед->ВоосКеу = НКЕУ СОККЕМТ О5ЗЕК; 


зефмем (&ЗЕакеТпРо, 517е0Е (Зсаг®ТпЕо), 0); 
СЕахЕТпЕо.ср = $127ео0Е (Зеаг®ТпЕо); 
СбакЕТпЕо.ЧмЕ1аачз = 5ТАВТЕ ОЗЕЗНОМИТМРОИ; 
СфахеТпЕо.м5ПомИ1паом = $5мМ ЗНОММОВМАТ; 
Веаабауег (); 


\01А _ Еаз®са11 ТЕоги1: :СомроВох1С1озе0р (ТОБ)]есе *5епаег) 
{ 

Орепр1а1091->Е11еМаме = 1156->56г1па$ [СотБоВох1->ТеешТпаех]; 
ТМапе->Сарф1оп = "Файл" + 

Ехегас®ЁР11еМаме (Орепр1а1о91->ЁР11еМаме); 
1Е (РгосТрЕо.ВРгосез$ != 0) 
Тегм1пафеРгосез$ (РгосТпЕо.НРгосе$$,0); 

СгеафеРгосезз$ (МОТ, (ОрепрО1а1о91->ЕР11еМаме + Апз15$6г1па(" -р") 
+ ТоеТобек ( (106) (Рапе11->Напа1е))) .с_3зЕг(), 

МОТ, МОЬГ, Еа1зе, 0, МОБ, 

МОЬБЬ, &ббахеТпиЕо, &РгосТпЕо); 
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У01А __Еаз®са11 ТКГогп1: :ВЕ1паС11сК (ТОБ)есЕ *5епаег) 
{ 

НМОРОТЕ Напа; 

сваг Мате [МАХ_РАТН]; 


1Е (Орепр1а1о91->Ехесафе () ) 
{ 
ТМапе->Сар®1оп = "файл " + 
Ех гас®Е11еМаме (Орепр1а1о91->Е11еМапе); 
Т13Е->ААА (Орепр1а1031->Р11еМапе); 


Напа = ГоааГ1ргаку (РСпаг (ОрепО1а1091->Е1]еМаме.с_з6г())); 
1Е (НапЯ == 0) 

СопроВох1->Т$етз->Ааа (Орепр1а1091->Е11еМапе); 

е1зе 


{ 

.оаа5Ет1па (Напа, 1, Маме, МАХ _РАТН); 

ЕгееГ1ргакгку (Напа); | 
СопроВох1->Т+етмз->АЯа (Маме); 

} 

СопроВох1->ТкетТпаех = СоптбоВох1->Т$еп$->Сочп® -— 1; 
СопроВох1С1о5е0р (5епаег); 


нннннннннннненнннн--н=-=================-===-- 
\01А __Еаз®са11 ТГогм1-: :ВРагатС11сКкК (ТОБ)]есЕ *бепаег) 

{ 

И1пЕхес ( (ОрепО1а1031->Е11еМаме + " -с") .с_56г(),5М ВЕЗТОВЕ); 
ТРапе1 = 'р'; 

} 

ня нннннннененннннннннн+-===========- 


уо1А _ Еаз®са11 ТГогм1:; :ВТез®С11сК (ТОБ]ес& *5епаег) 
| 
5ве11Ехесосе (Напа1е, МОГ, 
РСВаг (Орепр1а1о0о31->Е11еМаме.с_з%г()), "", 
МОЪЬ, 5М_ЗНОИММОВМАЬ); 


у01а _ Еаз®са11 ТЕоги1: :ВСРапе1С11сК (ТОБ]есе *5епаег) 
{ 

И1пЕхес ("Сопёго]1.ехе ЧезК.ср1",5И ВЕЗТОВЕ); 

ТРапе1 = 'с'; 


уо1А __ЁЕаз®са1] ТКогп1: : ВМг1®еС11ск (ТОБ]есе *5епаег) 
{ 

Сага1па1 5еф55$, Ораафе ; 

1Е (СПесКВох1->СфескКеа) 


5еЕ55 = 1; 
е1зе 5еЕ55 = 0; 
1Е (Ваа1тобгопр1->Т$епТпраех == 0) 


Ораафе = ЗРТЕ ОРРАТЕТМТЕТЬЕ; 

е15е ОрааЕе = 5РТЕ ЗЕМОСНАМСЕ; 

ЗузкетРагатекегТпЕо (5РТ_ ЗЕТЗСКЕЕМЗАУЕТТМЕОСТ, 
С$р1пЕЧ11->Уа1ае * 60, МОЬЬ, Орда%е); 

ЗузсемРагамееегзТпЕо (5РТ ЗЕТЗСВЕЕМЗАУЕАСТТУЕ, $е%к5$, МОЬЬ, 
Орда*е); 

геч->ОрепКеу ("СопЕго1 Рапе1\\БезкКфор", ЁЕа1зе); 

гед->Мг1$ебег1па ("ЗСВМЗАУЕ.ЕХЕ", 

156 ->56г1паз$ [СотроВох1->ТЕепТпаех]); 

1Е (СрескКВох2->Спескеа) 

гед- ЫИЕ1Еезктапа ("Зсгеепзауегтэбесике", 1") 

е15е геад->Мг1$кебЕег1па ("бсгеепбауегТз5есиге", "0"); 
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гед->С1озеКеу(); 


_уо1а _ Еаз®са11 ТЕГогш1: : ИМАСТТУАТЕ (ТИМАСсе1уаее & а) 


{ 
1Е (а.Аселуе == ИА_АСТТУЕ) 


{ 
$м1ЕСП ( ЬРапе] ) 


{ 

сазе 'с': Тафбе13->СарЕ1оп = ТРапе1; 
Веаа5ауег(); | 
ЮгеаКк; 

сазе 'р': СомбоВох1С1озеОр (Еогм1); 


} 
ТРапе]1 = ' !; 


а.ВКези1е=0; 


4 
} 


} 

В заголовочном файле в классе формы объявлена функция Веа@Зауег, 
обеспечивающая чтение в приложение текущих настроек, связанных с храни- 
телем экрана, и обработчик \УМАСТТУАТЕ сообщения \УМ_ АСТТУАТЕ. Не- 
обходимость введения этого обработчика связана со следующим. В приложе- 
нии предусмотрены кнопка Вызвать, открывающая окно свойств экрана, 
и кнопка Параметры, открывающая окно настройки параметров хранителя эк- 
рана. Желательно, чтобы настройки, которые сделает пользователь в этих ок- 
нах, отобразились в окне приложения. Но задержать выполнение приложения 
на время работы пользователя, например, с окном свойств экрана не получает- 
ся (см. разд. 1.12). Поэтому отлавливается момент активизации приложе- 
ния — сообщение ММ_ АСТТУАТЕ, поступающее в момент, когда окно акти- 
визируется после того, как пользователь работал с другим окном. И в обработ- 
чике этого сообщения читаются настройки хранителя экрана. | 

Потеря фокуса окном приложения может быть связана и с вызовом окна 
свойств экрана, и с вызовом окна настройки параметров, да и просто пользова- 
тель может на какое-то время переключиться на другое приложение. Поэтому 
в файле реализации вводится глобальная переменная ЕРапе]. Она всегда равна 
символу пробела, за исключением случаев вызова окна свойств экрана (тогда 
она равна "с”) и вызова окна параметров хранителя (тогда она равна "р”). Так 
что по значению этой переменной в обработчике сообщения \УМ_АСТГУАТЕ 
можно определить, какие действия следует предпринять. 

Глобальная переменная гей представляет собой объект типа ТВКез1$%ху, ис- 
пользуемый в приложении для работы с реестром. А переменная 1[1$% содер- 
жит список имен файлов доступных хранителей экрана. 

Переменные ЗЭфаг по и Ргос0\о используются для вызова функции 
СгеафеРгосе$$, необходимость которой будет пояснена позднее. 

Перейдем теперь к рассмотрению функций. Функция ЕогтСгеафе создает 
в момент создания формы объекты гей и 11$. Эти объекты уничтожаются 
в функции ЕогтОе$ {гоу при завершении выполнения приложения. При созда- 
нии формы заполняются также обязательные поля структуры Зфаг _ифо, кото- 
рая потребуется в дальнейшем для вызова СгеафеРгосе$$. После этого в функ- 
ции ЕогтСгеа{е вызывается функция Веа9$ауег, которая читает информа- 
цию о текущих настройках хранителя кода и производит настройку компонен- 
тов приложения. 

Функцией ЗуфетРагатеег Шо с параметром ЗРТГСЕТЗСКЕЕМЗАУЕ- 
АСТТУЕ в переменную Г, читается настройка режима автоматического вклю- 
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чения хранителя. Это значение определяет состояние индикатора СвесКВох1. 
Затем функцией ЗузетРагатеег$шФо с параметром ЗРГ СЕТЭСВЕЕМЗА- 
УЕТТМЕОТСТ в переменную Тйте читается задержка срабатывания хранителя 
в секундах. Значение этой задержки переводится в минуты и заносится в ком- 
понент ЭршЕЯЁ1. Далее в переменную Сиггет5ауег читается из реестра имя 
файла текущего хранителя экрана. В переменную ра$$ читается значение, по- 
казывающее, используется ли пароль в хранителе экрана. Эта переменная 
трансформируется в состояние индикатора СВеекВох2. После окончания чте- 
ния из реестра ключ закрывается методом СозеКеу, чтобы не держать этот 
ключ открытым дольше, чем требуется. 

Прочитанное имя файла хранителя экрана заносится в диалог Ореп- 
П1а10521 как начальное приближение для поиска других файлов. Из имени 
файла извлекается функцией Ехйгас ЕПер!` каталог хранителя экрана и зано- 
сится в переменную ПО1тЗауег. Вместо этого оператора можно было бы исполь- 
зовать операторы 

сраг паме [МАХ РАТН]; 


Сеебузкетр1кескоку (паме, МАХ _РАТН); 
21гбауег = папе; 


задающие в качестве каталога хранителей экрана системный каталог. Если те- 
кущий хранитель экрана хранится в этом каталоге, что обычно рекомендует- 
ся, то результат будет тот же самый. 

Далее начинается поиск всех файлов хранителей экрана в каталоге О\1г- 
Зауег. Списки 11$ и СотшБоВох1{1 очищаются. Затем функциями ЕщЕ! $$, 
ЕтаМ№ хе, Ет@9(С]озе ищутся в ОйгЗауег файлы с расширением .зсг. Полное 
имя каждого найденного файла заносится в список [1$%. А в СошБоВох1 жела- 
тельно заносить не эти имена, ничего не говорящие пользователю, а строки 
описания, хранящиеся в ресурсах соответствующих файлов. Для извлечения 
этих строк сначала файл загружается функцией ГоаЧТлЬгагу, и в переменную 
Нап заносится его дескриптор. Если эта операция прошла с ошибкой, значе- 
ние Напд будет равно 0. В этом случае в СотБоВох1 заносится имя файла. 
А если загрузка модуля файла прошла успешно, то первая строка его ресурсов 
читается в переменную Маше и добавляется в список СошБоВох1. Загружен- 
ный модуль освобождается функцией ЕгееТгагу. 

После завершения поиска всех файлов индекс списка СотфоВох1 задается 
соответствующим текущему хранителю. Это осуществляется методом ш4ехОЁ 
списка 11$, определяющим индекс, который имеет в списке файл Саггеп{- 
`Бауег. Затем следует вызов описанной далее функции СотфоВох1СозеОр, ко- 
торая обеспечивает, в частности, отображение хранителя экрана в тестовом 
окне. 

Мы рассмотрели чтение информации в наше приложение. Обратную зада- 
чу записи в систему настроек, сделанных пользователем, решает функция 
В\/гцеСПсК — обработчик щелчка на кнопке Установить. В начале этой функ- 
ции состояние индикатора СВесКВох1 (Применять) переводится в значение пе- 
ременной 3е55: 1, если индикатор включен, и 0 в противном случае. Состоя- 
ние группы радиокнопок ВаФюоСгоир1 (Использовать) переводится в значение 
переменной Орда е. Если выбрана кнопка всегда, то этой переменной задается 
значение ЗРТЕ ОРОАТЫМТЕП.Е, обеспечивающее в дальнейптем занесение 
информации в реестр. А при выбранной кнопке в данном сеансе переменная 
Орда{е получает значение ЭРТЕ_$ЗЕМРСНАМСЕ. Это приведет к тому, что со- 
храненные настройки будут действовать только в данном сеансе работы поль- 
зователя. 
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Затем следует занесение настроек в систему. Функция ЗузетРагате4ег<- 
{о с параметром ЗРТ_ЗЕТЭЗСВЕЕМ$ АУЕТТМЕОТПСТ устанавливает время за- 
держки, взятое из компонента ЭртЕЗИТ и переведенное в секунды. Вызов 
функции ЗузетРагате ег Шо с параметром ЭРТ ЗЕТЗСВЕЕМ$ АУЕАС- 
ТТУЕ устанавливает режим автоматического срабатывания хранителя экрана. 
Далее в реестр заносится имя файла, выбранного пользователем в списке 
СотБоВох]1 и хранящееся в списке 1115$. Заносится также информация 06 ис- 
пользовании пароля. 

Функция СотБоВох1С1озеОр является обработчиком события ОпСюо5е0р 
списка СошфоВох1. Эта же функция вызывается из. функций Кеа4Зауег 
и ВЕЩЯСПсК для отображения выбранного хранителя экрана в тестовом окне. 
В ней имя выбранного пользователем файла заносится в диалог Ореп1а10о51 
и в метку ЕМаше, размещенную над этим списком. А затем следуют операто- 
ры, вызывающие хранитель экрана для получения изображения в тестовом 
окне Рапе1. Остановимся на этих операторах подробнее. 

Для того чтобы направить изображение хранителя экрана в какое-то окно, 
надо вызвать модуль хранителя, передав в него через командную строку оп- 
цию "-р”, после которой указать дескриптор окна. Учитывая, что в нашем 
примере имя файла хранителя находится в свойстве ОрепО1а1051—>ЕПеМате, 
а тестовое окно — это панель Рапе! 1, подобный вызов можно сделать, напри- 
мер, оператором: 


И1рЕхес ( (Орепр1а1091->Е11еМатме + Апз1бЕг1па(" -р") _ 
ТпЕТобег ( (1108) (Рапе11->Напа1е))).с_5Ег(),5И ВЕЗТОВЕ); 


После выполнения этого оператора хранитель начнет работать и в панели 
Рапе!1 появится соответствующее изображение. Но если пользователь далее 
выберет в списке другой хранитель экрана, то этот хранитель также направит 
свое изображение в Рапе!1. А поскольку ранее вызванный хранитель экрана 
будет продолжать свою работу, в окне Рапе!]1 произойдет накладка двух изо- 
бражений. Это нас, конечно, не устроит. Так что перед запуском нового храни- 
теля надо прекратить выполнение прежнего. Но для этого надо знать его деск- 
риптор. А при использовании для запуска функции УтЕхес дескриптор нам 
не известен. Именно поэтому целесообразно запускать хранитель экрана функ- 
цией СгеаферРгосез$. Соответствующий оператор вы видите в функции СотЪо- 
Вох1СозеОр. Вызов СгежеРгосе$$ обеспечивает занесение информации о пО- 
рожденном процессе в структуру Ргос По. Поле ВРгосе5$ этой структуры со- 
держит дескриптор порожденного процесса. Так что перед вызовом Сгеафе- 
Ргосез$ в функции СошфоВох1С]1озеОр проверяется, имеется ли уже порож- 
денный процесс, т.е. отличен ли от нуля дескриптор РгосП\о.ВРгосез$. Если 
порожденный процесс имеется, он завершается функцией ТегпипафеРгосе$$. 
И только после этого вызывается новый хранитель экрана. 

Функция ВЕШАСЦсК является обработчиком щелчка на кнопке Другой. 
Если пользователь выбрал в диалоге новый файл хранителя экрана, то произ- 
водятся операции, аналогичные рассмотренным ранее в функции Кеа@Зауег. 
Новый файл добавляется в список 1/1$%, а в список СошЪоВох1 заносится его 
строка описания, извлекаемая из ресурсов. После этого вызывается описанная 
выше функция СошфоВох1С1озеОр, отображающая изображение выбранного 
хранителя в тестовом окне. | 

Функция ВРагаштСИеК является обработчиком щелчка на кнопке Парамет- 
ры. В этой функции надо вызвать окно задания параметров того хранителя эк- 
рана, имя файла которого записано в свойстве ЕИеМате компонента Ореп- 
01аю51. Вызов такого окна осуществляется передачей в модуль хранителя эк- 
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рана опции "-с". Впрочем, для большинства хранителей экрана окно задания 
параметров вызывается и без этой опции. После завершения пользователем ра- 
боты с этим окном надо отобразить в приложении результаты настройки. Для 
этого надо вызвать уже рассмотренную ранее процедуру СотБоВох1С]озеТр. 
Но если вызывать эту процедуру сразу после вызова окна настройки функцией 
\М/тЕхес, то ничего не получится. Функция будет вызвана раньше, чем поль- 
зователь завершит работу по заданию параметров. Поэтому в функции ВРа- 
гатСИсК задается значение “р” флагу ГРапе|. По этому флагу будут произве- 
дены соответствующие действия в обработчике сообщения \УМ_ АСТТУАТЕ. 

Функция ВТез$&СПИсК является обработчиком щелчка на кнопке Просмотр. 
В ней вызывается функцией Зве|Ехесще соответствующий хранитель экрана. 

Функция ВСРапе]1СПсК является обработчиком щелчка на кнопке Вызвать. 
В ней вызывается функцией У шЕхес стандартное окно свойств экрана УМ т- 
Чомз. После этого флагу ГРапе! задается значение "с”. Это, как было описано 
ранее, обеспечит соответствующую реакцию функции \УМАСТТУАТЕ — обра- 
ботчика сообщения \М_АСТТУАТЕ. В этой функции проверяется, какое 
именно сообщение пришло: об активации или о деактивации. Если окно акти- 
вируется (поле Аейуе сообщения равно \УА_АСТТУЕ), тогда проводится ана- 
лиз флага ГРапе|. Если он равен "с", значит вызывалось окно свойств экрана. 
В этом случае вызывается описанная ранее функция Веа4$ауег, обеспечиваю- 
щая чтение системной информации. А если флаг ГРапе] равен “р”, значит пе- 
ред этим вызывалось окно задания параметров хранителя экрана. В этом слу- 
чае происходит вызов функции СотфБоВох1С1о5е0р, обеспечивающей отобра- 
жение новых параметров хранителя в тестовом окне. В любой ситуации значе- 
ние Г.Рапе! устанавливается равным “ ", чтобы в дальнейшем обработчик не 
производил чтения информации, пока пользователь снова не вызовет одно из 
предусмотренных в приложении окон настройки. 
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Информация об обоях Рабочего стола хранится в реестре в ключе 
НКЕУ_СОККЕМТ_ОЗЕК\Сопно! Рапе\РезКюр. Параметр У!аПрарег содержит пол- 
ное имя файла обоев с путем к нему. В качестве обоев может использоваться 
любой файл „.6тр, .51{, ДрЕ. Параметры Т!е\/аЙрарег и \У/аЙрарег5!уе ключа оп- 
ределяют способ ‘отображения обоев: 


ито иных ——==—=————— —_—_———— ый — 


Отображение . _'ТИе\’аПрарег \аПрарег{Уе _ 


УД 


Растянуть 0 | 2 


| 
1 
1 
| 
и 
——. - ——- ой 


10. ИИ. 


И 
И] 


по центру _ 
| за замостить (рисунок Г размножается) —_ __ 19 _ 


Задать файл обоев можно непосредственно в параметре \/а!рарег. Но эта 
установка сработает только после перезагрузки системы. Так что программное 
изменение обоев удобнее осуществлять с помощью функции ЗузетРагате- 
фег$ шо (см. разд. 1.3). Оператор имеет вид: 


зузсетРагамее ег ТпЕо (5РТ_ЗЕТРЕЗКИМАГТРАРЕВ, О0, 
имя файла, Ордафе); 


Выполнение этого оператора вызовет немедленное обновление обоев. В ка- 
честве имени файла в операторе надо задать имя графического файла с полным 
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путем к нему. А параметр Ордае может принимать значения ЭРТЕ_ЗЕМО- 
СНАМСЕ — установить обои только на протяжении текущего сеанса работы 
пользователя, и ЗРТЕ_ОРРАТЕГМТЕП.Е — установить обои постоянно. 

Правда, надо оговориться, что файлы обоев, отличные от .6тр, устанавди- 
ваются таким оператором не во всех версиях У/ш4о\з. 

Рассмотрим пример работы с обоями. Этот пример содержится в проекте 
У’аПрарег в каталоге У1таоиз на приложенном к книге диске. Его окно во вре- 
мя выполнения показано на рис. 1.3. Панель Выбор файла обоев (ее имя в при- 
веденном далее коде СгопрВох1) содержит компонент Ппаре1, отображающий 
изображение файла обоев. Параметр Ащюз1те в этом компоненте установлен 
в Ра!5е, а параметр ЭётеёеВ — в фгие. Это обеспечивает режим растягивания. 
изображения по площади Ппасе1т. Можно было бы реализовать и другие вари- 
анты отображения: по центру и замостить. Но я не стал усложнять пример, 
чтобы не отвлекаться от его основной задачи — показать работу с обоями. 


Рис. 1.3 0 Обои Рабочего стола И = 
Приложение ‚ Выбор файла обоев-————^ ^^^. ‚Параметры —- -—— ЫДФтттв—5—д—юыюы— 
установки обоев . __ | __ -Использовать-———— 


Рабочего стола | асяниь У} 
И | 
7 Установить | | 
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`` вданном сеансе 


| 
. 
| 
у 


ООО 


Окно "Свойства экрана"——————————— 


_. Вызвать 


‚ Файл Безмятежность.6тр (о 
[Безмятежность т] Другой | 


+ а 


‚- 
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Панель Выбор файла обоев содержит также выпадающий список (СошЪо- 
Вох1) с именами файлов обоев без путей и расширений. Эти файлы автомати- 
чески загружаются в список из того каталога, в котором расположен файл обо- 
ев, установленный в данный момент в системе. Выбор файла в списке отобра-. 
жает выбранные обои в компоненте ГПтабе1. В метке над этим списком. 
(Т.Мате) отображается имя файла с расширением. Кнопка Другой (ВЕ1т9) по- 
зволяет выбрать для обоев любой графический файл в любом каталоге. Этот 
файл занесется в список СошфоВох1 и отобразится в Ппабе1. 

Панель Параметры позволяет задать параметры отображения обоев и уста- 
новить их в системе. Выпадающий список СошфоВох (СВ Ее) содержит стро- 
КИ «растянуть», «по центру», «замостить», соответствующие возможным сти- 
лям изображения обоев. Выбор в этом списке влияет на стиль, задаваемый 
в системе, но не влияет, как было сказано выше, на изображение в Ппайе1. 
Кнопка Установить (ВУ\УгЦе) заносит все установки в систему, включая файл 
обоев, выбранный в списке СошфоВох{. Заданные установки немедленно.ото- 
бражаются в обоях Рабочего стола. При этом группа радиокнопок Использовать 
(Ка4100гопр1) определяет, будет ли действовать установка только в течение 
данного сеанса работы пользователя, или она будет постоянной. 

Кнопка Вызвать (ВСРапе!) в нижней панели окна вызывает окно свойств 
экран, в котором пользователь может задать установки обоев средствами 
\М/114о\5. Заданные установки отобразятся в окне данного приложения. В на- 
чале выполнения приложения все окна и индикаторы приложения также ото- 
бражают текущие установки системы. 
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Ниже приведен текст этого приложения. 
Описание класса формы в заголовочном файле: 


с1аз$ ТГогт1 : руЪ11с ТЕГогм 


{ 
__ручр11зВед: 


рг1уафе: // 0Озег аес]агаЕ1оп$ 


у01А __ ЁЕаз®са11 ТКГогш1: : ММАСТТУАТЕ (ТИМАСЕ1уаке &б а); 
Уу01А __Еаз®са11 ТГогм1: : ВеааТпЕЁ(); 


руЬ11с: // Озег аес1агаЕ1опз$ 
__ Еазеса11 ТГогм1 (ТСотропепе* Омпег); 
ВЕСТМ МЕЗЗАСЕ МАР 
МЕЗЗАСЕ НАМОГЕВ (ИМ АСТТУАТЕ, ТИМАСЕ 1уафе, ИМАСТТУАТЕ); 
ЕМР_МЕЗЗАСЕ МАР (ТСопропепе); 
}; 


Файл реализации: 


#1пс1аае <ус1т.В> 
#1пс1аае <)редз.Врр> 


ТВед1зегу *гез = пем ТВедлазегу; 
Т5Ег1п91$6е *1Г15е = пем Т5Ег1п9115%; 
Боо1 ГРапе1=Ёа15е; 


у01А __ЕазЕса11 ТГоги1: ; ВеааТпЕ () 
{ 
106 1гез$; 
ТбеагсПВес 58; 
Ап5156г1па П01гМа11рарег, СаггепЕМа11рарег, Т11еЙа11]рарег, 
Иа1]рарег5®у1е, ехё, 51; 


хеч->ОрепКеу ("СопЕго1 Рапе1\\БезКеор", Еа1зе); 
СиггепМа1]рарег = гед->Веаа5Ег1па ("Иа11рарег"); 
Т1]ейа11рарег = гед->Веаа$г1па ("Т11ема11рарег"); 
Иа]]1рарег5®у1е = геад->ВеаЯ5Ег1пча ("Ма1]рарег5еу1е"); 
гез->С1озекКеу (); 


1Е ((Т11еЙа11рарег == '0') && (Ма]1рарег5®у1е == '2')) 
СВ5+у1е->ТфепТпаех = 0; 

е] зе 1Е ((Т11еЙа11рарег == '0') && (Ма11рарегбеу1е. == '0')) 
СВ$$у1е->ТеетТпаех = 1; 

е15е 1Е ((Т11еМа11рарег == '1') && (Ма1]1рарег5еу1е == '0')) 
СВ5еу1е->ТфепТпаех = 2; 


ОрепР1сфигер1а1о31->Е11еМмаме = СаггепЕИМа11рарег; 
21:хМа11рарег = ЕхЕгас®Е11ер1г (СагхгепЕМа11рарег); 
ТМате->Сар®1оп = "Файл " + 

ЕхегасеЕ11еМате (СоггепЕМа11рарег) + '"'; 
Т156->С1еаг(); 
..СотроВох1->С1еаг(); 


51= 01хМа11рарег + "\\*.*"; -. 

1гез = Е1паЕ1г5е (51, ЕаАпуЕ1]е | ЕаАгсЬ1уе , 58); 
мр11е (1хез$ == 0) 

{ . 
ехЕ = ЕхЕгас®Е1]еЕх+ (5В.Маме); 

1Е ((ехе == ".Бпр") || (ехё == ".)ра") || (ехе == ".да1Е")) 
{ 

Т1$2->ААА (21гМа1]рарег + "\\" + $В.Маме); 
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СопроВох1->Т6емз->Ааа 
(5ВК.Маме.зееЬепаев (5В.Маще.ТепаеВ ()-4 ) ); 


} 
1гез = Е1лпамехе (58); 


} 
Е1паС1озе (58); 
СопроВох1->Т$етмТпаех = 115%->1паехОЕ (Саггеп*Ма1]рарег); 


СошроВох1С1о5е0р (Гогм1); 


гед->КооЕКеу = НКЕУ СОВВЕМТ Ч95ЕК; 
Тмаче1->И1аЕв = 5$сгееп->И1аев * Тпаде1->Нелане / 
Зсгееп->Незаре; 


Тпадче1->еЁе = (СгопрВох1->М1аЕй — Гладе1->\М1аев) /2; 
ВеааТпЕЁ(); 

} 

ИИ---------н---н----на---------=------------------- 


гед->Егее (); 
Т15Е->Ргее (); 


У01А _ Еаз®са11 ТРГогм] ; : ВИг16еС11ск (ТОБ)]есЕ *5епаег) 
| | 
Сага1па1 Орадаее; 
Апз15Ег1па Т1]ема1]1рарег, ИМа11рарег5%®у1е; 
1Е (ВаЯ91оСгопр1->Т$бетшТпаех == 0) 
ОрЯаее = $РТЕ ОРРАТЕТМТЕТЬЕ; 
е15е Ораафе = ЗРТЕ_ ЗЕМРСНАМСЕ; 
$м16ср (СВ$$у1е->ТфешГТпаех) 
{ 
сазе 0: Т11ема11рарег = '0'!; 
Ма]1]1рарег5®у1е = '2'; 
Ьгеак; 
сазе 1: Т11еЙа1]рарег = '0'; 
Ма11рарег5еу1е = '0'; 
Ьгеак; 
сазе 2: Т11еМа1]рарег = '1!; 
Ма1]рарег5*у1е = '0!; 
БгеаКк; 
} | 
хед->ОрепКеу ("СопЕго1 Рапе1\\БезкКеор", Еа1зе); 
гед->Мг1$еЗег1па ("Т11ема11рарег", Т11еМа1]рарег); 
геч->Мг1$е5®г1па ("Ма1]рарег5®у1е", Ма11рарегб®у1е); 
геч->С1о5еКеу (); 
сузсемРагаме$егзТпЕо (5РТ_ЗЕТРЕЗКИАТТЬРАРЕВ, О0, 
РСрВаг (ОрепР1с6огер1а1031->Е11еМаме.с_з%г()), Орааее); 


У01Аа _ Еаз®са11 ТГогм1 : :СошроВох1С1озе0р (ТОБ)есЕ *5епаег) 
{ 


ОрепР1сбигер1а1031->Е11еМаме = 
.136->56г1па$ [СопроВох1->ТфетТпаех]; 
ТМапте->Сар®1оп = "Файл " + 
ЕхЕегас®Е11еМапе (Ъ1$$6->5%г1па$ [СомроВох1->ТеетТпаех]); 


Тпаче1->Р1сфаге->ГоаЯЕгомЕ1 Те ( 
| 1135Е->5&г1па$ [СопроВох1->Т+ЕешТпаех]); 
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Уу01А __Еаз©са11 ТЕогм1:; :ВСРапе1С11скК (ТОБ)]есе *5епаег) 


{ 
И1пЕхес ("Сопёго1.ехе ЧезК.ср1", 5И_ВЕЗТОВЕ); 


ТРапе]1 = +гае; 
} 
И =================================- 
Уу01А _ Еаз®са11 ТРогм1 : : ММАСТТУАТЕ (ТИМАСЕ1уаке & а) 
{ 
1Е ((а.Асе1уе == МА _АСТТУЕ) && ГРапе1) 
{ 
ВеааТпЕ (); 


ТРапе1 = ЁЕа1зе; 


} 
а.Вези1+=0; 


Уу01А _ Еаз®са11 ТЕГогп1: :ВЕ1паС11сКк (ТОБ)есЕ *5епаег) 
{ 


Ап5156г1па Мапе; 
1Е (ОрепР1сбагеО1а1о91->Ехесаее ()) 


{ 


Маме = ЕхсгассР11еМаме (ОрепР1ссогерта1091- >Е11еМапе); 
ТМапе->Сар®&1оп = "Файл " + Маме; 
11$&->ААА (ОрепР1с6огер1а1о31->Е11]еМапе); 
СопроВох1->Т$еп5$->Ааа (Маме .5ир5ег1па (1, 

зЕг1еп (Маме.с_з6г()) - 4)); 
СопроВох1->Тф$епшТпаех = СопроВох1->Т6етз->Сойпе -— 1; 
СопроВох1С1озе0р (5епаег); 


В классе формы объявлена функция ВеаЯШ{, обеспечивающая чтение 
в приложение текущих настроек, связанных с обоями, и обработчик \МАС- 
ТТУАТЕ сообщения \УМ_АСТТУАТЕ. Необходимость введения этого обработ- 
чика связана со следующим. В приложении предусмотрена кнопка Вызвать, от- 
крывающая окно свойств экрана. В этом окне пользователь может задать ка- 
кие-то настройки обоев. Желательно, чтобы эти настройки отобразились 
в окне приложения. Но задержать выполнение приложения на время работы 
пользователя с окном свойств экрана не получается (см. разд. 1.12). Поэтому 
отлавливается момент активизации приложения — сообщение \М_АСТ1- 
УАТЕ, поступающее в момент, когда окно активизируется после того, как 
пользователь работал с другим окном. И в обработчике этого сообщения чита- 
ются системные настройки хранителя экрана. 

Но потеря фокуса окном приложения может быть связана не только с вы- 
зовом окна свойств экрана. Просто пользователь может на какое-то время пе- 
реключиться на другое приложение. Поэтому в модуле вводится глобальная 
булева переменная ЕРапе]. Она всегда равна #а1$е, за исключением момента 
вызова окна свойств экрана. Так что по значению этой переменной в обработ- 
чике сообщения \УМ_АСТТУАТЕ можно определить, следует ли читать сис- 
темные настройки хранителей экрана. 

Глобальная переменная гей представляет собой объект типа ТВерг1$%ху, ис- 
пользуемый в приложении для работы с реестром. А переменная 1.15% содер- 
жит список имен доступных файлов обоев. 

Обратите внимание на то, что помимо файла гейяту.йрр, необходимого 
для работы с переменной гей, подключается файл Уреб.йрр. Компиляция при- 
ложения пройдет и без этого модуля. Но если вы попробуете выполнить такое 
приложение, то увидите, что загрузка в компонент Ппаге1 файла УРЕС (рас- 
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ширение ./р5) вызовет прерывание, и изображение файла не будет отображать- 
ся. Достаточно подключить к приложению файл урев.йрр, и эта проблема авто- 
матически будет решена. | | 

Перейдем теперь к рассмотрению процедур. Функция ЕогштСгеа{е создает 
в момент создания формы объекты гей и 11$. Эти объекты уничтожаются 
в функции ЕогтОезгоу при завершении выполнения приложения. Кроме 
того, в момент создания формы уточняются размеры и координаты окна 
Гпасе1. Высота этого окна остается той, которая задана во время проектирова- 
ния. А его ширина изменяется так, чтобы соотношение сторон окна примерно 
соответствовало соотношению высоты и ширины экрана компьютера, на кото- 
ром выполняется приложение. Это желательно сделать, так как и иначе изо- 
бражение в окне может исказиться по сравнению с изображением на Рабочем 
столе. При расчете ширины окна используются свойства Эсгееп-> \/ 14 
и Эсгееп->Не! $, содержащие птирину и высоту экрана. После расчета шири- 
ны Ппабе1, это окно может оказаться не в центре панели СгопрВох1. Поэтому 
осуществляется коррекция его левой координаты. 

В завершение функции ЕогтСгеж{е вызывается функция ВКеа 9, кото- 
рая читает системную информацию о текущих настройках обоев и производит 
настройку компонентов приложения. В этой функции в переменную Сиггеп{- 
\УМ’аПрарег читается из реестра имя файла, установленного в данный момент 
в качестве обоев. В переменные ТЙе\УаПрарег и УаПрарег5{Яе читаются од- 
ноименные параметры, определяющие стиль отображения обоев. После окон- 
чания чтения из реестра ключ закрывается методом С1о5еКеу, чтобы не дер- 
жать этот ключ открытым дольше, чем требуется. 

В соответствии с прочитанными значениями параметров устанавливается 
текущий индекс списка СВ е. Прочитанное имя файла хранителя экрана 
заносится в диалог ОрепР1ефиге01а1ю21 как начальное приближение для поис- 
ка других файлов. Из имени файла извлекается функцией Ехгас Е |ПеП!: ка- 
талог файла обоев и заносится в переменную ОУ’ аПрарег. 

Далее начинается поиск графических файлов в каталоге Оаг\УаПрарег. 
Списки 11$ и СошфоВох1 очищаются. Затем функциями Еш@Е!т5%, ЕтЧМехё, 
Е11аС]оз$е ищутся в г У аПрарег любые файлы. Для каждого файла проверя- 
ется, не равно ли его расширение (извлекается функцией Ехёгае ЕЦеЕх) од- 
ному из расширений графических файлов, используемых для обоев. Если най- 
ден графический файл, то его полное имя заносится в список [1$$%, а в СошЪо- 
Вох1 заносится имя, не содержащее пути и расширения. 

После завершения поиска всех файлов индекс списка СошфоВох1 задается со- 
ответствующим текущему файлу обоев. Это осуществляется методом ш4ех0Ё спи- 
ска 14$, определяющим индекс, который имеет в списке файл Сиггеп( А’ аПрарег. 
Затем следует вызов функции СошфоВох1С]озеОр. Это обработчик события 
ОпСозе0Ор списка СотфоВох1. В нем имя выбранного в списке файла заносится 
в диалог ОрепР1ебаге 1101 и в метку Мате, размещенную над этим списком. 
Затем методом Коа4ЕготЕШе изображение из списка загружается в Ппайе]1. 

Мы рассмотрели чтение системной информации в наше приложение. Об- 
ратную задачу записи в систему настроек, сделанных пользователем, решает 
функция В\УгцеСПсЕ — обработчик щелчка на кнопке Установить. В начале 
этой функции состояние группы радиокнопок ВаФоСгоир1 (Использовать) пе- 
реводится в значение переменной Ордафе. Если выбрана кнопка всегда, то этой 
переменной задается значение ЭРТЕ_ ОРРАТЫМТЕП.Е, обеспечивающее 
в дальнейшем занесение информации в реестр. А при выбранной кнопке в дан- 
ном сеансе переменная Ордафе получает значение ЭРТЕ_ ЗЕМОСНАМСЕ. Это 
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приведет к тому, что сохраненные настройки будут действовать только в дан- 
ном сеансе работы пользователя. 

Затем по индексу списка СВЗ{Уе задаются значения переменных ТНе- 
\/аПрарег и \УаПрарег{Яе, которые заносятся в реестр в качестве одноимен- 
ных параметров. Функция ЗузетРагатеегш{о с параметром ЭРТ_ЗЕТ- 
РЕЗК\МАГГРАРЕВ устанавливает файл, имя которого содержится в Ореп- 
Р1ефаге 1а10о51->ЕПеМаше (оно же выбрано в списке СотфоВох1) в качестве 
обоев. Эти обои немедленно появляются на Рабочем столе. 

Функция ВЕШАСИсЕЁЕ является обработчиком щелчка на кнопке Другой. 
Если пользователь выбрал в диалоге новый файл обоев, то информация 06 этом 
файле добавляется в списки 11$ и СошфоВох1. В заключение вызывается уже 
описанная выше функция СошфоВох1С]1о5е р. 

Функция ВСРапе1СЦсК является обработчиком щелчка на кнопке Вызвать. 
В ней вызывается функцией У тЕхес стандартное окно свойств экрана У ш- 
4о\з. После этого переменной Г.Рапе| задается значение фгае. Это, как было 
описано ранее, обеспечит соответствующую реакцию функции У\УМАСТ|- 
УАТЕ — обработчика сообщения \УМ_АСТЕУАТЕ. Если окно активируется 
(поле Асйуе сообщения равно \УА_АСТТУЕ,), и если значение Г.Рапе]| равно 
фгие, то вызывается описанная ранее функция КеаЯШЁ, обеспечивающая чте- 
ние системной информации. Затем значение Г.Рапе]| устанавливается равным 
{а]5е, чтобы в дальнейшем обработчик не производил чтения информации, 
пока пользователь снова.не вызовет окно свойств экрана. 
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Имеется функция де Оез юр\У том, позволяющая получить дескриптор 
окна рабочего стола. Она объявлена в файле Итаоиз.й следующим образом: 


НИМР СесрезКборИ1паом (УОТрО); 


Полученный с помощью этой функции дескриптор можно далее использо- 
вать в любых функциях АРТ У/шадо\мз. Если вы хотите что-то рисовать или пи- 
сать непосредственно на поверхности рабочего стола, то предварительно надо 
получить дескриптор его контекста. Получение дескриптора контекста обеспе- 
чивает функция де \т9Чом)С: 


НОС СееМ1паомрСс (ТМ НИМО В\па); 


А далее для вывода текста вы можете использовать такие функции АР1 
\У!/114о\$, как ОгамТех&, ОгамТех{Ех, Ех Гех Оп Ех Гех{Оиф, ТаЪЪед- 
Тех Оф. Для рисования фигур вы также можете использовать целый ряд 
функций АРТ \У/1ш9до\з (см. разд. 5.5.1). Ниже приведен пример, демонстри- 

рующий вывод текста и изображения на рабочий стол: 
НОС НО = Сее\М1рпаомрСс (бесрезкКеорИ1паом ()); 
Ап$156г1па 5 = "Идет реорганизация базы данных. Будьте осторожны!" ; 
ВЕСТ В = Вес (100,100, 300,200); 
Е111Весь (НО, &В, бес $ оскОр]есе (ИНТТЕ_ВВО$Н)); 
РхамТех® (НО, 5.с_$Ег(), $5.БепаЕП(), &В, 

РТ СЕМТЕВ + РТ ИОВОВВЕАК); 

Е111рзе (НО, 150,200,250, 300) ; 
Ке1еазерСс (Сеерезкеор\М1паом, Но); 


Дескриптор контекста рабочего стола НО получен функцией Сбе\Ут- 
Чо\ОС, в которую в качестве аргумента передан дескриптор окна рабочего сто- 
ла, возвращаемый функцией де ОезКбор\Ут@4о\. Переменная $ содержит вы- 
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водимый текст, а структура В определяет область, в которую этот текст выво- 
дится. Эта область очищается функцией ЕШКесф, в которую в качестве кисти 
передается кисть, возвращаемая функцией Се ЗюсКОБес с аргументом 
У\НТТЕ_ВКОЗН. Функция Се ЗфюоскОЦес{ возвращает дескриптор одного из 
предопределенных в \!/1140о\з$ инструментов, используемых для изображений: 
пера, кисти, шрифта. В данном случае для заполнения области требуется 
кисть. Константа \УНТЕ_ВКОЗН определяет кисть белого цвета. Подробнее о 
функции Се фосКОЦес+ см. в разд. 5.5.1. 

Текст в данном примере выводится функцией ОгамТехф. В числе ее флагов 
заданы ОТ СЕМТЕВ — выравнивание по центру области, и ОТ У\УОВО- 
ВВЕАК — перенос длинных текстов на несколько строк. Следующий оператор 
вызывает функцию ЕШрзе, рисующую круг. Это сделано просто для демонст- 
рации возможностей рисования. Последний оператор приведенного кода осво- 
бождает дескриптор контекста окна рабочего стола. 

Если вы реализуете подобный пример, то увидите, что текст и круг будут 
нарисованы на поверхности стола. Впрочем, рисование произойдет именно на 
поверхности стола, если указанная в коде область не закрыта какими-то окна- 
ми. А если она закрыта, то текст и фигура будут выведены прямо поверх окна 
верхнего уровня. 

В данном случае для рисования использовались перо, кисть и шрифт, ус- 
тановленные в \!114о\з$. Вы можете изменять эти установки. Например, если 
в приведенном выше коде вы вставите объявление еще двух переменных: 


НРЕМ Реп, РепРгех; 


а перед рисованием круга выполните операторы 


Реп = СгеафкеРеп (Р5_ЗОЪТО,4,с1КВеа); 
РепРгеу = 5е1ес®ОБл]ес® (НрО,Реп); 


то граница круга будет нарисована красной толстой линией. Первый из приве- 
денный операторов создает функцией СгежеРеп новое перо и задает его харак- 
теристики: сплошная линия красного цвета с толщиной 4. Второй оператор 
активизирует функцией Зее ОБес+{ это перо и заносит в переменную Реп- 
Ргеу ранее использовавшееся перо. Если вы затем захотите восстановить 
прежнее перо, то сможете сделать это оператором 


Зе1есеОБ]ес+ (НО, РепРгеу) ; 


При рисовании и выводе текста рассмотренными способами надо иметь 
в виду, что ваше изображение исчезнет при любой перерисовке окна. 


1.7 Кнопка и меню «Пуск» 


Для того чтобы программно щелкнуть на стандартной кнопке УИ ш@4о\мз 
Пуск, достаточно выполнить команду (см. пример РМоше в каталоге Моие 
на приложенном к книге диске): 


бепаМеззаде (Напа1е, ИМ 5У5СОММАМРО, $5С_ТАЗКГТЗТ, О); 


Видимостью и доступностью кнопки «Пуск» можно управлять. Эта кнопка 
является дочерним окном полосы задач, подробнее рассмотренной в разд. 1.8. 
Получить дескриптор дочернего окна какого-либо приложения можно функци- 
ей Еша\/т4омЕх, объявленной в файле ИУ’тизег.й следующим образом: 
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НИМ Е1п9\М1паомЕх ( ТМ НИУМО Рагеп®, ТМ НИМО СБ11а, 
ТМ ГРСЗТВ 1р$2С1азз, ТМ ГРСЗТВ ИМ1паомМаше); 


Параметр Рагепё является дескриптором того родительского окна, дочер- 
нее окно которого надо найти. Если этот параметр равен 0, то подразумевается 
дескриптор Рабочего Стола (см. разд. 1.6). Параметр СВП@ является дескрип- 
тором того дочернего окна, после которого начинается поиск. Иначе говоря, 
поиск начинается со следующего окна в Й-последовательности. Если СЬП@ = 0 
то поиск идет, начиная с первого дочернего окна. Таким образом, если 
и Рагепф, и СЬП@ равны 0, то поиск идет среди всех окон верхнего уровня. 

Параметр 1р$7Саз$ является указателем на строку, содержащую имя 
класса искомого окна, или является атомом (см. разд. 1.16), содержащим имя 
класса и установленным ранее функцией Софа! АЗаА ют. Параметр 
\тдом Мате является указателем на строку, содержащую заголовок окна. 
Если этот параметр равен МОТГ, ищется окно с любым заголовком. 

Таким образом, получить дескриптор окна кнопки «Пуск» (его класс Виё- 
фоп), являющегося дочерним окном полосы задач (ее класс ЭВе|!_Тгау\па — 
см. разд. 1.8) можно с помощью операторов: 


НИМО Н; 
Н = Е1пАМ1 паомЕх (Е1па\1п4ом ("5Ве11 Тгауйпа", м9ьь), 0, "Вае®воп", МОЬЬ); 


В этом операторе функция Ета \Ут4о\ возвращает дескриптор полосы задач, 
_ он передается в качестве первого параметра в функцию ЕшАа\т9домЕх, кото- 
рая возвращает дескриптор дочернего окна класса ВиЦЙоп. 

После получения дескриптора кнопки «Пуск» сделать ее невидимой, можно, 
например, воспользовавшись функцией Зе \УтдомВоп, подробно описанной 
в разд. 5.2.2.1. В этом случае скрытие кнопки «Пуск» осуществляется кодом: 


НЕСМ Вап; 
Вап = СгеабеВес&Вап (0, 0, 0, 0); 
зеЕМ1паомВап (Н, Кап, Егае); 


Восстановление видимости кнопки можно осуществить оператором: 


ЗесИ1паомВап (Н, 0, +гце); 


Впрочем, еще проще управлять видимостью кнопки «Пуск» можно с по- 
мощью функции ЭВом У тдо\, описанной подробнее в разд. 1.8. Оператор 


ЗНомИ1паом (Н, $ НТОЕ); 
сделает ее невидимой, а оператор 


5ВомИ1паом (Н, $5М ЗНОММОВМАЦ); 


восстановит ее видимость. 
Управлять доступностью кнопки можно с помощью функции ЕпаЫе- 
УМтдо\м: 


ВООЪ Епаб1еМ1паом (ТМ НИМР ВБИпа,тТмМ ВОО БЕпаЮ1е); 


Первым параметром в нее передается дескриптор окна, а вторым — устанавли- 
ваемое состояние: фгие — доступное, #а]5е — недоступное. Так что оператор 


Епар1ей1паом (Н, Еа15$е); 


сделает кнопку недоступной, а оператор 


Епаь1е\1паом (Н, Егоае); 


вернет ей доступность. 
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Можно также управлять составом меню, открываемого кнопкой Пуск. За- 
нести какой-то документ в раздел Недавние документы можно операторами вида 


//#1пс1цае <ус1т.Ь> 
#1пс1оаае "501067 .6" 


ЗНАЯЯТоКесеп® Росз$ (5НАВО РАТН, Е9161->Техе.с_56г()); 


Последний оператор занесет функцией ЭНАЧаТоВесепОос$, объявленной 
в файле 5ОВУ.Й, в раздел Недавние документы файл, имя и путь которого со- 
держатся в окне ЕЧИ1. Если в качестве второго аргумента функции $НАааТо- 
ВБесеп Дос$ задать МОГ: 


СНАЧАТоВесепеРосз (5НАВР_РАТН, №011.) ; 


то раздел Недавние документы будет очищен. 


1.8 Управление полосой задач 


Класс окна полосы задач — ЭВе|_Тгау\п4. Это можно использовать для 
управления полосой задач. Например, оператор 


ЗПомИ1паом (Е1пЧЙ1паом ("5ре]11 Тгауйпа", МОТ), 5И_НТОЕ); 


делает полосу задач невидимой. Этот оператор использует функцию Ета\/т- 
о\’, возвращающую дескриптор окна, класс которого задан ее первым пара- 
метром. Этот дескриптор передается в качестве первого аргумента в функцию 
эпом М том, управляющую видимостью окна. Ее второй аргумент указыва- 
ет, как именно должно отображаться окно. Среди множества возможных зна- 
чений этого аргумента (см. поробнее в разд. 5.1.1 в описании структуры 
\УТМРОМРГАСЕМЕМТ) укажем 5\_НТШОЕ — делает окно невидимым, 
3 \’ЭНОМ/МА — восстанавливает нормальное состояние окна, не активизи- 
руя его, 5\_5НОММОВМАЕ — восстанавливает нормальное состояние окна 
и активизирует его. 
Исходя из сказаного, оператор 


5ВомИ1паом (Е1п9И1паом ("5$ре11 Тгаумпа", мот), $М_ЗНОММОВМАТ); 


ИЛИ 


5поми1паом (Е1п9\1паом ("5пе11 Тгау\Мпа", Мот1,), $5М $НОММА); 


восстанавливают ранее невидимую полосу задач. 

Свернуть окно, отобразив его в полосе задач, можно с помощью сообщения 
\М_5У5ЗСОММАМО с параметром 8С_МИММТЕАЕ (см. подробнее в разд. 
5.1.3). Например, оператор 


РегЕогм (ИМ 5УЗСОММАМО, 5С_МТМТМТАЕ, 0); 


свернет окно, в котором он расположен, переместит информацию о нем в поло- 
су задач и сделает окно неактивным. В этом отличие данного оператора от за- 
дания свойству Уш@ом5 {же формы значения \5Миишите или от использо- 
вания функции ЭЗвВом УМ тдом с параметром 5\М_МИМИМТЕЕ. И то, и другое 
минимизирует окно, располагая его в нижней части экрана, а не переносит ин- 
формацию о нем в полосу задач. 

См. также разд. 1.9, в котором решается противоположная задача — обес- 
печить, чтобы свернутое окно не отображалось в полосе задач. 
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1.9 Приложения — невидимки 


Иногда желательно, чтобы приложение, которое постоянно выполняется 
на фоне выполнения других приложений, не отображалось в полосе задач (см. 
разд. 1.8) и не занимало там лишнего места. Один из путей создания подобного 
приложения — это задание перед созданием главной формы соответствующего 
стиля ее окна. 

Стиль окна можно задать функцией Зе \УУтдомТ.опя, объявленной в фай- 
ле ИтОзег.й следующим образом: 


ОМС 5ееИ1паомТопа (ТМ НИМО ПИ\па, ТМ 1пЕ пТпаех, 1М ТОМб амМеиропа); 


Параметр В \/па является дескриптором окна. Если функция должна при- 
меняться к еще не созданному окну, в качестве параметра В\У’п4 можно ис- 
пользовать дескриптор приложения АррПсайоп->НапШе. Параметр пГа4ех 
задает относительное смещение в переменной, определяющей стиль. В нашем 
случае для доступа к расширенному стилю надо задать значение пех рав- 
ным @\Г ЕХЬТУГЕ. Параметр 4мМемТ.опя определяет заменяемые состав- 
ляющие стиля. Для наших целей надо задать значение дмМемТ.опй равным 
\5_ЕХ_ ТООГМТМООУ.. Это обеспечит отсутствие в полосе задач отображе- 
ния данного окна и недостижимость приложения при нажатии пользователем 
клавиш А!-ТаБ. 

Все это может быть оформлено, включением в обработчик события формы 
ОпСгез{е следующего оператора: 


зееИ1паомЪопа (Арр11са*1оп->Напа1е, СМЬ ЕХЗТУГЕ, М5_ЕХ ТООБМТМРОЙ); 


Имейте в виду, что если пользователь свернет окно вашего приложения, то 
приложение станет ему недоступным. Точнее, он сможет получить к нему дос- 
туп только через диспетчер задач У/ш@о\з, вызываемый клавишами 
СН-АН-Беее. Из окна диспетчера он сможет переключиться в данное приложе- 
ние или закрыть его. Если же вы хотите, чтобы приложение сразу не было вид- 
но пользователю и работало «за кадром», то не забудьте в свойстве формы 
УМУ/тдаом Зе задать значение мзМиишитед. | 

Возможен и иной вариант создания приложения-невидимки: вместо при- 
введенного выше оператора записать: 


Арр11са®1оп->5РомМа1пЕГогм = Еа15е; 


Тем самым вы делаете главную форму приложения невидимой. Только 
надо проверить, установлено ли в ней свойство \1$1Ше в #Ёа!е. Будьте осторож- 
ны! Если приложение работает под управлением У/1шЧо\мз 2000\ХР, то прило- 
жение будет невидимым не только в полосе задач и по клавише табуляции. Его 
не будет видно и в диспетчере задач \У/114о\з. Запуская приложение в режиме 
отладки из среды С++Во!|аег, его все-таки можно будет закрыть клавишами 
Сн|-Е2. Но при запуске просто из \У/ш9о\мз закрыть это приложение будет не- 
возможно (точнее, можно закрыть, только закрыв соответствующий процесс)! 
Так что при экспериментах примите меры против этого. Простейший вариант: 
поставьте в приложение Типег, и через заданный в нем интервал времени за- 
крывайте приложение методом С]озе, или хотя бы делайте его видимым мето- 
дом ЭВом. 

Вообще, чтобы в некоторый момент, например, при щелчке на какой-то 
кнопке превратить ваше приложение в невидимку, достаточно выполнить опе-, 
раторы | 


64 Глава 1. Взаимодействие приложений С++ВийЙаег с операционной системой 


\1$161е = Еа15е; 
Арр11сае1оп->5ПомМа1пГогм = Еа15е; 


Пример применения рассмотренной методики вы найдете в разд. 1.10. 


1.10 Пиктограммы в области Зу${ет Тгау 


Область эузвет Тгау представляет собой часть полосы задач, размещается 
в правом нижнем углу экрана и содержит такие значки, как часы и ряд дру- 
гих. Она отличается от полосы задач тем, что в ней расположены не свернутые 
окна приложений, а только пиктограммы. В области Буз4ет Тгау целесообраз- 
но размещать пиктограммы, связанные с приложениями, которые постоянно 
должны выполняться в фоновом режиме. Размещение свернутых окон таких 
приложений в полосе задач нецелесообразно, так как в этом случае они будут 
занимать лишнее место. Компактнее разместить их значки в области вузет 
Тгау, сделать окна невидимыми и открывать их только при щелчке пользова- 
теля на пиктограмме. 

Связь приложения с пиктограммой, размещенной в Буз4ет Тгау, осущест- 
вляется функцией ЗВе!_Мой{Уесоп, объявленной в файле 5йеПАРГ.А следую- 
щим образом: 


5НУТОАРТ_(ВООТ) $6е11 МоЕ1ЕутТсоп (РИОВР амМеззасде, 
РМОТТЕУТСОМРАТАА 1рПрафа); 


Параметр 4мМез5ахе указывает выполняемую операцию и может прини- 
мать значения: 


ыы 
№ММ_АБР _ добавить пиктограмму в область Зузфет Тгау. —__ | 
МТМ _РЕГЕТЕ удалить пиктограмму из области Буз4ет Тгау 

РА ВЕТ рам мм 

ММ_МОРОТЕУ |изменить изображение пиктограммы, текст ее ярлычка или 

Г —__ ‘идентификатор ее сообщения __ 


Параметр 1р)аёа является указателем на структуру типа ТМ№ойЁУГеопОацва, 
содержащую всю информацию о выполняемых операциях. Функция возвраща- 
ет ненулевое значение при успешном выполнении и 0 в случае ошибки. 

Тип ТМ№ойРУТсопОайва (см. ее объявление в описании функции ЭВе|_МоН- 
ГуТсоп в гл. 8) содержит ряд полей, основные из которых следующие. 

Поле се $12е указывает размер структуры. Поле \п4 определяет дескрип- 
тор окна, которое связано с пиктограммой и получает сообщения о перемеще- 
ниях над ней мыши. Поле и содержит номер размещаемой пиктограммы. 
Одно приложение может разместить в Зузбет Тгау несколько пиктограмм 
и ссылаться на них по этому номеру. Поле аСаПБасКМеззайе задает идентифи- 
катор сообщения, которое будет посылаться при попадании курсора мыши 
в область пиктограммы. Поле Шеоп задает дескриптор пиктограммы. Поле 
57Г1р содержит текст всплывающего ярлычка. Как видно из вышеописанной 
структуры, это поле в зависимости от версии У114омз$ может иметь разную 
длину. | 

Поле иЕ]1ая$ включает флаги, указывающие, какие поля структуры при- 
нимаются во внимание: 
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ЧЕ _1СОм | учитывается поле БГсоп_ 


а - == д - --- . ОНИ и к. ИНН и 


МТЕ МЕ$ЗАСЕ учитывается поле иСаЙЪаскМеззаве — 


1 
ПО О ОИ РО ОВО, ООО 


Если вы разместили пиктограмму в области Бузет Тгау, надо обеспечить 
в приложении обработку сообщений о манипуляциях мышью в области этой 
пиктограммы. Идентификатор этого сообщения вы задаете в поле аСаПасК- 
Меззазе структуры типа ТМо{УГсопрайа. В поле мРагат пришедшего сообще- 
ния вы можете прочитать номер пиктограммы, который ранее задавали в поле 
и структуры типа ТМо{Усопрайа. А в поле 1Рагат пришедшего сообщения 
вы можете прочитать идентификатор сообщения, полученного от мыши, напри- 
мер, \М_ГВОТТОМОВЕСГЕК — двойной щелчок левой кнопкой. 

Функция ЭВе|_Мой{ЁУГсоп позволяет управлять значком в области вуз4ет 
Тгау. Но надо еще принять меры к тому, чтобы приложение не отображалось 
в полосе задач. Иначе значок в области Зуз4ет Тгау теряет смысл. Как можно 
предотвратить появление изображения свернутого окна приложения в полосе 
задач рассказано в разд. 1.9. | 

Рассмотрим чисто тестовый пример (проект Р5узТгау в каталоге И’1т4оишз 
на приложенном к книге диске). При его выполнении в области Зузбет Тгау 
размещается его пиктограмма, а окно приложения (рис. 1.4 а) пользователю 
не видно и доступно только из всплывающего меню пиктограммы или после 
двойного щелчка на значке. Форма этого приложения показана на рис. 1.4 6. 
Она содержит компонент всплывающего меню РорирМепи1 с тремя раздела- 
ми: Развернуть приложение (имя раздела в программе — МВезфоге) — делает ви- 
димой главную форму, Закрыть приложение (имя МСТозе) — завершает выполне- 
ние приложения, и Удалить значок (имя МРеее) — удаляет значок из Зуз$ет 
Тгау и одновременно делает видимой главную форму, так как иначе приложе-. 
ние после’ этого было бы невозможно закрыть. 
| Задана пиктограмма приложения. Для этого выполнена команда Ргоес! | 
ОрНопз$ и на странице АррйсаНоп кнопкой [оа4 |соп проведена загрузка пикто- 
граммы. Это та пиктограмма, которая появится в области Буз4ет Тгау. 


Удалить значок 


‘Свернуть . 


Рис. 1.4. Окно (а) и форма (6) приложения Рбу5Тгау 


На форме размещены три кнопки. Кнопка Создать значок (имя ВСгеаёе) 
доступна только в случае, если пиктограмма удалена из области Буз4ет Тгау. 
Щелчок на этой кнопке размещает пиктограмму в Буз4ет Тгау. Кнопка Уда- 
лить значок (ВОшефе) удаляет значок из области эузфет Тгау. Кнопка Свернуть 
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(ВН14е) делает форму невидимой. Кнопка доступна, только если в области 
эзузбет Тгау размещена пиктограмма. 
Ниже приведен текст этого приложения с некоторыми сокращениями. 


Описание класса формы в заголовочном файле бузТгау.й: 


сопз$Е МуТгауТсоп = ИМ О5ЕБВ + 1;. 
с]1аз5 ТЕРогпи1 : руаЬ]11с ТЕогм 


{ 


рг1уафе: // Изег аес1ага 1опз$ 
Уу01А _ Еаз®са11 МТТсоп (ТМеззаде5); 
рчЬ11с: // Озег аес]1ага®1оп$ 


_ Еаз®са11 ТЕогш1 (ТСошропепЕ* Омпег); 
ВЕСТМ_ МЕЗЗАСЕ МАР 
МЕЗЗАСЕ НАМРЬЕК (МуТгауТсоп, ТМеззаде, МТТсоп) ; 
ЕМР МЕЗЗАСЕ МАР (ТСопропепе); 
}; 


Файл реализации: 


Т№о1ЕуТсопрака МТО; 
у01А _ ГЕаз®са11 ТЕогм1:; :МТТсоп (ТМеззадева) 


{ 


РОТМТ В; 
$и1ЕСВ( а.ГРагап) 
{ 
сазе ММ ТВОТТОМОВТСЬК: // двойной щелчок левой кнопки мыши 
5Вом (); 
зееГогедагоцпаЙ1паом (Напа1е); 
Ьгеак; 


сазе ММ ВКВОТТОМРОММ: // однократный щелчок правой кнопки мыши 


СсееСагзогРо$ (&Р); 
РорярМепи1->Рорир(Р.х,Р.у); 


Арр11са*1оп->5РомМа1пРогм = Еа15$е; 

МТО. с6512е = $12еоЕ (ТМо&1ЕуТсопрака); 

мТр.БИпа = Напа1е; 

МТО. отр = 1; 

МТР.иЕ1ааз = МТЕ ТСОМ | МТЕ МЕЗЗАСЕ | МТЕ ТТВ; 
МТР.иСа]1]1БасКМеззаде = МуТгауТсоп; 

МТО.ПТсоп = Арр]11са®1оп->Тсоп->Напа1е; 

$Егсру (МТР.52Т1р, "Мое приложение"); 

$Ве11 МоЕ1ЕуТсоп (МТМ АБО, &МТр); 


5Ве11 Мо&1ЕуТсоп (МТМ РЕЪЕТЕ, &МТО); 


\01А __Еаз®са11 ТГогм1: :МС1озеС11ск (ТОБ)]ес® *5епаег) 
{ 
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у01А _ Еаз®са11 ТКогт1: :Мре1ефеСс11ск (ТОБЗесе *бепаег) 


{ 
5ре11 МоЕ1ЕуТсоп (МТМ РЕБЕТЕ, &№ТРЬ); 


ВСгеафе->Епаб1еа = Егае; 
Вре1еке->Епаб1еа = Еа15е; 
ВН1Аае->Епаб1еа = Еа15е; 
бВом (); 


\01А _ Еазбса11 ТКогм1::ВСгеа®еС11сКк (ТОБ]есе *5епаег) 


5ре11 Мое1ЕуТсоп (МТМ АБР, &МТР); 
ВСгеафе->Епар1е = Еа15е; 
Вре1ефе->Епаб1еа = +гие; 
ВН1ае->Епарю1е = Егае; 


\01А __Еазса11 ТЕоги1: : ВРе1еееСсС11ск (ТОр]есЕ *5епаег) 


{ 
5ре11 Мо&1ЕуТсоп (МТМ ГЕЪЕТЕ, &МТО); 
ВСгеа*е->ЕпаЪ1еЯ = Ехие; 
Вре]1ете->Епаб1е = Еа15е; 
ВН1зае->Епаб1еа = ЕГа1зе; 


\1$1Ю1е = Еа1$е; 

} 

Прокомментируем приведенный код. В заголовочном файле объявлена кон- 
станта МуТгауУсоп — идентификатор вводимого в приложении сообщения 
Уп дом. В этом же файле введено объявление обработчика этого сообщения — 
функция МТсоп. Введена также глобальная переменная МТО типа ТМ№Моййу- 
ТсопОзфа, которая содержит информацию, необходимую для этой функции. 

Функция ЕогтСгеа{фе — обработчик события формы ОпСгезже. Первый 
оператор этой функции делает форму невидимой (см. разд. 1.9). Затем запол- 
няется структура МО. Размещаемой пиктограмме дается номер 1. Указывает- 
ся идентификатор сообщения, связанного с пиктограммой — МуТгауГсов. 
В качестве пиктограммы задается пиктограмма приложения — АррИсай- 
оп->[соп->НапШе. Задается также текст ярлычка: "Мое приложение" (функ- 
цией добавления в МПШ.57Т1р строки "Мое приложение”). После заполнения 
структуры вызывается функция ве! _МоНРуТсоп, размещающая пиктограм- 
му в области эузфет Тгау. | 

При завершении приложения в функции ЕогтОе$ёгоу пиктограмма уда- 
ляется из области зуз4ет Тгау. Если этого не сделать, то она там так и останет- 
ся до перезагрузки \У/19о\з или до реорганизации Зуз4ет Тгау. Причем пик- 
тограмма уже не будет связана с приложением и, значит, будет только вводить 
в заблуждение пользователя. 

Функция МТГоп является обработчиком сообщения МуТгаУ[Гсоп, посту- 
пающего в приложение при любых манипуляциях с мышью в области пикто- 
граммы. Параметр ГРагат этого сообщения указывает на соответствующее со- 
общение мыши. В данном случае при двойном щелчке левой кнопкой (код со- 
общения \УМ_ТГВОТТОМОВЕСТЕК) выполняется метод ЭВо\м, относящийся 
к данной форме, так что форма становится видимой. Но этого мало, так как 
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если перед этим активным было какое-то другое окно, оно может перекрыть 
открывшееся окно формы и пользователь его не увидит. Поэтому к окну фор- 
мы применяется функция Зе Рогесгоип 9 \/1140о%, активизирующая его и пе- 
ремещающая на верх -последовательности, так что оно становится безуслов- 
но видимым. При нажатии правой клавиши мыши (код сообщения 
\М_ВВОТТОМООММ) пользователю показывается контекстное меню. Пози- 
ция меню привязывается к координатам курсора, полученным функцией 
Се СигзогРоз$ (см. разд. 2.4.2). 

Остальные функции приложения вряд ли требуют пояснений. Выполняе- 
мые в них действия достаточно очевидны. Может быть, стоит только сказать 
пару слов о функции ВН1аАеСПИсК, являющейся обработчиком щелчка на кноп- 
ке Свернуть. Эта функция делает форму невидимой. Поскольку в момент щелч- 
ка форма видима, а свойству АррПсаЙоп->ЗВомМашЕогш еще в момент соз- 
дания формы задано значение #а]$е, то в данной функции достаточно задать 
значение свойства \У1$1Ше, равное #а15е. Форма исчезнет с экрана, не будет 
видна в полосе задач, а если работа идет в У тдо\мз 2000\ХР, то она не будет 
видна и в диспетчере задач У/1т4о\м. 

Рассмотренное приложение — чисто демонстрационное. Более реальный 
пример связан с регистрацией комбинаций горячих клавиш для различных 
файлов и программ. Общий вид этого приложения показан на рис. 2.6 в гл. 2 
в разд. 2.3.5. Вы найдете этот пример в проекте Но{Кеу! в каталоге Кеубоата 
на приложенном к книге диске. Приложение позволяет пользователю регист- 
рировать сочетания горячих клавиш, связанные с различными файлами доку- 
ментов и программ. Пока приложение выполняется, пользователь может ис- 
пользовать эти горячие клавиши в процессе работы с любой программой 
У/114о\з, и таким образом получает быстрый доступ к документам и програм- 
мам, которые ему часто нужны. 

Все связанное с регистрацией и использованием горячих клавиш, подроб- 
но рассмотрено в разд. 2.3.5. А здесь рассмотрим вопросы, связанные с отобра- 
жением пиктограммы этого приложения в области Зуз4ет Тгау. 

В начале выполнения приложения пиктограмма заносится в Зуз4ет Тгау, 
а форма приложения делается невидимой так же, как рассматривалось выше. 
В текст ярлычка, всплывающего при перемещении курсора над пиктограммой, 
заносятся несколько первых строк с условными названиями файлов, содержа- 
щимися в списке 11$ Вох3, и соответствующими комбинациями горячих кла- 
виш, записанными в списке 1:1$&Вох2 (см. описание примера в разд. 2.3.5). При 
изменении пользователем списка горячих клавиш эти изменения передаются 
в текст ярлычка. Рассмотрим некоторые из фрагментов данного приложения, 
связанных с пиктограммой в Буз4ет Тгау (остальное см. в разд. 2.3.5): 

Описание класса формы в заголовочном файле: 


соп5Е МуТгауТсоп = ММ Ч5ЕВ + 1; 


с1аз$ ТЕогш1 : рию11с ТЕогм 
{ | 
рг1уафе: // 0О5ег аес1агаЕ1оп5$ 
У01А _ Еазеса11 МТТсоп (ТМеззаде»); 
Ап$156г1па ТлрЕГогм() ; 
`’рир11с: // Пзегк Аес]1]агаЕтоп$ 


__ Еаз®са11 ТЕГогшм1 (ТСошропеп®* Омпег); 
ВЕСТМ_МЕЗЗАСЕ МАР 

МЕЗЗАСЕ НАМРЬЕК (МуТгауТсоп, ТМеззаде, МТТсоп) ; 
ЕМР МЕЗЗАСЕ МАР (ТСопропепЕ); 
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Файл реализации: 
Т№о61ЕуТсопрафа МТО; 


014 _ Еаз®са11 ТРГогм1:; :КогмСгеафе (ТОр]ес®е *5епаехг) 
{ 
Арр11са®*1оп->5ромМа1пГогм = Еа15$е; 

МТР.сЬ512е = $512е90Е (ТМ№о$1ЕуТсопрафа); 

МТр.ВИпА = Напа1е; 

МТР.отТр = 1; 

МТР.иЕ1ааз = МТЕ ТСОМ | МТЕ МЕЗЗАСЕ | МТЕ ТТР; 
МТР.иСа11БаскКМеззаде = МуТгауТсоп; 

МТр.ВТсоп = Арр11са®1оп->Тсоп->Напа1е; 

зЕксру (М1Р.52Т1р, Еоги1->Т1рЕогм () .с_$%г()); 
5ре11 М№*1ЕуТсоп (МТМ АБР, &МТО); 


Апз156г1па ТЕогш1: : ТфрРогм () 


{ 
Ап515©г1па 5, 51; 


10 1; 

с — " "; 

1Е (ТЪ15ЕВох3->Сойп® == 0) 

5 = "Горячие клавиши"; 
е1зе Рог (1=0;1<115ЕВсх3->СочпЕ — 1;1++) 

{ 

$1 = (11$ЕВох3->ТЕемз->56г1па$ [1] +" "+ 

| т1$ЕВох2->Т%епз->56г1па$[1]); 
1Е ((56г1еп($.с_ 56: ()) + зег1еп ($1.с 56: ()) > 64) || 
( (56 х1еп (5$.с_56к()) + зЕк1еп ($1.с _$56:()) > 57) && 


(1 < Газ Вох3->СойрЕ - 1))) 


< — с + "и др."; 
ЬгеаКк; 


} 
е1зе $ = $ + $1 + "\пи; 


} 


гегагп 5; 


Уу01А __ЕазЕса11 ТЕГогм1: :ВЕгазеС11сКк (ТОБ]есЕ *5епаег)о 
{ 


$Егсру (МТО.52Ттр, Когм1->Т1рЕогкм () .с_$з%г()); 
5ре11 МоЕ1ЕуТсоп (МТМ АБО, &М№МТр); | 
} 


В основных чертах этот код совпадает с рассмотренным в предыдущем 
примере. Так же объявляется идентификатор сообщения и обработчик этого 
сообщения, реализация которого не приведена, так как она не отличается от 
рассмотренной ранее. В обработчике ЕогтСгеа{е события формы ОпСгеае за- 
полняется структура МТ типа Т№ойУГсопоава. Только для формирования 
текста всплывающего ярлычка вызывается вспомогательная функция Т1?- 
ГЕогт. Алгоритм этой функции сводится к следующему. Хотелось бы отобра- 
зить в тексте ярлычка строки с названиями разделов и соответствующими им 
горячими клавишами. Названия разделов хранятся в списке 11$&Вох3, а соот- 
ветствующие им комбинации горячих клавиш записаны в списке 115$%Вох2. 
Но, к сожалению, длина текста ярлычка — поле $7Гр структуры типа 
ТМ№оиЁУ/ТГсоправа, ограничена 64-мя символами. Поэтому в функции ТрЕогт 
в текст заносится столько строк, сколько можно, а если есть еще не занесен- 
ные строки, то в конец текст заносится "и др.”. Функция начинается с провер- 


70 Глава 1. Взаимодействие приложений С++ВиНаег с операционной системой 


ки числа разделов в списках (числа строк в списке 11$ Вох3). Если разделов 
вообще нет, то в переменную 5%, из которой в дальнейшем формируется текст 
ярлычка, заносится "Горячие клавиши", и все на этом заканчивается. Если же 
разделы есть, то организуется цикл по ним и в $ заносится текст из списка 
1Г15$&Вох3, текст из списка 11$&Вох2 и символ перехода на новую строку. Но 
сначала проверяется, не превысит ли в результате текст допустимую длину. 
А если раздел в списках не последний, то проверяется, останется ли еще место 
для текста “и др.”. В результате формируется строка $ допустимой длины, 
и функция возвращает эту строку. 

Еще одно отличие данного примера от рассмотренного ранее заключается 
в том, что пользователь может изменять список разделов: добавлять новые 
разделы, удалять прежние, изменять тексты. Одновременно надо изменять 
и текст ярлычка. В качестве примера выше приведен фрагмент функции 
ВЕгазеСПсК, удаляющей раздел из списка. В конце этой функции вызывается 
описанная выше функция Т1рЕогтш, формирующая новый текст. А затем 
функция Эве!_МоНЁУ[Шсоп вызывается со значением первого параметра, рав- 
ным ММ_МОРОТЕУ — изменение информации. 

Все остальное интереса не представляет. Вы можете посмотреть более под- 
робные пояснения в разд. 2.3.5, или посмотреть на диске полный текст проекта. 
А в целом, благодаря применению пиктограммы в Бузет Тгау, приложение 
очень неплохое и может быть подспорьем в работе над какими-то документами. 


1.11 Регистрация собственного расширения файлов 


В ряде случаев вам надо зарегистрировать в У\У/Лто\з особое расширение 
ваших файлов и приложение, обрабатывающее эти файлы. Эту задачу можно 
решить несколькими способами. Во-первых, это можно сделать средствами 
\УМ114о\з в окне «Свойства папки» на странице Гипы файлов. Во-вторых, это 
можно сделать, введя описанные далее ключи и параметры в реестр. Но оба 
эти способа требуют от пользователя неких усилий, а второй к тому же чреват 
неприятностями, если с реестром будет работать неквалифицированный поль- 
зователь. Так что наилучший вариант — провести автоматическую регистра- 
цию расширений в программе установки вашего приложения. 

Автоматическая регистрация сводится к созданию в реестре необходимых 
ключей и параметров. Поэтому сначала коротко рассмотрим, как хранится 
в реестре информация о зарегистрированных расширениях и программах об- 
работки файлов с этими расширениями. 

Зарегистрированные расширения хранятся в реестре как ключи корневого 
ключа НКЕ! С1АЗ$Е$_КООТ. Например, если вы хотите зарегистрировать рас- 
ширение .ту, то должны создать в ключе НКЕУ_ СТАЗЗЕ$ КООТ ключ с именем 
".шу”. Единственным параметром этого ключа должно быть имя ключа, содер- 
жащего развернутую информацию. Например, “ту Ше“. Указанный ключ так- 
же хранится в разделе корневого ключа НКЕ!_СТАЗЕ$ КООТ. В этом ключе 
создается цепочка ключей °Пе!\ореп\соттапа. В последнем ключе соттапа за- 
дается параметр, значение которого — полное имя файл приложения, обраба- 
тывающего файлы с вашим расширением. Если при запуске этого приложения 
в него надо через командную строку передать имя файла, то после имени при- 
ложения указываются символы "% 1". Так что если, например, вы хотите об- 
рабатывать файлы приложением МуРгойгат, расположенным в каталоге 
СЛМуРто]тсЁ$, то в реестре соответствующий параметр должен иметь вид 
"С:\МуРго]гс{\ МуРговгат.ехе % 1". 
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При регистрации расширения можно одновременно зарегистрировать и пик- 
тограмму, которая будет отображаться в папках около файлов с этим расширени- 
ем. Для этого в ключе, содержащем информацию о приложении (в рассматривае- 
мом примере — в ключе туйНе), надо создать подключ ОеюуНсоп и в нем задать па- 
раметр со значением, указывающим пиктограмму: имя файла и, после запя- 
той, — индекс пиктограммы. Например, если вы хотите указать главную пикто- 
грамму вашего приложения, обрабатывающего файлы, то значение этого пара- 
метра может быть следующим: "С:\МуРго]ес{з\ МуРгозтат.ехе, 0". 

В результате регистрации автоматически создастся также параметр с име- 
нем вашего приложения в ключе НКЕУ СУКВЕМТ ОЗЕК\5оЯ\уиагеМ!сгозой\ 
\ММпаоми\ЗНе!МоКоат\МИСасйпе. Это обеспечит в дальнейшем пользователю 
возможность назначать средствами У/!ш4о\з ваше приложение для обработки 
файлов с иным расширением. 

Пример приложения, регистрирующего расширение файлов .ту и обрабаты- 
вающего эти файлы, содержится на диске, приложенном к книге, в проекте 
ВейЕх+ в каталоге Ипаоиз. Приложение (см. рис. 1.5) имеет кнопку Регистра- 
ция расширения ‚ту (ее имя ВВе?) и кнопку Отмена регистрации расширения (имя 
ВОпвВе?5). В качестве обрабатывающего приложения регистрируется это же при- 
ложение, загружающее открываемый файл в окно Мето1. В реальном случае, 
конечно, регистрировать и обрабатывать файлы должны разные приложения: ре- 
гистрация должна проводиться программой, устанавливающей ваше приложе- 
ние на компьютере. | | 


Рис. 1.5 В демонстрация регистрации рабширения > 

П риложение, демонстрирующее Файл 'Е:\ТезЕхаглр\СВийде“ВедЕ Ме. ту’ 

регистрацию расширения 
файлов Это текст файла 


"Геж-ту”, 
а пошаный открытого 


программой 


| АедЕж. 
Отмена регистрации расширения | 


Ниже приводится основной код приложения КеёЕхЕ. 
#1п0с1и4е "гед1з&гу.Прр" 


Уу01А _ ЕазЕса11 ТЕогм1: : Ви оп1С11сК (ТОБ]есЕ *3Зепаег) 
{ 
ТВед1зеку *геа = пем ТКед1зеку; 
тед->КооеКеу = НКЕУ СТАЗЗЕЗ КООТ; 
// создается ключ ".ту" 
гед->ОрепКеу (".му", © гие); | 
// создается параметр со значением "туЁ11е" 
кеа->Мк1ебех1па("", "муЕ11е"); | 
геч->С1озеКеу (); 
// создается ключ "туЁ11е\БеРаи]ЕТсоп" 
теч->ОрепКаеу ("му Е11е\\РеЁаз1ЕТсоп", Е гие); 
// заносится значение пиктограммы: "имя приложения, 0" 
хгеа->Иг1еебегтоа ("", Рагашбехк (0) +", 0"); 
геа->С1озеКеу (); 
// создается ключ "туЕ11е\$5е11 \ореп\соттапа" 
хедч->ОрепкКеу ("шуЕ11е\ \5ре11\\ореп\ \сомтапа", Егие); 
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// создается параметр со значением "имя файла 31" 
хеа->Мг1ебЕт1па ("", Рагамбет (0) + " 31"); 
геч->С1оз5еКеу (); 

геч->Егее (); 


У0о1А __ ЕазЕса11 ТРГоги1: : Вик оп2С11сКк (ТОБ)есЕ *5епаек) 
{ 

ТКед1зегу *гед = пем ТВед1зегу; 

течд->КооеКеу = НКЕУ СТАЗЗЕЗ ВООТ; 

// удаление ключей ".ту" и "туЕ11е" 

хеч->ре1ефеКеу (".му"); 

гедч->Пре1есеКеу ("муЁ11е"); 

гед->Егее();. 


не нннннннннннннннннн-===-====== 
01а __Еазеса11 ТРГогм1: : ГогмСгеаее (ТОБ)есе *5епаехг) 


{ 
1Е (РагатмСочипЕ\() > 0) 


" Мето1->14пев->роаЕЕОПЕЗе (Раганбех (17); 
Таре11->Сар®1оп = "файл '" + РагатбЕх (1) + "!"; 
} 

} 

Особых комментариев этот код, вероятно, не требует. В реальном прило- 
жении вам надо заменить в этом коде “ту” на то расширение, которое вам не- 
обходимо. Кроме того, в приведенном коде в качестве обработчика задается те- 
кущее приложение. Его имя с путем получается вызовом функции Рагат- 
541(0). В реальном приложении это имя файла также надо заменить. 

Отмена регистрации, осуществляемая в функции ВОпВе>СПсЕ, сводится 
к стиранию ранее созданных ключей. 

Обработчик события формы ОпСгезфе определяет функцией РагатСоциЦ ), 
передан ли параметр через командную строку. Если передан, то файл, имя ко- 
торого передано, загружается в окно Мето1. Подобный обработчик (конечно, 
не сводящийся к загрузке в Мето) должен быть вставлен в приложение, обра- 
батывающее файлы. 


1.12 Панель Управления и ее апплеты: 
свойства экрана, свойства системы и другие 


Панель Управления реализована файлом СопЁто[.ехе. Так что вызвать Па- 
нель Управления из своего приложения можно любой функцией, обеспечи- 
вающей вызов исполняемого файла: ЭВе|Ехесще, У шЕхес, СгезёеРгосез$. 
Например, оператором: | 


5ре11ЕхесоЕе (Напа1е, МОТ, "Соп®го1.ехе", "", МОБ, 
ЗИ _5НОММОБВМАТ); 


или оператором 
И1пЕхес ("Сопёго1.ехе",5м ВЕЗТОВЕ); 


В результате выполнения любого из этих операторов на экране появится 
окно Панели Управления, в котором пользователь сможет выбрать нужную 
ему составляющую — апплет. Но можно сразу из приложения вызывать соот- 
ветствующий апплет, применив для вызова те же функции и передав в них че- 
рез командную строку имя файла апплета. Например: 
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бЛе11Ехесике (Напа1е, МОТ, "Сопёго1.ехе", "АрреНЧате", МОТ, 
ЗИ_ЗНОИМОВМАЪ) ; 


или 


\1пЕхес ("Сопёго].ехе АрреНМате" , $и_ВЕЗТОВЕ); 


Здесь Арре Мате — строка с именем файла апплета. Ниже приведена таблица 
некоторых наиболее часто используемых апплетов в У\У/шдо\мз 2000\ХР. В дру- 
гих версиях \/1140о\з некоторые из этих апплетов отсутствуют, но такие основ- 
ные, как Свойства экрана, Свойства системы и ряд других присутствует всегда. 


Имя файла Открывающееся ню 
| аррил2. ср. ОИ .| Установка. и удаление 1 программ _ о _ . 
‘Фаеааттсй ВОВ Администраюр 
Ченем о войетва экрана 1 
Вашил2. < _ Мастер: установки ‚ оборудования и | 
тат, ср етаве Мававег __ ] 
текрей Свойства Интернет 
иаН.сри Язык и региональные стандарты _____ | 
ттвзуз. ср О Свойства: Звуки.и аудиоустройства о - . 
| пера. ср _ НА. _ Сетевые подключения ООН 
пизттатерр _ Учетные записи пользователей — ИИА _ 
о@фсер32< р = Администратор источников данных орвС_ ИИ 
уватер о бвойетва вилемы 
| итедаче. „ср Свойства: Дата и время 


Например, вызов окна Свойства системы может иметь вид: 


5Ве1]1Ехесифе (Напа1е, МОГЬ, "Сопего]1.ехе", "зузам.ср1", 
МОТ, ЗИ _5НОИМОВМАЬ) ; 


В ряде случаев возникает задача учесть в приложении результаты дейст- 
вий, предпринятых пользователем при работе с окном апплета. Наиболее про- 
стым способом реализации этого была бы задержка выполнения приложения 
до того момента, когда пользователь закончит работать с диалоговым окном 
апплета. Задержку выполнения приложения до завершения порожденного 
процесса обеспечивает в большинстве случаев сочетание функций Сгеафе- 
Ргосез$ и УацЕогЭте]еОЦес& (см. разд. 3.2). Но в данном случае это не про- 
ходит. Дело в том, что запускается процесс, связанный с файлом Сопёго[.ехе, 
и он заверттается после того, как вызван апплет, а вовсе не после завершения 
работы с апплетом. Одним из вариантов, обеспечивающих обработку результа- 
тов работы пользователя с апплетом, является реализация обработчика собы- 
тия \М_ АСТТУАТЕ. Это событие наступит, в частности, после того, как ноль- 
зователь закроет диалоговое окно апплета, и управление вернется в окно при- 
ложения. 
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Это может быть организовано примерно так: 


с1аз$ ТГоги1 : руб11с ТРГогм 


{ 
ргауа*е: 
у01Я _ Еаз®са11 ИМАСТТУАТЕ (ТИМАСЕ1уасе&); 
ри11с: 
ВЕСТМ_МЕЗЗАСЕ МАР 


МЕЗЗАСЕ НАМОТЕВ (ИМ _АСТТУАТЕ, ТИМАСЕ1уаке, ММАСТТУАТЕ) ; 
ЕМР МЕЗЗАСЕ МАР (ТСопропепе); | 


:” 


ргоседаге ТЕГоги1.Ваеоп1С11ск (5епаек: ТОБ]ес®); 
редтп 

< вызов апплета > 

епа; 


у01А __Еаз®еса1]1 ТЕГогм1:; : ИМАСТТУАТЕ (ТИМАСЕ1уаее & а) 


{ 
1ЁЕ (а.Асе1уе == МА_АСТТУР) 


{ 


<использование результатов вызова апплета> 
} 
} 


Примеры подобных вызовов апплетов вы найдете в разд. 1.4 и 1.5. 


1.13 Переменные окружения 


В ряде случаев надо уметь читать и устанавливать переменные окруже- 
ния, такие, например, как РАТН и другие. Прочитать полный список перемен- 
ных окружения текущего процесса можно с помощью функции @е Епу- 
гоптеп{ 5115$, объявленной в файле И’таоиз.й следующим образом: 


.РЗТВ СбесЕпу1гопмепе Е г1паз$ ( УОтТр ); 


Функция возвращает адрес блока строк вида 


имя _переменной=значение 


’ 


Эти строки можно только прочитать. Изменять значения переменных с по- 
мощью этих строк невозможно. 

После того как вы извлекли информацию из блока переменных окруже- 
ния, блок надо удалить функцией ЕгееЕпу!гоптет $ и 1то$: 


ВОО ЕгееЕпу1гоппепе5 Е г1па$ (ТМ ГРЗТК); 


В качестве аргумента ГРЗТВ в нее надо передать тот адрес, который ранее 
вернула функция Се Епугоптен{ $ {1т5$. 

Получить информацию о значении какой-то конкретной переменной окру- 
жения можно функцией Се Епугоптеп( УагаШе, которая в файле И1тфазе.й 
объявлена следующим образом: 

РИОВКО СесЕпу1лгопмепеУаг1а1е (ТМ ГРСЗТК 1рМапте, 


ОПТ ГРЗТКВ 1рВцЕЕег, 
ТМ ОРМОВРО п517е); 
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Здесь 1рМаше — указатель на строку с именем переменной, а 1рВиЁег 
и п512е — буфер и его размер. Но применять удобнее другую форму этой функ- 
ции, объявленную в файле буз0И13.йрр: 


ехсегп РАСКАСЕ Ап5156г1па __ Еазеса11 
СсесЕпу1 гоппеп*Уаг1а1е (сопз$Е Ап5156г1па Мапе); 


Здесь единственный аргумент Мате — имя переменной. 
Задать значение переменной окружения или создать новую переменную 
можно функцией Зе ЕпугоптшетУаг1а Ме, объявленной в файле И71тфбазе.й: 


ВООГ Зе Епу1гопмепЕУаг1ар1е (ТМ ГРСЗТВ 1рМаме, ТМ ГРСЗТВ 1рУа1ае); 


Параметр 1рМаше — это имя переменной, параметр 1рУаше — задаваемое 
значение. Если параметр 1рУаШше равен МОТТ,, то переменная 1рМаше удаля- 
ется из списка переменных окружения данного процесса. Если переменной 
с именем 1рМаше нет, и 1рУаШе не равняется МОГ, то создается переменная 
с заданным именем и значением. 

Учтите, что функция Зе ЕпмугоптеУага Ме задает значение перемен- 
ной только для данного процесса. Например, вы можете изменить значение пе- 
ременной РАТН, включив в него пути, требуемые для вашего приложения. Но 
другие приложения будут при этом работать со своими значениями перемен- 
ных. 

Пример, демонстрирующий применение рассмотренных функций, вы най- 
дете на диске, приложенном к книге, в проекте РЕпо в каталоге Утаоиэ. 
На рис. 1.6 приведено это приложение во время выполнения. Список [1$ Вох1 
содержит перечень всех переменных окружения. Выделив в этом списке ка- 
кую-то переменную, в окне ЕЯИ1 можно посмотреть ее значение. Если изме- 
нить это значение и нажать кнопку Изменить (Ви воп1), то значение соответст- 
вующей переменной изменится. 


Рис. 1.6 7 Переменные окружения с. 

Приложение РЕпу во |. ИИ ОМРОТЕРМАМЕ Е 

время выполнения Соторес НВ 
НОМЕОВМЕ [ОбОМ$ЕАУЕЯ 


НОМЕРАТН МОМВЕН_ОЕ_РАОСЕ$5$0Н5 
МСЕУВЕ 05 


Ниже приведен листинг процедур этого приложения. 


У01А __Еаз®са11 ТГогм1: : ГогиСгеа*е (ТОБ]есе *5епаег) 
{ 

РСраг Р, РО; 

Ап515Ег1па 5,а; 


1$ЕВох1->С]еах (); 

РО = Се Епу1гопмепте 5 Е х1па$ (); 
Р = РО; 

Р += ЗЕгеЬеп (Р) 
мр11е (*Р != ' 
{ 

5 = ЗЕЕРаз(Р); 


+ 1; 
\0') 
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5=5.5ир5ег1па (0, 5Егсзрп (Р,"=")) ; 
1Е($ != "") 1Г156Вох1->1семз->Ааа (5); 
Р += ЗЕеЬеп(Р) + 1; 
а=" "; 
} 
ЕгееЕпу1 гопмепе 5 г1п9$ (РО); 
.1$ЕВох1->ТЕепТпаех = 0; 
.1$ЕВох1С11сК (бепаег); 


у01А __Еаз®са]11 ТЕогм1: :[11$&Вох1С11сК (ТОЮ]есЕ *5епаег) 
[ 


соп$Е п=256; 
сраг БаЁЕ[п]; 
сеЕЕпу1гоппеп*УагтаЬ1е (ГРСЗТВ (Тт1$ЕВох1-> 
1семз->5&х1п9$ [.15ЕВох1->Т6ешТпаех] .с_56х()),БуЁ, п); 
Еа1%1->Техе =Ап$15ег1па (раЕ); | | 


У01А _ Еаз®са11 ТЕогм1: :Ви®6оп1С11сК (ТОБ)есЕ *5бепаег) 
`беквпу4 топпепеуаезаьте ( (115ЕВох1 ->теетв-> 
ЗЕ г1па$ [11$Вох1->ТеемТпаех]) .с_$з%г(), 
(Еа1Е1->ТехЕ).с $6и()); 
‚ — 

Функция ЕогтСтез{фе загружает список 11$&Вох1 значениями переменных 
окружения во время создания формы. Переменной РО присваивается значение 
указателя на начало блока переменных, возвращенного функцией бе Епу!гоп- 
теп{ 5 {г115$, Затем то же значение присваивается переменной Р. Переменная 
сдвигается на длину первой строки блока 5%гГеп(Р), так как первая строка не 
содержит интересной информации. А далее в цикле читаются все строки блока 
переменных, и имена переменных заносятся в список 11$ Вох1. Имя перемен- 
ной определяется как первая часть строки, предшествующая символу "=". 

После того как все строки прочитаны, блок освобождается функцией 
ЕгееЕпу1гоптеп{ 5 {г115$, в которую передается адрес начала блока. Затем те- 
кущий индекс Це 4ех списка 115$ Вох]{ устанавливается на первую строку 
и вызывается обработчик щелчка на списке — функция 11$ Вох1СПеК. Эта 
функция определяет функцией Се ЕпугоптеУана Ме значение `перемен- 
ной, выделенной в списке 1,15 Вох], и заносит это значение в окно ЕЧИТ. 

Функция ВиНоп1СПек, являющаяся обработчиком щелчка на кнопке Из- 
менить, заносит функцией Зе Епугоптею& Уага Ше текст, записанный в окне 
ЕЗЕ1, в значение переменной, выделенной в списке [1$ Вох{. 


1.14 Шрифты 


Нередко в приложении желательно обеспечить пользователю возможность 
изменять имя используемого шрифта, не вызывая стандартный диалог выбора 
шрифта. Например, в текстовом редакторе желательно иметь на инструмен- 
тальной панели выпадающий список, содержащий имена всех шрифтов, уста- 
новленных в \У\Итша4о\з. В этом списке должен автоматически отображаться 
шрифт, использованный в текущей позиции текста окна редактирования 
ЕВиевЕаК. А при смене шрифта в выпадающем списке этот шрифт должен при- 
сваиваться выделенному тексту или текущей позиции в тексте. 
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Получить список установленных в У ш4омз шрифтов проще всего с помо- 
щью свойства Еопф$ объекта Эегееп. Это свойство типа ТИ тя$ содержит список 
шрифтов, доступных на данном компьютере (свойство только для чтения). Так 
что описанный выше выпадающий список шрифтов можно реализовать следую- 
щим образом. В обработчик события ОпСгезже формы вставьте операторы: 

СотроВох1->Т$емз = 5сгееп->Гопф$; 


СопБоВох1->ТфещТпаех = СопиБоВох1->Т%ептз$-> 
[паехоЕ (В1срЕа1 Е 1->ШеЕА& г1рабез->Мапе); 


Эти операторы обеспечивают загрузку списка СотфоВох1 именами шриф- 
тов и устанавливают индекс списка на шрифт, используемый в окне ВасвЕЗ1 
по умолчанию. . | 

В обработчики событий ОпКеуОр и ОпМоцзеОр окна Васе ВЕЧИ1 вставьте 
оператор | 


СопЬоВох1->Т+ептпаех = СопьоВох1->Т%&емз-> 
ТпаехоЕ (В1срЕа1 {1 ->5Зе1Абеу1БаЕез$->Мапе); 


Это обеспечит отображение в списке текущего шрифта. 

В С+-+Во|@ег 6 и 2006 свойство АжоСотр ее (доступно, начиная с версии 
С-+--+ВиПаег 6) списка СотфоВох1 целесообразно установить в фгае, чтобы при 
вводе пользователем текста в окно списка компонент автоматически подсказы- 
вал ближайший шрифт из имеющихся на компьютере. При этом надо иметь 
в виду, что по мере ввода пользователем текста в окно списка при каждом нажа- 
тии клавиши будет возникать событие списка ОпСВапее, связанное с изменени-_ 
ем текста. А если при этом компонент подставит пользователю новую строку из 
списка, то возникнет событие ОпСИсК. Так что обработку результатов ввода 
нельзя вставлять в обработчики этих событий. Для обработки надо использо- 
вать события ОпС]озеОр, возникающие при выборе пользователем шрифта из 
списка, и события ОпКеудомп, возникающие при нажатии клавиши. В обра- 
ботчике события ОпКеуВо\мт надо анализировать нажатую клавищу, и если это 
клавиша Ещег, можно производить обработку результатов ввода. 

Таким образом, обработчик события ОпС]озеОр списка СотфоВох1 может 
иметь вид: 


В1срЕа1{1->Гопе->Маме -= СопбоВох1->ТехЕ; 
В1свЕа1*1->бееГосиз (); 


Эти операторы обеспечат изменение текущего шрифта в окне Вас ЕаИ1 
и вернут фокус этому окну. | 

Обработчик события ОпКеуБо\мп списка СошБоВох1 может включать сле- 
дующие операторы: 


Е (Кеу == УК _ВЕТОВМ) 
{ 
1Е (СопБоВох1->ТвепшТр9дех == -1) 

СомБоВох1->ТкещТлаех = СопроВох1->Теетмз->ТпаехоЕ ( 
В1срЕа1 6 1->5е1АеЕг1лравез->Мапе); 
е1зе 

{ 
В1срЕа1 + 1->бе1АбтузБабез$->Мапе = СопбоВох1->ТехЕ; 
В1срЕа1 Е 1->5ееЕРГосаз (); 

} 

} 


Первый оператор # обеспечивает реакцию только на клавишу Етщег. Вто- 
рой оператор # проверяет текущий индекс списка. Если он равен -—1, значит 
пользователь ввел имя несуществующего шрифта, так как иначе автоматиче- 
ская подсказка, работающая при АщоСошр1ефе = фгие, установила бы неотри- 
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цательный индекс. Так что при индексе равном —-1 с помощью метода 1ш4ехОЁ 
шрифт в списке устанавливается равным текущему шрифту окна Вас ВЕЗЕТ. 
А при неотрицательном индексе шрифт окна ВаеЪЕЗИ1 устанавливается в со- 
ответствии с выбором пользователя. 

Рассмотрим теперь некоторые другие задачи, связанные со шрифтами. 
Иногда приложение должно проверить, зарегистрирован ли в У! 114о\з требуе- 
мый ему шрифт. Это, в частности, может потребоваться в программах установ- 
ки. В этих случаях, если требуемого шрифта нет, его надо установить или за- 
менить каким-то другим. А может потребоваться временная регистрация 
шрифта на время работы приложения с последующим его удалением из систе- 
мы. Впрочем, желательно без особой необходимости не использовать какие-то 
экзотические шрифты в своих приложениях. 

Проверить, зарегистрирован ли в системе какой-то шрифт, можно, приме- 
нив к свойству Эсгееп->Роп{$ метод ш4ехОЁ{. Например, следующий оператор 
проверяет, зарегистрирован ли шрифт, имя которого введено в окно ЕЧЁТ: 

1Е (Зсгееп->ГопЕ$->ТпаехоЕ (Тг1м (Еа11->Тех®)) == -1) 


ЗПомМе$засе ("Шрифта нет"); 
е1зе ЗВомМеззасде ("Шрифт есть"); 


Для регистрации шрифта в системе служит функция АаагопВезоигсе, 
объявленная в файле УтёаЕ.Й следующим образом: 


10 АааГоп®*Везоцгсе (ЦРСТЗТВ 1рз2Е11епапе ); 


Параметр 1р$7ЕПепате — это полное имя файла шрифта с путем к нему. 
Файлы шрифтов — это файлы ./оп, „|пЬ, .НР, „Го. 

Функция возвращает номер нового шрифта, добавленного в таблицу 
шрифтов У\У/1т14о\$. Если добавить шрифт не удалось, возвращается 0. 

Если после установки шрифта вы хотите известить все выполняющиеся 
приложения об изменении в системной таблице шрифтов, надо послать 
сообщение \УМ_ЕОМТСНАМСЕ всем окнам верхнего уровня: 


зепаМезаде (НИМО ВВОАРСАЗТ, ИМ ГОМТСНАМСЕ, 0, 0); 


При отсутствии такого оператора даже ваше приложение не воспримет 
новый шрифт, пока вы не закроете приложение и не запустите его снова. 

Если установленный шрифт вам больше не нужен, его регистрацию можно 
отменить функцией ВетоуеГоп&Везоигсе: 


106 ВетоуеГоп®еВезочгсе (ТРСТЗТВ 1рз2Е11епапте )}; 


Параметр !рз2ЕЦепате этой функции тот же, что использовался в функ- 
ции АЗаЕотКВезоигсе. После удаления шрифта надо известить все выполняю- 
щиеся приложения об изменении в системной таблице так же, как рассказано 
выше при добавлении шрифта. При успешном выполнении функция возвра- 
щает ненулевое значение. 

Приведем примеры. Если файл шрифта, имя которого записано в перемен- 
ной Еоп Маше, находится в том же каталоге, из которого запускается ваше при- 
‘ложение, то для регистрации этого прифта в системе надо выполнить оператор: 


АааГгопеВезоигсе ( (Ех гас®Е11ер)1т (Рагап5 г (0)) +"\\" + ЕКопЕМаме) .с_$ег()); 


А для удаления шрифта надо выполнить операторы: 
ВКетоуеРоп&Везоцгсе ( (Ех гас®Е11ер1г (Ракам5е к (0)) +"\\" + 
ЕГопЕ Маме) .с_$5%()); 
Правда, учтите, что результаты регистрации шрифта или удаления шриф- 
та почувствуют только те приложения, которые будут запущены после выпол- 
нения соответствующей операции. Также надо имеет в виду, что сколько раз 
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подряд вы выполните регистрацию, столько же раз надо выполнить удаление 
шрифта, чтобы он действительно удалился. 

Описанный выше способ регистрации шрифта — временный. После пере- 
загрузки системы установленный шрифт не будет зарегистрирован. Если же 
вы хотите установить шрифт для постоянного использования и не только ва- 
шим приложением, надо просто скопировать файл шрифта в папку Ит- 
аоиз\Гоп?з. Способы копирования файлов и папок обсуждаются в гл. 6. На- 
пример, копирование шрифта можно оформить следующим образом: 


Ап$156г1па 5ЕГопе; 

сраг АРсвВах [255]; 

Ап515Ег1па МуРгопе ="езетге. ЕЕ"; 

Ап$156г1па 5= Ех гас®Е11ер1к (Рагат5Е г (0))+ "\\" + МуЕопЕ; 
ТЕ11]ебегеам *боигсе; 

ТЕ1]ебсгеам *Тагдаеф; 

Зоигсе = пеми ТЕ11]ебетгеащ($, ЕптОрепВеаа ); 


Сее\1п9ом$01гескоку (АРсраг, 256); 
ЗРопЕ = (Апз15Ег1па)АРсрагк + "\\Еопез\\" + МуГопе; 
__ Гу 

{ 

Тагаее = пем ТЕ11]ебегеам (5$Коп®, ЕшСгеафе); 

__ © Гу 

{ 
Тагдее->СоруЕгом (5оигсе, 0); 


} 
__ Е1па11у 


{ | 
Тагдае*->Егее (); 


} 


} 
__ Е1па11у 


{ 


боигсе->Ргее (); 


} 


В коде предполагается, что в констайте МуЕопф указано имя файла без 
пути к нему, и что этот файл хранится в том же каталоге, из которого запуска- 
ется приложение. | | 

В разд. 4.1 рассмотрено хранение прифтов в ресурсах проекта и использо- 
вание этих ресурсов для регистрации шрифтов в системе. 

До сих пор речь шла о работе с существующими шрифтами. Но вы можете 
создавать на их основе свои собственные логические шрифты и использовать 
их в приложении. Например, нередко разработчики хотят делать надписи, 
расположенные вертикально или под каким-то углом. Все это можно делать, 
создавая логический шрифт функцией СгезжеЕоп+. Этот шрифт может исполь- 
зоваться для вывода текста на канву любого устройство. Если в системе не за- 
регистрирован шрифт с заданными характеристиками, система подбирает 
шрифт, наиболее близкий к заданному. 

Функция СгежеЕоп& объявлена в файле Итаяа следующим образом: 

НЕОМТ Сгеабегопе (1М 1пе пНезаье, тм 1пе пизаеь, 

„ТМ 1пЕ пЕзсаремепе, ТМ 1пе пЕзсарепеле, 

ТМ 106 пОглепва1оп, ТМ ОМОВР ЕпМелане, 

ТМ РИОВО ЕЧмТеа11с, ТМ ОМОВР Е9мОр4ег11те, 
ТМ РИОВЬ ЕдмЗЕг1Кеоче, ТМ ОМОВО ЕаиСьаг$ек, 
ТМ РИОВО ЕамОцЕра&Ргес1$1оп, 

ТМ РИОВОЬ ЕамС11рРгес151олп, 


ТМ ОМОВР ЕамОца11®у, 
ТМ .РСЗТВ ЕамР1ЕсрАпаЕГап11у); 
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Параметр пНех\{ указывает высоту в логических единицах символов 
шрифта (если задается отрицательное значение) или ячеек, в которые вписы- 
ваются символы (если задается положительное значение). Если задано значе- 
ние 0, берется высота по умолчанию. Обычно целесообразно задавать отрица- 
тельное значение. Это то же значение, которое задается в свойстве Нехв% 
класса ТЕопф. И соотношение его с размером шрифта определяется так же, как 
в ТРГопф: —11 соответствует размеру 8, —13 соответствует размеру 10 ит.д. Если 
задано ненулевое значение, система подбирает наиболее крупный шрифт с вы- 
сотой, не превышающей заданную. 

Параметр п \1ЁВ указывает среднюю ширину символов. Если задано зна- 
чение 0, система сама выбирает подходящую ширину символов. 

Параметр пЕзсаретеп{ указывает в десятых долях градуса угол наклона 
надписей, которые будут выполняться данным шрифтом. А параметр пОмеп- 
фа1оп определяет угол наклона символов. Впрочем, эти значения можно зада- 
вать раздельно только для У/114омз МТ\2000\ХР при работе в графическом ре- 
жиме СМ_АБУАМСЕО. В остальных случаях параметр пЕзсаретепф опреде- 
- ляет оба наклона и значение пОтета1оп надо задавать равным пЕзсаретепф. 

Параметр п \/’е1сЪ{ определяет толщину символов. Значение этого пара- 
метра можно задавать в пределах от 0 до 1000. Значение 0 соответствует тол- 
щине по умолчанию. Другие значения можно задавать целыми числами или 
константами, приведенными в гл. 8 в описании функции СгеафеЕопёф. | 

Параметры #4мПЦа|с, гам Оп4егИпе и #4ам5очКеОцф управляют модифика- 
циями шрифта: курсив, подчеркнутый, зачеркнутый. Если параметр равен 0, 
соответствующая модификация выключена, при значении 1 — включена. 

Параметр #АмСВаг5ей задает множество символов. Обычно используется 
значение РЕРГАОГТ СНАКЗЕТ — множество символов по умолчанию. Это 
значение в наибольшей степени гарантирует вас от неприятных сюрпризов, 
связанных с отсутствием на компьютере пользователя требуемого шрифта с за- 
требованным множеством символов. Можно также задавать значение ВО5$- 
ЭТАМ_ СНАВЪЗЕТ, если есть уверенность, что множество символов кириллицы 
имеется в требуемом шрифте. Для вывода текста, записанного символами МБ 
ОБ, следует задавать значение ОЕМ_СНАВЗЕТ. | 

Параметр {АмОиёриРгес1$10п определяет поведение системы при поиске 
шрифта, наиболее соответствующего заданному. Обычно используется одно из 
следующих значений этого параметра: 


Значение | _ | __ | Опиание И 
ООТ_ РЕЕАОТТ_ РКЕС!$ ‚Поведение по ‚ умолчанию. ю. 
 ООТ ОЕУТСЕ_РВЕСТ$ ` Если имеется несколько шрифтов с одинаковым 


о . а выбирается шрифт устройства. 


'‘оот_ ООТМЕ_ РКЕС!$. 'Шрифт ищется среди шрифтов типа ТгаеТуре 


| | И других эскизных. типов. 


` от. _ВАБТЕВ_ РВЕС!$. `| Если имеется несколько шрифтов с одинаковым 
‚ именем, выбирается растровый шрифт. 


й оОт_ тт. ОМтУ_ РВЕС!$ ‚Идет поиск только шрифтов ТгиеТуре. Если нет 
‚установленных шрифтов ТгицеТуре, реализуется 
| о й — Во ожети иноволь ри 
ох 
|1 


оот_ тт. РВЕС!$ Если имеется несколько шрифтов с одинаковым _ 
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Параметр ЁамСИрРгес1$1оп определяет, как производится усечение симво- 
лов, частично не помещающихся в заданную область. Обычно используется 
значение СТТР_РБЕКАОТТ_РКЕСТ® — усечение по умолчанию. 

Значение параметра #{4м@иа Шу обеспечивает критерий компромисса меж- 
ду качеством отображения символов и точностью соответствия шрифта задан- 
ным требованиям. При значении РЕЕАОТТ @ОАШТУ приоритет отдается 
точности соответствия заданным требованиям. При значении РВООЕ О©9ОА- 
ГТТУ на первое место выдвигается качество отображения символов. Значение 
ОКАЕТ О@ОАШТУ — промежуточный вариант. 

Параметр #4мРЫевАп9Еат у определяет шаг размещения символов, рас- 
стояние между ними. Точнее, это определяется двумя младшими разрядами. Они 
могут задаваться константами РЕЕАОТТ_РТТСН — по умолчанию, ЕТХЕР_ 
РТТСН — фиксированный шаг, УАВТАВЕЕ РТТСН — изменяющийся шаг. 
Старшие разряды определяют некоторые характеристики семейства шрифтов. 
Эти тонкости вы можете посмотреть во встроенной справке С++Ви!аег. 

Параметр 1р$2Еасе является указателем на строку с нулевым символом 
в конце, определяющую имя шрифта. Длина строки не должна превышать 32 
символов. 

Как видно из изложенного, логический шрифт создается на основе како- 
го-то из шрифтов, зарегистрированных в системе. Задаваемые параметры слу- 
жат только ориентиром при выборе подходящего шрифта. Если шрифт уда- 
лось подобрать, функция Сгеа&еЕоп{ возвращает его дескриптор. В дальней- 
шем этот дескриптор можно передавать канве устройства, на которое выводит- 
ся текст. Если шрифт подобрать не удалось, возвращается 0. 

После того как созданный логический шрифт использован, его надо уда- 
лить из памяти функцией О@еееОЦес{, в которую передается дескриптор 
шрифта. 

На рис. 1.7 слева показаны некоторые варианты вывода строк с различны- 
ми шрифтами, различающимися, прежде всего, углами наклона (правая часть 
этого примера будет рассмотрена позднее). Приложение содержит компонент 
Гпасе1 размером 200 х 200. Ниже приведен код, обеспечивающий создание 
и использование шрифтов в этом примере. На диске, приложенном к книге, 
этот пример реализован в проекте РГоп1Гох в каталоге Старй. 


Рис. 1.7 2 РоРПо 
Пример логических 
шрифтов 
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Уу01А _ Еазеса11 ТГоги1: :Ваеоп1С11сК (ТОБ]есе *5бепаег) 


{ | 
НЕОМТ Н1, Н2, НЗ, НА; | 


Н1 = Сгеа®еГоп® (-13, 0, 450, 450, ЕИ ВОТЬ, 0, 0,0, 
ВУ$ЗТАМ СНАВЗЕТ, ОЧТ РЕГАОФГТ РВЕСТЗ, 
СЪТР_ РЕЕАОГТ РВЕСТ5, РЕРКАОГТ ОЧАТТТУ, 
РЕРАОЬТ _ РТТСН, "Соиг1ег Мем"); 

СгеафеГоп® (-13, 0, -450, -450, ЕМ МОВМАЦ, 0,0, 0, 
РЕРГАОГТ. СНАКЗЕТ, ОЧТ_ РЕРАОТТ РВЕСТЬЗ, 
СЬТР РЕРАОГТ_ РВЕСТЬ, ” РВООЕ _ОЧАГТТУ, 
ЕТХЕР РТТСН, `` "Аг1а]1"); 

НЗ = СгеаКеГоп® (-13,.0, 1800, 1800, ЕМ МОВМАЬ, 0, 0, 0, 
РЕГАОГТ СНАВЗЕТ, ОЧТ РЕРГАОТТ_РКЕСТЗ, 
СЬТР РЕРАОГТ РВЕСТЬЗ, `” РВООЕ _ОЧАЬТТУ, 
РЕРАОГТ _ РТТСН, мМОЪЬ); 

СтеакеКопе (- 13, 0, -900, -900, ЕМ МОВМАЦ, 0,0, 0, 
РЕРАОГТ СНАВЗЕТ, ОЧТ_ РЕРАОТТ _РВЕСТЬФ, 
СЬТР РЕЕАОГТ РВЕСТЬ, ` РКООЕ _ОЧАБТТУ, 
РЕРАОТТ РТТСН, МОТЬ); 

Тпаче1->Сапуаз->Е111Вес® (Тмаде1- >Сапуаз->С11рВес®); 

Тпаче1->Сапуаз->Гопе->б12е = 10; 

Тпаде1->Сапуаз->ТехеОи® (50,90, "Обычный текст"); 

Тпаче1->Сапуаз->ЕГоп®->Напа1е = Н1; 

Тпаче1->Сапуаз->Тех®Очц& (5,95,"Текст под углом 45"); 

Тпаче1->Сапуаз->ЕГоп®->НапА1е = Н2; 

Тпаде1->Сапуаз->ТехеОй% (10,100,"Текст под углом -45"); 

Тмаче1->Сапуа$->Гоп&->Напа1е = НЗ; 

1паче1->Сапуаз->ТехеОц (170,140, "Текст под углом 180"); 

Тпаче1->Сапуа$->ЕГопе->Напа1е = НА; 

Тпаче1->Сапуаз- >ТехЕОие (190, 50, "Текст под углом -90"); 

ее есЕ (4221 

Ре1есеоБ] есь (Н2); 

Ре1есеор]ес® (НЗ); 

Ре1есеоь]ес® (Н4) 

} 


В этом примере создается четыре логических шрифта, различающихся, 
в основном, углами поворота, но, частично, и другими характеристиками. Соз- 
дайте соответствующий тест, поварьируйте параметрами функции СгезфеЕопф, 
и вы почувствуете их влияние на выводимые тексты. 

Имеется еще одна функция, позволяющая создавать и использовать логи- 
ческие шрифты. Это функция СгеаеЕРоп п1гес%, объявленная в файле И т- 
4ои3з.й следующим образом: 


Н2 


Н4 


® 
: 


НЕОМТ СгеабеРопеТпа1гес® (ТМ СОМ$Т ТОСЕОМТА * р1) 


Атрибуты шрифта в данном случае задаются элементами структуры р1 


И _ ___ | функции СгежеРот 

ом6 инены  _ 
тома иУла 
ПОМ6_МЕзеарошоле 


ГОМ@ _НОнмещайоп пОгмета10оп 


А ое | 


том с И\УеВ _ 
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——————ч 
: Поле структуры типа ТГо&Роп$ Аналогичный параметр | 
| __| функции СгеаеР оп | 


_ВУТЕ _ИНаНс 


ВУТЕ НОпдегпе 
`ВУТЕ ИЗилкеОщ 


ВУТЕ ИСВагбе 


ВУТЕ ЦНОиЁРгес$оп 


#4 ОпдегПпе 
Гаузочке0е 


Аа\СВаг5е 


АО рийРгес1$10п 


ВУТЕ_ ИСИрРгес1з10п о а\СИрРгес1;10п 
`ВУТЕ ИОцашу {а’ОпаШу | 


ВУТЕ_ ИРИсВАпаРаш у [аРНсВАПаЕашйу | 
`СНАВ_НРасеМаше.Е_РАСЕЗТЕЕТ ре | 


Поскольку все поля соответствуют уже рассмотренным параметрам функ- 
ции СгеафеКопф, можно их не рассматривать и ограничиться примером. Этот 
пример реализован в правой части приложения, показанного на рис. 1.7. При- 
ложение содержит компонент Ппафе2 и таймер Типег1. При запуске приложе- 
ния строка, отображаемая в Ппайе2, вращается с частотой, определяемой тай- 
мером. Значение параметра П\щфегуа в Типег1 задано равным 10. Ниже приве- 
ден код примера. 

ТЬочЕопе р1Е; 

НЕОМТ Н; 

У0о1А __Еаз®са11 ТЁГоги]: :КогмСгеа®е (ТОр]есе *5епаег) 


{ 

р1ЁЕ.1ЕМелаве = ЕМ МОВМАГ; 

$Егсру (р1ЁЕ.1ЕГасеМаще, "Аг1а1 В1асКк"); 
р1Ё.1ЕСПаг5ее = ПЕКАОГТ СНАВЗЕТ; 
Р1Е.1ЕЕ5зсаретеп® = 0; 


Уу01А _ ЁЕаз®са11 ТГоги]: :Т1мег1Т1мег (ТОБ)есе *5епаекг) 
{ 
Тпаче2->Сапуа$->Е111ВесЕ (Тмаде2->Сапуа$->С11рВес®); 
Н = СгеакеГоп®Тпла1гес® (&р1Е); 
Тпаче2?->Сапуаз->ЕГоп&->Напа1е = Н; 
Тпаче2->Сапуаз->ТехеОц® (100, 100, "Вращение"); 
Р1Е.1ЕЕ5саремеп® -= 450; 
Ре1еъеор]ес® (Н); 
} 


В функции ЕогтСгезе в структуру рЁ заносятся атрибуты создаваемого 
шрифта. А в функции Т!тег1Типег по этой структуре формируется функцией 
СгежеРоп п1тгес{ логический шрифт, дескриптор которого заносится в пере- 
менную Н, а затем передается в канву Ппаде2. Наклон строки (значение поля 
НЕзсаретеп{) при каждом обращении к функции Т1щег1Т!ипег увеличивается 
на 450, т.е. на 45 градусов. 
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1.15 Даты и время в АР! ММтдоми/$ и С++Ви@ег 


1.15.1 Форматы представления дат и времени 


Начнем с обзора форм представления дат и времени в С++Ва!Паег и в АРП 


УЛ тпаомз. В С++ВиПаег основная форма хранения дат и времени — тип 
ТРаёеТипе. Это действительное число, в целой части которого хранится дата, а 
в дробной — время в виде дробной части суток. Для 32-разрядных версий 


С+-ВиПаег за начало календаря принята дата 00 часов 30 декабря 1899 года. 
Прибавление к значению типа Т)афеТите целого числа О равносильно увеличе- 
нию даты на О дней. Разность двух значений типа ТОжеТипе дает разность 
двух дат с точностью до долей дня. Для вычисления разности двух дат в годах 
‚могут использоваться функции Уеаг$Вефмееп и УеагЭрап, объявленные в фай- 
ле Рае И8.йрр: 


116 _ Еаз®са11 УеагзВеемееп (сопзЕ бузфет: :ТрафеТ1те АМом, 
сопзЕ бузееш: :ТРабеТ1тме АТреп); 


Чоцю]е _ Еаз®&са11 Уеагбрап (соп5Е бузеет: :ТРабеТ1ме АМоч, 
сопзе бузеем: : ТРафеТ1те АТпеп); 


Функции возвращают число лет между двумя значениями даты и времени 
АМом и АТВеп типа ТОжеТ!ипе. Функция УеагзВефмееп возвращает число 
полных лет между двумя значениями. А функция Уеаг5рап возвращает дей- 
ствительное число, содержащее дробную часть, отображающую неполный год. 

Хотя годы (високосные и не високосные) имеют разную продолжитель- 
ность, функции УеагзВефмееп и Уеаг5рап это не учитывают и исходят из ус- 
редненного значения 365.25 дней в году. 

Приведенный ниже оператор отображает возраст (полное число лет) чело- 
века, год рождения которого записан в переменной Вогп: 


Таре11->СарЕ1оп = ТпЕТобег (УеагзВе*мееп (Раее(), Вогп)); 


Функция УеагзВеф\уееп объявлена в файле Дате 115.Прр, который надо 
подключить к модулю: 


#1пс10ае <дафеи*11$.Прр> 


Впрочем, можно обойтись и без функции УеагзВефхееп, определяя воз- 
раст оператором: 


Таре11->Сар®1оп = ТпЕТобек ( (1п®) ((аоцб1е) (Рафе() - Вогп) /365.25))); 


Тогда и файл Дае0113.йрр подключать не надо. 

Иногда при необходимости высокой точности представления времени ис- 
пользуется тип ТТипе$атр, объявленный в файле Дате0Н[3.Йрр: 

зЕгисе ТТтмебсапр 


{ 
1п=- Тзпе; // Число миллисекунд с начала дня 
11 Рафе; // 1 + число дней с 1/1/0001 
}; 
Этот тип используется в случаях, когда требуется повышенная точность 
отображения времени с учетом миллисекунд. Аналогичную точность дает тип 
Т5ОГТипе{ашр, объявленный в файле ЗТит5Е.Йрр: 


$Егисе Т5ОГТ1мебфатр 
{ 


$ПогЕ Уеаг; 
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Мог МопЪП; 

Мог Пау; 

Иога Ночг; 

Мога Млпиее; 

Мога 5есопа; 
ип51апеа Егас®1оп$; 

}; 

Поле Уеаг — год, который может принимать значения от 1 до 9999. Поле 
Мош ® — месяц (от 1 до 12). Поле Вау — день месяца (от 1 до 28, 29, 30 или 31 
в зависимости от месяца). Поле Нопг — час (от 0 до 23). Поля Мише и Эесоп — 
минуты и секунды (от 0 до 59). Поле ЕгасНоп$ — миллисекунды (от 0 до 999). 

Для взаимного преобразования этих типов используются функции ПБа- 
феТ1теТоТипе ф{ашр, ТипеатрТодаеТ!ипе, ОжеТипеТтоэГТипе{атр, 
5ОГТЛ те З$атрТода{еТ!те, Уаг5ОГЛ пе фатрСгезфе. Не будем на них оста- 
навливаться. Вы можете посмотреть их описания во встроенной справке 
С++Ви!аег или в справке [4]. 

В АРТ \У/114о\з используются иные формы хранения дат и времени. Тип 
ТбузетТ!те (_ЗУЗТЕМТТМЕ) описывает структуру, поля которой содержат 
элементы даты и времени, начиная с года и до миллисекунды: 


суреаеЕ зегисе ЗУЗТЕМТТМЕ { 


ИОВР мУеаг; // год 
МОВО мМопЕВ; / месяц (январь - 1, 
/ февраль - 2 ит.д.) 
ИОВО мрауоЕМеек; // день недели (воскресенье - 0, 
// понедельник - 1 ит.д.) 
ИОВР мрау; // день месяца 
ИОВО мНоиг; / час 
ИОВ мМапа*е; // минута 
МОВО мбесопа; / секунда 


ИОВ мМ11115есопа$; // миллисекунда 


} ЗУЗТЕМТТМЕ, *РЗУСТЕМТТМЕ, *ГРЗУЗТЕМТТМЕ; 


Непосредственное сложение или вычитание значений типа ТЗузетТище 
не рекомендуется. В АРТ \У/114ом\з рекомендуется для подобных онераций пе- 
ревести сначала значение в форме ЗУЗТЕМТМЕ в структуру типа _ЕП.Е- 
ТТМЕ, которая будет описана далее, затем преобразовать ее в структуру типа 
_САВСЕ ТМТЕСЕВ, а уже с этой структурой можно осуществлять арифмети- 
ческие операции. Однако в С++Ви!аег имеется более простой способ — функ- 
ция ЗузетТипеТорафеТите: 


зузеем: :ТРаъбеТ1ме _ Ёаз®са11 бузбетТ1неТораееТ1те ( | 
соп5Е _ЗУЗТЕМТТМЕ &бузеемТ1ие); 


Функция переводит значение в тип Т)аёеТ!ипе, к которому можно применять 
арифметические операции. Функция ВаёеТипеТоЗузетТипе переводит зна- 
чение типа Т)аёеТ!те в тип Т5узетТите: 


у014 __ЕазЕса11 ПРафеТ1меТто5узЕемТаме ( 
соп5Е бузсем::ТрафеТ1те РасеТл1ме, _ЗУЗТЕМТТМЕ &бузеемТ1ще); 


Получить текущую дату и время в формате ТЗузбетТипе можно с помо- 
щью функций Се ГосаГГше и беЗузетТипе: 


УОТО СеЕеГоса1Т1ме (ООТ ГРЗУЗТЕМТТМЕ 1рбузкешТме); 
УОТО СбеббузеемТ1ме (.РЗУЗТЕМТТМЕ 1рбузекемТ1ще); 
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Первая из них заносит в запись 1рЗузвет'Т1 те информацию о текущем ло- 
кальном времени, а вторая заносит в запись информацию о стандартном вре- 
мени — времени по Гринвичу. 

Функции Зе Т.оса!ТГ1те и Зе ЗуетТипе позволяют установить локаль- 
ное и системное время на компьютере: 


ВООТ ЗееЪоса1Т1ме (ТМ СОМЗТ ЗУЗТЕМТТМЕ *]1рбузсепТ1ще); 
ВОО ЗесбузфемТ1те (СОМЗТ ЗУЗТЕМТТМЕ *1рбузеешТ1пе); 


Для отображения дат и времени, используемых в файловой системе (созда- 
ние файла, его последнее открытие и изменение), а также в таймерах ожида- 
ния (см. разд. 3.6) используется тип ТЕЦеТ!те (_ЕПЕТТМЕ): 


суреаеЕ зекгасе _ЕТЬЕТТМЕ { 
РИОВР Амомра®еТ1те; 
РИОВКР ЯАмНлайра*еТ1лме; 
} РТЬЕТТМЕ, *РЕТЬЕТТМЕ, *ГРЕТТЕТТМЕ; 


В структуре этого типа хранится время в сотнях наносекунд, отсчитывае- 
мое от 1 января 1601 г. Взаимный перевод типов ТЕЦеТ!щте и ТЗузетТипе 
осуществляется функциями ЕПеТ1пеТоЗуетТ1 те, ЗузетТипеТоЕПеТие: 


ВООЬ Е11еТ1теТоЗузф$етТ1те (СОМЗТ ЕТЪЕТТМЕ *1рЕ11еТапе, 
ТРЗУСТЕМТТМЕ 1рбузбешТ1те); 

ВООТ ЗузкешТ1лтеТоЕ11еТлте (СОМЗТ ЗУЗТЕМТТМЕ *1рЗузбептТ1аие, 
ГРЕТЬЕТТМЕ 1рЕ11еТ1те); 


Можно также написать собственную небольшую функцию, переводящую 
тип ЕПЕТТМЕ в одно 64-разрядное число: 


__ 110664 Е1]1еб1меТъо1пе64 (ЕТЪЕТТМЕ Е) 


{ 
кебогп 106645011Моа32 (Е.амН1апваееТ1ме, 32) | Е.АмЬомраееТ1ие; 


} 


В этой функции использован вызов функции 1464511 Мо9д32, который 
сдвигает число Е.4\Н1ОафеТ!те в старшие разряды возвращаемого значе- 
ния и добавляет Е.АмГомОафеТипе в младшие разряды. Таким образом, 
функция ЕЦейтеТо!1{64 возвращает в виде числа сотен наносекунд время, 
записанное в переданном в нее параметре Е. А далее к таким числам можно 
применять любые арифметические операции. 

Выше упоминалась структура _ГАВСЕ_ТМТЕСЕВ, в которую можно пере- 
водить данные, заданные структурами типа _ЗУЗТЕМТТМЕ и _ЕШЕТМЕ, 
чтобы осуществлять с ними арифметические действия. Указывалось также, 
что, работая с С++ВаПаег, можно обойтись без этих преобразований. Тем не 
менее, некоторые функции АРТ У/114о\з требуют параметры именно типа 
_ГАВСЕ_ТМТЕСЕВ. Ниже приводится объявление этого типа: 

суре4еЁ уп1оп _ТАВСЕ_ТМТЕСЕВ { 

ЗЕКИСЕ +4 
РИОВО ГомРаг®; 
ТОМС Н1оапРак®; 
 ОмСтомС ОцааРаг®; 
} ТАВСЕ ТМТЕСЕВ; 


Эта структура, хранящая время в сотнях наносекунд, является объедине- 
нием, которое хранит данные или в 64-разрядном поле @иа@дРагф, или, если 
компилятор не поддерживает 64 бита, то в полях ГомРаг& и НВ Рагф. Эти 
поля эквивалентны полям 4мГомОаеТипе и 4мН16ОафеТипе структуры 
типа ТЕ|еТите (_ЕШЕТТМЕ). Но в этих двух видах структур выравнивание 
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осуществляется не одинаково. Так что явным образом приводить эти типы 
друг другу нельзя. Точнее — опасно: может сработает, а может и нет. При не- 
обходимости такого преобразования надо просто копировать соответствующие 
поля из одной структуры в другую. 

Особым образом хранится информация о времени, связанном с файлами, 
в М5 РОБ. Для преобразования этого времени между форматом РОБ и ТЕПе- 
Типе служат функции ВозОаёйеТипеТоЕЦеТ1те и ЕИеТипеТтТорозОа4еТипе. 


1.15.2 Локальное время 


Теперь рассмотрим вопросы, связанные с локальным временем. Это время 
зависит от часового пояса. К, тому же, в нашей стране и многих других странах 
имеется различие между летним и зимним локальным временем. В АРТ 
\У/1т4о\з есть тип структуры ТТипейопе {огта оп (_ТТМЕ_2О0МЕ_ТМЕОВ- 
МАТТОМ), содержащей данные о смещении локального времени и датах пере- 
хода на летнее и зимнее время: 

суредеЕ зегисЕ _ТТМЕ _2ОМЕ_ТМЕОВМАТТОМ { 

ТОМС Взаз; 
ИСНАВК ЗЕапаагЯМапе[ 32 |]; 
СУСТЕМТТМЕ У+Еапдагара*е; 
ТОМС ЗЕапаагаВтзаз; 
ИСНАВ Пау1191%Маме [ .32 ]; 
ЗУЗТЕМТТМЕ Рау]1906ПРафе; 
| ТОМС ПРау11а0%В1аз; 
} ТТМЕ_2ОМЕ_ТМЕОВМАТТОМ, *РТТМЕ _2ОМЕ_ТМЕОВМАТТОМ, 
*ТРТТМЕ 2ОМЕ_ ТМЕОВМАТТОМ; 


Информация, содержащаяся в этой структуре, определяет соотношение меж- 
ду стандартом согласованного универсального времени (Соог4та4еа Ошхегза1 
Типе — ОТС или время по Гринвичу) и локальным временем. Основное поле Влаз$ 
определяет соответствие между этими временами. В поле содержится смещение 
локального времени в минутах по отношению к ОТС. Например, для Москвы 
Ваз = —180. Т.е. московское время опережает ОТС на 3 часа. В общем случае: 


ОТС = локальное время + смещение. 


Поле З$апдагаМате — строка с нулевым завершающим символом, даю- 
щая название стандартного (зимнего) времени, принятого в системе. Напри- 
мер, для Москвы это может быть "Московское врёмя (зима)”. Данное поле не 
используется операционной системой и не является обязательным. В качестве 
ЭЗбапдагаМате может быть задана пустая строка. Но если полз З$апдагаМате 
задано при вызове функции Зе Ттейопешогта оп, то оно будет прочитано 
без изменений при последующем вызове функции СбеТГипейопе {огтай оп. 

Поле Зфапдага)а{е является структурой описанного ранее типа ТЗузет- 
Типе, содержащей дату и время перехода с летнего на стандартное время. 
Если такая дата не указана, то поле мМоп В структуры ®апдагаО)а{е должно 
быть равно 0. Если поле Зф$апдагаОа{е заполнено, то должно быть заполнено 
и описанное далее поле Вауп=Оафе. 

Структура Эфапдага)а{е может содержать информацию в двух форматах. 
Во-первых, это может быть точная дата перехода: мУеаг — год, мМопёВ — ме- 
сяц, \Бау — день, “Ног — час, уМииие — минута, \мЭесоп — секунда, 
\МИ5$есоп4$ — миллисекунда. Однако обычно переход не привязан к опреде- 
ленной дате, а привязан к определенному дню недели определенного месяца. 
Например, к последнему воскресенью какого-то месяца. Структура ®фап4агд- 
Рафе может заполняться в таком формате. В этом случае ее поле мУеаг рав- 
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но 0, поле “Мот ® указывает месяц, поле мВау0Ё!\ееК указывает день неде- 
ли, а поле \Эау определяет, в который по счету день месяца происходит пере- 
ход времени. Поле м“Оау может принимать значения от 1 (первый день) до 5 
(последний день). Например, если переход на зимнее время осуществляется 
в 3 часа ночи последнего воскресенья октября, то мУеаг =0, мМош 1 = 10, 
\ПауОЁ!\УТееК = 0 (на Западе воскресенье считается первым днем недели, а не 
последним как у нас), \Оау = 5, мНошг = 3. 

Если задано значение поля ЭфапдагаОафе, то поле ЭЗ$апдагАаВ1а$ может со- 
держать дополнительное смещение, складываемое с В1аз в период зимнего вре- 
мени. Обычно это значение равно 0. | 

Поле Вау|=6 Маше — строка с нулевым завершающим символом, даю- 
щая название летнего времени, принятого в системе. Например, для Москвы 
это может быть "Московское время (лето)". Данное поле не используется опе- 
рационной системой и не является обязательным. В качестве Вауй=6 Мате 
может быть задана пустая строка. Но если поле Вауй Мате задано при вы- 
зове функции Зе Титейопе{огтай оп, то оно будет прочитано без изменений 
при последующем вызове функции де Типейопе{огта оп. 

Поле РауйцДафе определяет структуру типа ТЗузетТипе, содержа- 
щую дату и время перехода с зимнего на летнее время. Если такая дата не ука- 
зана, то поле мМошё В структуры Вауй Рае равно 0. Если поле Вауйе- 
Дафе заполнено, то должно быть заполнено и поле апдага) же. Структура 
ЭЗбапдага)Райе может содержать информацию в двух форматах, описанных 
выше для поля Эфапдага)зжфе. Например, если переход на летнее время осуще- 
ствляется в 2 часа ночи последнего воскресенья марта, то мУеаг =0, 

у\Моп = 3, мБауОЁ\еек = 0, “Дау = 5, мНошг = 2. 
| Если задано значение поля Вауйе В Оже, то поле Вауй аз$ содержит 
дополнительное смещение, складываемое с Вй1аз в период летнего времени. 
Обычно это значение равно —60 — сдвиг на 1 час. 

Работу со структурами типа ТТипейопе {огта Йоп обеспечивают функ- 
ции Се Т1тейопей{огтайоп и ЗеТипейопеш!огтайоп: 

РИОВР СеетТ1меблопеТпЕогма*1олп ( 

ОСТ ТРТТМЕ 2ОМЕ_ ТМЕОВМАТТОМ 1рТ1те?опеТпЕогтае1оп); 


ВООТ Зе Т1пиейопеТпЕогма® 1олп ( 
СОМ5Т ТТМЕ_2ОМЕ ТМЕОВМАТТОМ *1рТ1мебопеТптЕогма®1оп); 


Функция Се{Ттейопе огта оп дает доступ к информации о поясном 
времени, на которое настроена система. Эту информацию функция извлекает 
из настроек \/1п49о\мз$ и заносит в структуру, указанную параметром Ш’Гите- 
Лопе {огта оп. Функция Зе Гипейопе {огтайоп заносит аналогичную 
информацию в систему. 

При успешном вызове бе Типейопе огтайоп функция возвращает одно 
из следующих значений: 


— — 
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ТМЕ_2ОМЕ_Т_ОМКМОММ Операционная система не может опреде- | 

лить временной пояс. Это может быть, если | 
перед этим при вызове функции Зе Тите- | 

Лопе огтайоп в рТипейопе шогтайЙоп 


Е — =======ф 
| 
Н 
р 


' ТТМЕ_7ОМЕ_ТШ_$5$ТАМОАВО |Операционная система работает в соответ- | 
ствии со значением поля Э4апдагаОафе за- ‹ 
— ар рТипейопе{огтайоп, т.е. по стан- . 


дартному (зимнему) времени. — 


ВАНЯ 
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Т1МЕ_20МЕ_Ш_РАУМСНТ Операционная система работает в соответ- | 
|  ствии со значением поля аун Ш Оже за- | 
писи 1рТипейопей{огтайоп, т.е. по лет- — 


нему времени. 


Если вызов аеТиптейопе {огта оп привел к ошибке, возвращается зна- 
чение ОхРЕЕЕЕЕЕКГ. Функция Зе ТГипейопеПй{огтайоп возвращает в случае 
ошибки Ёа[$е. 


Рассмотрим примеры применения функций локального времени. Пусть 
в переменной Т типа ТРаёеТипе хранятся дата и время некоторого события по 
московскому времени. И вы хотите в переменную ТЬое типа Т)аёеТ!те зане- 
сти локальные дату и время вашего часового пояса, соответствующие этому со- 
бытию. Такой пересчет можно сделать следующим кодом: 


ТТ1мейопеТпЕогмае1оп 1рТ1ме?опеТоЕогма%*1оп; 
Зузеем: :ТРафеТт1ще Т, ТЬос=0; 


1Е (СесТ1мегопеТтЕогма®1оп (&1рТ1щмеропе1тпЕогма®1оп) == 
ТТМЕ_2ОМЕ_ТР_ЗТАМРАВЬ) 


Трос = Т + (-180. — 1рТ1мейопеТпЕогма&1оп.В1аз — 
1рТт1мейбопеТпЕогма&1оп. 5+ апаагаВлаз) / (60 * 24); 
е15е 
ТЬос = Т + (-180. — 1ртлмебореТпЕогма*1оп.В1а$ — 


1рТ1пеболеТлЕогма*1оп.Рау119.ЕВ1аз) / (60 * 24); 
ЗБомМеззаае (РасеТ1меТтоЗехт (Т) + "\п" + БафеТ1меТобехг (ТГос)); 


Оператор № вызывает функцию Се Типейопе{огтайоп, которая запол- 
няет структуру 1рТипейЙопе{огта оп типа ТТипейопетогтаНоп инфор- 
мацией о локальном времени. Анализируется значение, возвращенное функ- 
цией, и определяется, функционирует ли в данный момент зимнее или летнее 
время. В зависимости от этого определяется сдвиг локального времени. Для 
определения локального времени, соответствующего значению Т, формирует- 
ся суммарный сдвиг, который делится на (60 * 24) — т.е. на число минут в сут- 
ках. Для формирования сдвига сначала вычитается 180. Так как смещение мо- 
сковского времени —180, то тем самым время Т приводится к согласованному 
универсальному времени. Затем к этому времени добавляется локальный 
сдвиг, величина которого зависит от того, функционирует ли в данный момент 
зимнее или летнее время. Последний оператор отображает сообщение, содер- 
жащее исходное московское и вычисленное локальное время. 

Приведенный код предполагал, что на компьютере задана полная инфор- 
мация о переходе на летнее и зимнее время, т.е. в структуре типа ТТ!те- 
Лопе@ {огта оп заданы значения полей З$апдага)а{е и ауй Оафе. В этом 
случае, если функция Се Типе?опеп{“огтайоп не вернула ТТМЕ_2О- 
МЕ_Т_ ЗТАМОАВЮ, значит время летнее. Но в некоторых случаях информа- 
ция о зимнем и летнем времени может быть не полная. Так что в общем случае 
вместо содержащегося в приведенном коде оператора № лучше использовать 
$мЦей: | 

5м1ЕсЬ (СееТ1мебопеТпЕогма® Тот (&1рТ1тебопеТпЕогма® 1оп) ) 

`сазе ТТМЕ_2ОМЕ_ТР $ЗТАМРАВР: 

‘ТЬос = Т + (-180. — 1ртТ1лмебопеТпЕогмта Е 1оп.В1а$ — 

1рТ1тебопеТпЕогма&1оп.5еапаагаВ1аз) / (60 * 24); 
ЗпомМеззаае (РакеТт1меТобег (Т) + "\п" + РафеТ1меТобек (ТЬос)); 
БЬгеак; 
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сазе ТТМЕ 2ОМЕ ТО РАУБТСНТ: 
ТЬос = Т + (-180. — 1рТ1лмебопеТпЕогма®*1оп.В1а$ — 
1рТ1мейбопеТпЕогта*1оп.Рау1191{В1аз)} / (60 * 24); 
ЗпомМеззасе (РакеТ1теТо$ек (Т) + "\п" + РафеТ1щеТобек (ТГос)); 


ргеак; 

сазе ТТМЕ 2ОМЕ_ Тр ОМКМОММ: 
Трос =Т + (- -180. — 1рТ1мебопеТпЕогма®1оп.В1аз) / (60 * 24); 
ЗРомМеззаае (РафеТ1теТо$ Ех (Т) + "\п" + БабеТлмеТобех (ТГос)); 
ргеак; | 

ЧеЕат1%: 
ЗпомМеззаде ("ошибка"); 
ех1{ (0); 

} 

Теперь рассмотрим решение обратной задачи — перевода текущего ло- 


кального времени в московское. Это можно сделать следующим кодом. 


ТТ1мебопеТпЕогта®1оп 1рТ1тебопеТпЁЕогма®1оп; 
Зузсетм: :ТРафеТл1те Т=0, ТМоз=0; 


Т = №м(); 
1Е (СесТ1перопеТптЕогма®1ол (&1рТ1тейопеТпЕогма®1оп) == 
ТТМЕ_2ОМЕ_ТР_ЗТАМРАВО) 


ТМоз = Т + (1рТ1лмебопеТтЕогма®1оп.В1аз + 
1рТ1мебопеТпЕогма®1оп.5%апаагЯВ1аз + 180.) / (60 * 24); 

е]1зе | 

ТМоз = Т + (1рТ1лмейопеТтЕогма&1оп.Вза$ + 


1рТ1мейопе1ТпЕогма*1оп.Рау1191%В1аз + 180.) / (60 * 24); 
ЗВомМеззаае (РакеТ1меТо5Ег (Т) + "\п" + РабеТаиеТобек (ТМо5$)); 


Код аналогичен приведенному ранее. Текущее время определяется функ- 
цией №ом. Далее прибавлением к полученному значению соответствующего 
локального смещения время приводится к стандартному, а прибавлением 180 
стандартное время приводится к московскому. 

В данном примере вместо функции № ом можно было бы воспользоваться 
описанной ранее функцией Се Госа! те. Но тогда бы код заметно усложнился: 

ТбЗузбетТ1те 1рбузсемТ1те; 


СсесЪоса1Т1ме (&1рбузкепшТ1те); 
Т = ЗузбемТ1меТораееТ1ме (1рбузфемТ1ще); 


Для дат и времени, представленных в формате ЕП.ЕЛТМЕ (см. разд. 1.15.1), 
можно для взаимных преобразований локального времени и времени ОТС ис- 
пользовать функции Госа1 Е ПеТ1пеТоЕЦеТ1те и ЕПеТпеТоГ. оса ЕПеТ1 те: 

ВОО Госа1Е11еТ1пеТоЕ11еТ1те (СОМ5Т ЕТЬЕТТМЕ *1рГоса1Е11еТ1те, 

ТРЕТЬЕТТМЕ 1рЕ11еТ+пе); 


ВООТ Е11еТ1теТоГоса1Е11еТ1те (СОМ$Т ЕТЬЕТТМЕ *1рЕ11еТ1пе, 
ТРЕТЬЕТТМЕ 1рГоса1Е11еТ1те); 


Первая из них преобразует локальное время, записанное в структуре 
1рГоса1ЕПеТ!те, во время ОТС в структуре 1рЕ1еТи!те, а вторая осуществляет 
обратное преобразование. В обеих функциях параметры ШрГоса!ЕПеТите 
и 1рЕЦПеТите должны указывать на разные структуры. 

Если исходные дата и время имеются в формате Т)аёеТ!пе, то это значе- 
ние можно сначала преобразовать в формат ЗУЗТЕМТТМЕ функцией Оафе- 
ТипеТоЗуетТ!1те, затем полученный результат преобразовать функцией 
эузбет'ГитетТоЕНеТипе в формат ЕШЕТТМЕ (функции ОжеТипеТоЗузет- 
Типе и ЗуетТипеТоЕПеТ!те описаны в разд. 1.15.1), после чего к результа- 
ту можно применить функции Госа] Е !еТ1пеТтоЕПеТите и ЕЦеТ1теТоГ.оса]- 
ЕПеТипе. Цепочка получается довольно длинная. Так что ее имеет смысл ис- 
пользовать, только если результатом должно быть время ОТС в формате 
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ЕТЕТТМЕ. Например, если в переменной Т типа Т)аёеТ!те записано локаль- 
ное время, и надо получить соответствующее ему время ОТС в формате 
ЕП.ЕТТМЕ (подобный пример вы можете увидеть в разд. 3.6), это можно сде- 
лать следующим кодом: 

РТЬЕТТМЕ Тоса1, ОТС; 

ЗУСТЕМТТМЕ 3%; 

ТАВСЕ ТМТЕСЕВ 11; 

// перевод в формат $5У$УТЕМТТМЕ 

РафеТ1меТобузеетТ1ме (Т, $1); 

// перевод в формат ЕТГЕТТМЕ 

бузсетТ1меТоЕ11еТ1ме (&$%е, &Госа1); 

// перевод во время ИТС 

Тоса1Е11еТ1пеТъТоЕ11еТ1те (&1оса1, &0ТС); 


1.15.3 Измерение отрезков времени 


В процессе разработки приложения иногда требуется зафиксировать ин- 
тервалы времени, чтобы узнать, например, сколько времени занимают вычис- 
ления в каком-то фрагменте вашей программы. Это можно сделать различны- 
ми способами. Простейший вариант — зафиксировать функцией Типе начало 
и конец выполнения измеряемого фрагмента кода: 

ТРафеТ1пе Т1, Т2; 


Т1 = Тше(); 
// фрагмент, время выполнения которого измеряется 


Т2 = Тише (); 

Ап515Ег1па 5; 

РасеТт1меТо$Ег1па ($, "ВР: пп:$5:277", Т2 — Т1); 

Таре11->Саретоп = $5; 

В переменные Т1 и Т2 записываются начальный и конечный моменты вре- 
мени, а затем их разность заносится функцией ВаёеТипеТо&гто в строку Ъ. 
Применена именно эта функция, а не более простая ВаёеТипеТози`, чтобы по- 
лучить результат с точностью до миллисекунд. Если достаточно значение 
с точностью до секунды, то можно, конечно, воспользоваться функцией 
Оэж{еТ!пеТо$` и отобразить результат оператором: 


Таре11->Саре1оп =Т1меТо$ех (Т2 — Т1); 


Для измерения отрезков времени с точностью до миллисекунд можно ис- 
пользовать функцию Се Т1екСопиЕ: 


ь 


РИОВКО СеЕеТт1сКСовп® (УОТо); 


Она возвращает число миллисекунд, прошедших с момента старта У ш- 
ом. Ниже приведен рассмотренный выше пример, реализованный с помо- 
щью этой функции: 

РИОВр ТО, Т; 


ТО = СееТтаскКСочр® (); 
// фрагмент, время выполнения которого измеряется 


Т = СсееТт1скКСоцлпЕ (); 

ТаБе11->Сар®1оп = Т - ТО;; 
В этом примере в метку Габе!1 заносится число миллисекунд, потраченных на 
выполнение фрагмента кода. 

Производить отсчеты времени с высокой точностью можно с помощью 
функций ФицегуРегогтапсеСоикег и ОцегуРег!огтапсеЕгедиепсу: 
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ВООЬ ОцегуРегЕогтапсеСочиптег ( 
ОЧТ ТАВСЕ ТМТЕСЕВ *1рРегЕогиапсеСоцп®); 
ВООЪ ОцегуРегЕогтапсеЕгеачепсу (ООТ ТАВСЕ ТМТЕСЕВ *1рЕгеачепсу); 


Они работают со счетчиком повышенной точности, который, правда, имеется 
не на каждом компьютере. Если такого счетчика нет, функции возвращают 0. 

Функция @иегуРег!огтапсеСоищег фиксирует в переменной типа ГАВК- 
СЕ_ТМТЕСЕВ, на которую указывает параметр 1рРег{огтапсеСоип%, текущее 
значение счетчика. А функция @цегуРегЁ!огтапсеЕгециепсу заносит в пере- 
менную, на которую указывает параметр 1рЕгедоиепсу, частоту счетчика в гер- 
цах, т.е. число увеличений счетчика в секунду. Таким образом, реализация 
рассмотренного выше пример с помощью этих функций может иметь вид: 

ТАКСЕ ТМТЕСЕВ ЕЁ, Соип®0, Соцп®1, АСоппЕ; 

1Е(! ОцегуРегЕогтапсеЕгеачепсу (&Е)) 


{ 
Таре11->СарЕетоп = "Измерение невозможно"; 
хебсаги; 


} 


ОпегуРегЕогтапсеСоипеег (&Сопп®0); 
// фрагмент, время выполнения которого измеряется 


ОцегуРегЕогпапсеСоцпеет (&Соцп 1); 
ЧСочпе.ОпцаЯаРакЕ = Соип®1.ОпцаЯаРаг®е — Соцпе0.ОцааРагк; 
Таре11->СарЕ1оп = АСоцп*.ОцаЯРаг® * 1000 / Е.ОцааРат®; 


В приведенном примере результат измерения отрезка времени выводится 
в метку Габе!1 в миллисекундах. Если в последнем операторе заменить мно- 
житель 1000 множителем 1000000, то результат будет выводиться в микросе- 
кундах. Так что можно измерять очень короткие интервалы времени, недос- 
тупные рассмотренным ранее функциям. | 

Следует отметить, что все рассмотренные методы позволяют достоверно 
измерять не очень маленькие, и не очень большие интервалы времени. Для 
больших интервалов, превышающих квант времени, выделяемый на процесс, 
начинают вмешиваться системные процессы. Если эти процессы связаны 
с фрагментом, длительность которого измеряется, то все нормально. Но в из- 
меряемый интервал вклиниваются и процессы, связанные с переключением 
системы на другие задачи. В этих случаях более достоверно учесть время, по- 
траченное на вычисления именно в данном фрагменте кода, можно функция- 
ми Се РгосезТипе$ и Се ТЬгеаЯТ!те$. Эти функции, подробно рассмотрен- 
ные в разд. 3.Ти 3.8, дают затраты времени данного процесса или данного по- 
тока. Не‹буду повторять описание функций, а сразу приведу вариант их ис- 
пользования все в том же примере: 


__ 10664 Е1]еб1меТо1пе64 (ЕТЬЕТТМЕ РЁ) . 


{ 
тегагп 1п6645011Моа32 (Е.амНлапраееТ1ме, 32) | Е. амЪомраееТ1те; 


ЕТЬЕТТМЕ 1рСгеа1опТ1ме, 1рЕх1еТлме, 1рКегпе1Т1мео, 
1р0зекТзще0, 1рКегпе1Т1те1, 1рОзегТ1ме1; 
СсСесТргеааТттез (бСееСаггепеТИгеаа (), &1рСгеа®1опТ1те, 
&1рЕх1®Т1ме, &1рКегпе1Т1тео, &1рОзегТ1птед0}); 
// Фрагмент, время выполнения которого измеряется 


СесТВгеааАТ1тез$ (бееСоггепТЬгеаа (), &1рСгеае1опТ1аме, 
&1рЕх1ЕТ1ме, &1рКегпе1Т1те1, &1рОзегТ1ме1); 
Таре11->Саре1оп = (Е11е1теТо1пе64 (1рОзегТ1ме1)} - 
Р11е61теТо1пе64 (1р0зегТ1мео)) / 10000; 
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В этом коде введена описанная в разд. 1.15.1 функция ЕИейтеТо!т 64, 
которая преобразует данные типа ЕП.ЕТТМЕ в целое 64-разрядное число. 
Функция ве ТЬгеаЯТ!те$ вызывается до начала выполнения фрагмента, и по- 
сле него. В переменные 1рОз$егТ!ипе0 и 1рО5егТипе1 эта функция заносит вре- 
мя, затраченное потоком в соответствующие моменты на выполнение кода. 
Разность этих времен, выраженная в миллисекундах, передается в метку 
Гафе!1. Передаваемый результат можно было бы делить не на 10000, а на 10. 
Тогда результат отображался бы в микросекундах. 

Если требуется знать полное время с учетом системных затрат, то послед- 
ний оператор надо заменить следующим: 

Таре11->Саре1оп = (Е11еб1меТо1пе64 (1рКегпе1Т1те1) - 

Е1]е1щтеТо1п664 (1рКегпе1Т1те0) + 


Е11е1теТо1пе64 (1рУзегТ1те1) - 
Е11ее1теТо1п%64 (1р0зегТ1ие0)) / 10000; 


При любых измерениях интервалов времени, затрачиваемых на выполне- 
ние фрагмента кода, полезно задать самые высокие приоритеты процессу и по- 
току, в котором данный фрагмент выполняется. Это минимизирует добавку 
к измеряемому интервалу времени затрат на системные процессы. Так что пе- 
ред определением времени начала выполнения фрагмента полезно вставить 
операторы: 

// запоминание приоритетов 

РИОКО Рг1логРгос = СеЕРг1ог1®еуС1аз$ (СсееСиггеп®Ргосез$ ()); 

РИОВО РглогТЬгеаа = сееТЬгеаАРг1ог1 у (СееСоггепеТпгеаа (}); 

// установка высоких приоритетов 


ЗееРг1ог1уС1аз5$ (бСееСиггепЕРгосез$ (), НТСН _РВТОВТТУ СТЪА$5); 
зесТВгеааРх1ог1фу (бСееСиггкепЕТЬгеаа (), ТНВЕАР РЕТОВТТУ ТТМЕ СВТТТСАТ); 


Первые два оператора запоминают текущие значения приоритетов, а сле- 
дующие операторы устанавливают максимальные значения приоритетов. 
Функции, использованные в этом коде, рассмотрены в разд. 3.7 и 3.8. 

После окончания фрагмента и определения времени окончания надо вос- 
становить прежние значения приоритетов операторами: 

// восстановление приоритетов 


ЗееРи1ог1УС1аз$ (СееСиггеп&Ргосез$ (), Рг1огРгкос); 
ЗесТАгеааРг1ог1 фу (бСееСоггепеТЬгеаа (), Рг1логТргеаа); 


1.15.4 Таймеры пользователя 


В данном разделе будет рассмотрена работа с таймерами пользователя. Эти 
таймеру доступны в том потоке, в котором они созданы. В У\У/11949омз имеются 
также таймеры другого типа — таймеры ожидания. Они доступны из любых 
потоков и процессов. Об этих таймерах см. в разд. 3.6. 

Таймер пользователя создается функцией Зе Тег: 


ОТМТ_РТВ МТМАРТ 5ееТ1мег (ТМ НИУМО В\па, ТМ ОТМТ РТВ птрЕхепе, 
ТМ ОТМТ чЕ1арзе, ТМ ТТМЕВРВОС 1рТ1мегГипс); 


Параметр В\У/п4 указывает дескриптор окна, владеющего тем потоком, из 
которого вызывается функция. Это параметр может быть задан равным МОЕ. 
тогда параметр пШЕуеп{ этой функции игнорируется. Если же параметр 
Ь\’п4 задан, то параметр пТОЕуеп определяет произвольный ненулевой иден- 
тификатор таймера. Этот идентификатор далее позволяет отличить один тай- 
мер от другого. 

Параметр и Йарзе задает период срабатывания таймера в миллисекундах. 
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Параметр 1рТипегЕРипс может указывать на функцию обратного вызова 
или равняться МОТ. При значении МОС таймер по истечении заданного от- 
резка времени посылает тому потоку, в котором он был создан, сообщение 
\М_ТТМЕК. Значит, в потоке должна быть организована обработка этого со- 
общения. Если же 1рТипегЕипс указывает функцию обратного вызова, то тай- 
мер вызывает в соответствующий момент эту функцию. Тип этой функции 
в вызове Зе тег должен быть явным образом приведен к типу ЕАВРКОС. 

Функция обратного вызова имеет тип ТТМЕВРВОС: 


УОТР САЬЪВАСК Т1мегРгос (НИМ Випа, отмт УМ59, ОТМТ 1аЕуелпк, 
РМОВР ЯмТлпе); 


Параметр В\мп@ определяет окно, связанное с таймером, параметр иМ$ 
указывает сообщение \УМ_'ИМЕВК. Параметр 14Еуепф является идентификато- 
ром таймера. Параметр 4мТипе указывает число миллисекунд, прошедших 
с момента старта У\У/тЧо\жз. Это та величина, которая может быть получена вы- 
зовом функции @еГ1еКСоцпф. 

Функция Зе Типег возвращает идентификатор таймера. Если параметр 
Б\/пд в ее вызове не равнялся МОТУТ, то этот идентификатор совпадает с за- 
данным параметром пОЕуепф. 

Мы рассмотрели установку таймера. Он будет срабатывать с периодом, за- 
данным параметром иМарзе в вызове функции Зе Г1тег. Если требуется пре- 
рвать работу таймера, следует удалить его функцией КШТ!шег: 


ВООЪ К111Т1мег (НИМО В\Мра, ‘ОТМТ атрЕуепрё); 


Параметр В \/пд указывает окно и должен совпадать с аналогичным пара- 
метром функции Зе ТГ1тег, создавшей этот таймер. Параметр аГШЕуеп& ука- 
зывает идентификатор удаляемого таймера. 

Постройте тестовый пример, если хотите попробовать работать с таймера- 
ми. Пусть его форма будет содержать две кнопки и две метки. Щелчок на пер- 
вой кнопке должен запускать таймер со временем выдержки 5 секунд. Таймер 
должен срабатывать один раз, и по истечении времени выдержки вывести со- 
общение об этом в первую метку. Щелчок на второй кнопке должен запускать 
таймер со временем выдержки 1 секунда. Таймер должен сработать 10 раз, вы- 
водя сообщение об истекшем времени во вторую метку. Реализация подобного 
приложения может иметь вид: 


УОТР САБЬВАСК Т1мег1 (НИМО Буга, ЧУТМТ аМза, ОТМТ лаЕБуепь, 
РИОВО АмТ1ме) 
{ 
1Е(1АБуепЕе == 1) 
{ 
К111Т1мег (Випа, 1аЕуеп®); 
Гоги1->Гаре11->Саре1оп = "Сработал таймер " + 
ТрЕТобег (1аЕуепЕ); 
} 
е]15е 
{ 
Гогм1->Таре12->СарЕ1оп = ++М; 
ТЕ (М == 10) 
{ 
Гоги1->Таре12->Сар&1оп = "работа таймера 2 завершена"; 
К111]1Т`зиекг (Рипа, 1АЕуеп®); 
} 
} 
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Уу01А __Газ®са11 ТРГогм1: : Ви оп1С11сК (ТОБ]есе *5епаег) 


{ 
бееТ1тег (Напа1е, 1, 5000, (ГАВРВОС)Т1птег1); 


у01А _ Еаз®са11 ТКогм1: :Ваббоп2С11сКк (ТОБ)есЕ *5епаег) 


{ 
бееТ1мег (Напа1е, 2, 1000, (ГАВРВОС)Т1пег1); 


} 


Обработчики щелчков на кнопках создают таймеры с идентификаторами 1 
и 2. Для обоих таймеров указана одна функция обратного вызова Титег1. 
В этой функции анализируется идентификатор таймера — параметр 14Еуепё. 
Первый таймер уничтожается функцией КШТ\шег при первом же срабатыва- 
нии — первом обращении к функции Типег1. Второй таймер отсчитыва- 
ет 10 обращений с помощью глобальной переменной М, и уничтожается на де- 
сятом срабатывании. 

Отмечу, что, как вы знаете, в С++Во!Паег имеется компонент Т1тег, кото- 
рый инкапсулирует характеристики таймера АР] У114о\'з. Так что, конечно, 
можно работать с ним, а можно непосредственно использовать описанные 
функции. Что проще — сказать трудно. Мне кажется, что во многих случаях 
все-таки проше непосредственно обращаться к функциям. 

Завершая рассмотрение таймеров, необходимо напомнить об очень мощ- 
ных таймерах ожидания, рассмотренных в разд. 3.6 Конечно, они сложнее 
рассмотренных в данном разделе. Но и возможности их намного шире. 


1.16 Атомы 


Таблица атомов — это хранящаяся в У\/ш@4о\мз таблица строк (имен ато- 
мов) и соответствующих им 16-битных идентификаторов (атомов). Таблицы 
атомов используются во многих технологиях, заложенных в \Иш4о\з. Напри- 
мер, в технологии ОШЕ приложение передает партнеру атом, а тот использует 
его для получения из таблицы атомов соответствующей строки. 

Имеется. глобальная таблица атомов, которая содержит до 31 входов, 
доступных всем приложениям. Приложение, которое определяет свой собст- 
венный формат данных буфера обмена или данных ОПЕ, должно помещать 
имя формата в глобальную таблицу атомов. Это делает формат доступным для 
других приложений и позволяет избежать конфликта с другими идентичными 
именами. 

Приложение может также использовать локальную таблицу атомов. Но 
ее строки доступны только для того приложения, которое эту таблицу создало. 
Целью использования локальной таблицы атомов может быть экономия при 
использовании одинаковых строк в различных структурах программы. Вместо 
того, чтобы копировать строки в каждую структуру, можно поместить их в ло- 
кальную таблицу атомов, а в структуры включать только соответствующие им 
атомы. Таким образом, в памяти будет храниться только один экземпляр каж- 
дой строки. Использование таблицы атомов позволяет также экономить время 
на поиск строки, так как поиск атома осуществляется быстрее поиска строки 
(сравнение атомов — более быстрая операция, чем сравнение строк). 

Локальная таблица атомов, как и глобальная, может по умолчанию содер- 
жать до 37 входов. Однако, в отличие от глобальной таблицы, число входов ло- 
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кальной таблицы можно изменить функцией ШЁёАтфшТаШе. Эта функция 
должна вызываться до того, как началась работа с таблицей. 

Имеется два типа атомов: строковые и целочисленные. Занося в таблицу 
строку с нулевым символом в конце, приложение получает строковый атом в 
виде 16-битного целого числа. Его значение лежит в диапазоне от 0хС000 до 
ОхРЕЕГ. Регистр строк не учитывается. Строки, связанные со строковыми ато- 
мами, не должны превышать 255 байтов. 

Система ведет учет ссылок в глобальной таблице на каждое имя атома. 
При добавлении имени атома число ссылок увеличивается на 1, а при удале- 
нии имени — уменьшается на 1. Если число ссылок стало равно нулю, атом и 
его имя удаляются из таблицы. 

Целочисленный атом отличается от строкового следующими особенностя- 
ми. Значение атома лежит в пределах от 0х0001 до ОхВЕЕГЕ. Строки, соответст- 
вующие целым атомам, имеют формат «#444», т.е. начинаются с символа $#, 
после которого следуют десятичные цифры. Нули, предшествующие знача- 
щим цифрам, игнорируются. Для целочисленных атомов отсутствует учет чис- 
ла ссылок, описанный выше для строковых атомов. 

Создание локального атома осуществляется функцией АЗаА\ю, а созда- 
ние глобального атома — функцией С1оба1 Аа4Афот. Когда атом больше не ну- 
жен, он’должен быть удален функцией ХаееАфот (для локального) или 
функцией С1оъаШеефеАфот (для глобального). 

Поиск атома в таблице по заданному имени осуществляется функциями 
Ета Ают и С1оБа] ЕтЧАфоюот. Получение строки имени, соответствующей задан- 
ному атому, осуществляется функциями Че АфщющтМаше и Софа! Се АфотМате. 

Рассмотрим подробнее все эти функции. Они объявлены в файле илтфазе.П. 
Функция Пи АбютТае: 


ВООТГ ИТМАРТ Тр1ЕАбсомТаЬ1е (ТМ РИОКР п517е); 


задает размер локальной таблицы атомов. По умолчанию в ней может быть 
до 37 входов. Так что если это вас устраивает, то вызывать функцию ш_иАфот- 
ТаЫе не требуется. Но если вы хотите, например, увеличить возможное число 
входов, то надо вызвать эту функцию, передав в нее число входов п%12е. Такой 
вызов должен осуществляться до вызова какой-либо другой функции, работа- 
ющей с таблицей. 

Функции А9ЧаАфюот и С1оБа1 АЗаА ют: 


АТОМ УТМАРТ АЧААЕом (ТМ ЬРСЫТК 1р5ег1па); 
АТОМ ИТМАРТ С1ора1Ададсом (ТМ ГРСЗТВ ]1рбЕг1па); 


добавляют соответственно в локальную или глобальную таблицы строку с име- 
нем атома, на которую указывает параметр 1р5фгшег. Размер строки не должен 
превышать 255 байтов. Строки, различающиеся только регистром, считаются 
идентичными. Если строка имеет формат «#4аа”, то добавляется целочислен- 
ный атом. 

Если атома с указанной строкой в таблице нет, строка добавляется в таб- 
лицу и функция возвращает новый созданный для этой строки атом. Если та- 
кая строка уже есть, возвращается ее атом и строка в таблицу не добавляется. 
Для строкового атома при этом число ссылок увеличивается на 1. Если про- 
изошла ошибка, функции возвращают нуль. Тогда причину ошибки можно оп- 
ределить функцией Се Та$Еггог. 

Для добавления в таблицу целочисленного атома удобно пользоваться в ка- 
честве аргумента функций АЧаА\ющ и Софа] АЧ4А 40 т макросом МАКЕПГМТА- 
ТОМ: | 
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#АеЕ1пе МАКЕТМТАТОМ (1) (ТРТЗТВ) ((0ЪОМС_РТВ) ( (МОВр) (1))) 


В него передается целое число, из которого он формирует строку целочис- 
ленного атома. 
Функции еее Азот и С1оБа еее Афот: 


АТОМ ИТМАРТ ПБе1ебеАЕоп (ТМ АТОМ пАЕом); 
АТОМ ИТМАРТ С1оБа1Ше1ебеАеоп (ТМ АТОМ пАеош); 


удаляют соответственно из локальной или глобальной таблицы атом пАфющ. 
Точнее, для строкового атома уменьшается на 1 число ссылок на него. И толь- 
ко если число ссылок стало равно 0,`атом действительно удаляется из табли- 
цы. Тогда последующие обращения к удаленному атому функций О@ефеАфот, 
Со ДаееАфощ и других приведет к ошибке. В случае успешного выполне- 
ния функции РеаееАфюот и СоБаеееАфот возвращают 0. В противном 
случае они возвращают значение пАфощ. 
Функции ЕиЧАфош и С1оба] ЕЯ Афот: 


АТОМ МТМАРТ Е1паАбом (ТМ ЬРСЗТВ 1р5$Ег1па); 
АТОМ ИТМАРТ С1ора1Е1пЧАКом (ТМ ГРСЗТК 1р5%г1па); 


осуществляют поиск атома с именем, заданным параметром рт. Поиск 
осуществляется соответственно в локальной или глобальной таблице. Если 
атом найден, функции возвращают его значение. В противном случае возвра- 
щается 0. 
° Надо отметить, что хотя при занесении строк в таблицу строки, различаю- 
щиеся регистром, считаются идентичными, функции Еш@Аюшт и 
СЛора Е ЧАфюот ведут поиск с учетом регистра. 

Функции де АютМате и С1оБа1 Се Афот Маше: 

ОТМТ ИТМАРТ СееАсомМаме (ТМ АТОМ пАБош, ООТ ЬРЗТВ 1рВаЕЁЕек, 

ТМ 1пЕ п5127е); 


ОТМТ ИТМАРТ С1оБа1СееАфотМаме (ТМ АТОМ рпАфоп, 
ОЧТ ГРЗТК 1рВаЕЕег, ТМ 1пЕ п512е); 


заносят в буфер 1рВийЁег размера п512е строку, связанную с атомом пАфюш, со- 
ответственно из локальной или глобальной таблицы. Если атом найден, функ- 
ции возвращают число прочитанных символов, не считая заключительного ну- 
левого символа. При ошибке возвращается нуль. 


Рассмотрим простые примеры. Следующие операторы создают в локаль- 
ной таблице два.строковых атома АТ, А2, и целочисленный атом АЗ, соответ- 
ствующий числу 123 

АТОМ А1, А2, АЗ; 

А] = АЗадАеом ("Это строка 1" 


) 
А2 = ААА том ("Это строка 2"); 
АЗ = АаадАеом (МАКЕТМТАТОМ (123)); 


; 


Следующий код определяет, есть ли в таблице атом с именем, указанным в 
окне ЕЯ: 


1Е (Е1паАСом (ЕЗ91{1->Техе.с_$з&к())) 
ЗромМез5асде ("Строка найдена"); 
е] зе. $бпомМеззасде ("Строки нет"); 


Строка будет найдена, если в окне записан текст «Это строка 1», или «Это 
строка 2», или «#1238» (строка целочисленного атома АЗ). Если же записан 
иной текст, в частности, текст «это строка 1» (отличается регистром), появит- 
ся сообщение, что строка не найдена. 
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Следующий код выводит сообщение с текстом строки, связанной с атомом А1: 


СВаг $[256]; 
СесАЕопМапе (А1, $, $12еоЕ(5$)); 
ЗВомМеззаае ($); 


После того, как работа с атомами завершена, они должны быть удалены 
из таблицы операторами: 


Ре] екеАфоп (А1); 
`Ре1есеА®ом(А2); 


См. также пример в разд. 2.3.5. 


Работа с устройствами 


2.1 Компьютер 


2.1.1 Сведения о ВОЗ и видеокарте 


Сведения об устройствах компьютера могут требоваться в ряде случаев. 
Эти сведения нужны, если вы хотите привязать свое приложение к конкретно- 
му компьютеру и далее проверять, на том ли компьютере оно запущено. В этих 
целях обычно используется дата ВТОБ, иногда в сочетании с другими данны- 
ми. Сведения об устройствах могут также требоваться, чтобы установить, мо- 
жет ли приложение работать нормально при данной конфигурации компьюте- 
ра (например, хватит ли для него оперативной памяти), или чтобы настроить 
приложение на работу с данной конфигурацией. 

Сведения об устройствах компьютера в \У/ш4о\мз МТ/2000/МЕ/ХР хранят- 
ся в реестре. Например, сведения о ВОБ материнской платы и о видеокарте 
хранятся в реестре в ключе НКЕ\ (ОСА! МАСНИМЕ \ НАКОМ/АКЕ \ ВЕЗСЮИРТОМ \ 
учет. В этом ключе, в частности, хранятся следующие параметры: 


| о 
| ЗузетВюзВае строка дата ВТОБ 


ЗучетВю5\Уегзюп 


версия В1ОБ 


дата видеокарты 


Тестовый пример, иллюстрирующий чтение подобной информации вы мо- 
жете найти в проекте Р]п] в каталоге Сотр на приложенном к книге диске. 
Окно этого приложения во время выполнения показано на рис. 2.1. На форме 
помещено окно Вас ВЕЧИТ, в которое при щелчке на кнопке ВиЙвйоп1 заносится 
соответствующая информация. | 


Рис. 2.1 вы Информация о компьютере Е. дик | 
Приложение Р!й{ во В — 


‚дата: 10/21/99 
время выполнения Зверсия: А5Ц$ -58582е31 Алаг4 Модцаг В105 ч4.51РЕ 


идентификатор: х86 Рагу 6 Моде! 5 Церрта 2 
производитель: Ццепипеше| 
процессор, совместимый с Репйит, модель 5 версия 1 
‚ ЧПамять 
-3ОЗЧУ: всего 319М [335056896 байт], свободно 61 М [64151552 байт], занято 80% 
Файл подкачки: всего 775 М (812834816 байт). свободно 539 М (565301248 байт] 
‚ 4Адресное пространство: всего 2047 М (2147352576 байт), свободно 2027 М (2125840384 байт} 
` Клавиатура 
Расширенная клавиатура 1ВМ (101 или 102 клавиши]. Число функциональных клавиш - 12 
Имя компьютера 
‚ 1МУСОМРУТЕА 
Имя пользователя 
я 
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Ниже приведены фрагменты кода этого приложения, относящиеся к ин- 
формации о ВТОВ. 


ТВед1зЕгу *гед; 
Апз15Ег1па 5; 
ТбузеемТпЕо 51; 
сваг БоаЕЁ[255]; 
1108 псраг, 1; 


Ро1пеег Р; 


// ВТО5 
В1срЕа11->С1еаг(); 
В1спЕа11->5е1А ее г1Бабез->56у1е = 
В1свЕа1+1->5е1Абсх1робез->5Еу1е<<ЕзВо1а; 
В1срЕа1+1->11пез->Ааа ("ВтТо5"); 
В1свЕа1+1->5е1Абег1Бакез = В1сВЕа11->БеЕАЕЕг1Боакез; 
1Е (СефсУегз1оп() < 0х80000000) 
// И1паоиз МТ 
{ 
гед = пем ТВед1зеку; | 
геч->ВооеКеу = НКЕУ ТОСАГ МАСНТМЕ; 
1Е (гед->ОрепКеу ("НАВОМАВЕ\ \РЕЗСВТРТТОМ\ \бузбет", Еа15е)) 
{ 
В1срЕа1 *1->Г1пез->Ааа ("дата: " + 
геа->Веаа5 Е г1па ("бузЕемВ1о$ПРафе")); 
псраг = гед->ВеаЯВ1пагуЛра*а ("уз ешВ1озУегз1оп", БаЕ, 256) - 1; 
5 ="!"; 
Рог (1=0; 1<=псраг; 1++) 
1Е (БаЕ[1] == 0). 
5=9+т" 1; 
е1зе $ = $ + БаЁ[ 1]; 
В1свЕа1{1->11пез->Ааа ("версия: " + 5); 
} . 
} 
// М1паои$ 9.х 
е15е 


Р = Ролпеег (ОхОЕЕЕЕ5); 
Моте (&Р, &5$[1], 8); 
} 


саесв(...) 

{ 

5 = "ВТО5 недоступен для чтения"; 
В1срЕа1+1->11пез->Ааа ("дата: " + $5); 


} 

‚ИХ Видеокарта 

В1свЕа11->5е1Афег1расез->56у]1е = 
В1снЕЯ1*1->5е1Аеег1рокез->5$у1е<<ЕзВо1а; 

В1свЕа1{1->11пез->Ааа ("Видеокарта"); 

В1срЕа1{1->5е1АбЕг1раеез = В1срЕа1*1->реЕАЕ © г1роафез; 

1Е (СезУегз1оп() < 0х80000000) 

// И1паомз МТ 


{ 
В1свЕа11->1пез->Ааа ("дата: " +гед->Веаа5$®г1па ("У1АеоВ1озПаее")); 


} 
// И!паом$ 9.х 
е15е 
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{ 

$ = ""; 

ху 

{ 
Р = Ролпеег (0х0С0000 + 60); 
Мохе (&Р, &5[1], 255); 


1Е (56 усзрп( $.с_56г(),"/") > 2) 
$ = 5. 5бирбЕх1па (5.Ро$ ("/")-2, 8); 
е1зе 


{ 

Р = Ро1лпеехк (0х0С0000 + 60 + 250); 
Мохе (&Р, &5[1], 255); 

1Е (з6гсзрп("/", 5.с $6:()) > 2) 
"/") -2, 8); 


5 = 5.бар5Ег1па ($.Ро$ ( 

} 

} 
саесьЬ (...) 

{ . 

$ = "ВТО$ недоступен для чтения"; 

} 
В1спЕа11->11пез->Ааа ("дата: " + $5); 


} 


В данном примере предусмотрен вариант, работающий и для У тао\мз 
9.х. Эти версии \У/!ш4о\з не хранят в реестре информацию о ВТОВ. Так что 
приходится пробовать читать ее непосредственно из ВТОВ. Поэтому в самом 
начале с помощью функции Се Уег$1оп (см. разд. 1.2) проверяется версия 
\У/1паомз. Если это МТ/2000/ХР, то чтение информации осуществляется из 
реестра. Особых пояснений этот код вряд ли требует, кроме, может быть, чте- 
ния версии ВТОБ. Параметр эует М оз\Уегзюп имеет тип ВЕС_МОТТГ_ $87 — 
мультистроковый. Это значит, что значение этого параметра может состоять 
из нескольких строк, разделенных нулевыми символами. Завершается значе- 
ние двумя нулевыми символами. Чтение такого параметра методом 
Веа95{гште приводит к генерации исключения. Так что читать его надо мето- 
дом ВеаЯВтагу)аёа, обеспечивающим чтение любых двоичных данных. 
А дальнейшее зависит от того, что вы хотите делать с прочитанным значени- 
ем. В приведенном примере значение переводится в строку с заменой всех ну- 
левых символов пробелами. 

Если версия \Иш94омз 9.х, то делается попытка читать информацию непо- 
средственно из В10з. Но, к сожалению, может оказаться, что чтение символов 
из ВТОБ запрещено. В этом случае при попытке чтения функцией Моуе будет 
сгенерировано исключение. Тогда сработает оператор раздела сафей(...), сооб- 
щающий о невозможности прочитать информацию из ВТОВ. 

Результат выполнения приведенного кода вы можете видеть на рис. 2.1 
в верхней части окна редактирования. 


2.1.2 Процессор 


Сведения о процессоре хранятся в реестре в ключе НКЕУ (ОСА МАСНИМЕ \ 
НАКОМУАЕЕ \ РЕЗСМРТЮМ \ Зумет \ СепнаРгосеззог \ 0. Там имеются парамет- 
ры, характеризующие процессор: 1Чеп ег — идентификатор процессора, 
`Уепдо]4епиЙег — производитель и ряд других. 

Имеется и иная возможность получить информацию о процессоре — функ- 
ция ЧеЗузет По, объявленная в файле Итфазе.й следующим образом: 


УОТР СеббузеемТпЕо (ООТ ГРЗУЗТЕМ ТМЕО 1р5узеетТпЕо); 
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Единственный параметр этой функции указывает на структуру типа 
Тбузеп шо. Рассматривать все поля этой структуры мы не будем. Ограни- 
чимся теми, которые могут пригодиться для решения нашей задачи — получе- 
ния информации о типе процессора. 

Поле 4мМитЬегОЁРгосе$зог$ указывает число процессоров в системе. 
Поле 4мРгосеззогТуре указывает тип процессора. Это поле используется 
в \Мт4омз 9.х. В У/шаомз МТ оно оставлено только для совместимости 
с У19омз 9.х, и рекомендуется вместо него использовать описанные далее 
поля \РгосеззогАгецесфиге, \уРгосеззогГеуе! и мРгосеззогВеу1$510п. Значе- 
ние поля 4мРгосеззогТуре может быть одним из следующих: 


386 _ И _ процессор, совместимый с с с 80386 И о 
486 __ _| Процессор, совместимый с 80486 —____ ____ | 
[586 процессор, совместимый с Репиит 


сель те = = ыы Е ащыиный 


Иные значесия не относятся к персональным компьютерам фе]. 

Поле мРгосеззогАгеВЦесиге указывает архитектуру процессора. Значе- 
ние 0 соответствует архитектуре [те], 1 — архитектуре МТРЪ, 2 — архитекту- 
ре АРГРНА, 3 — иной, неизвестной архитектуре. 

Поле мРгосеззогГеуе] в Ут ао\з 9.х не используется, а в УМшао\з МТ оп- 
ределяет уровень процессора. Его смысл зависит от архитектуры процессора, 
т.е. от значения поля МРгосеззогАгсиЦесфаге. Для архитектуры Пе] значе- 
ние 3 соответствует [пфе] 80386, 4 — 1п4е] 80486, 5 — Репйиш, 6 — Репйат 2 
ит.д. 

Поле мРгосе5зогВеу1$10оп указывает версию процессора. Для 4е| 80386 
и 80486 значения байтов этого поля можно представить как хху7. Если хх = 
ОхЕЕ, то модель определяется как у - ОхА, а версия равна 2. Если хх не равня- 
ется ОхЕЕ, то символ спаг(хх + 11%(`А’)) указывает букву модели, а значение 
у2 — версию. Для Пе! Репйишт, Сумх и М№ех&Сеп 586 старшее слово поля 
\’Ргосез5огКеу1510п определяет модель, а младшее поле — версию. 

Ниже приведен тестовый пример, иллюстрирующий чтение информации 
о процессоре. Это фрагмент проекта Р/п], который вы найдете на приложенном 
к книге диске в каталоге Сотр. Окно этого приложения во время выполнения 
показано на рис. 2.1 в разд. 2.1.1. На форме помещено окно ВаеБЕЗИТ, в кото- 
рое при щелчке на кнопке ВиКоп]1 заносится соответствующая информация. 

ТВеач1зеку *геа; | 

Ап515ег1па 5; 

ТбузбемТтЕо 51; 

срах Ба# [255]; 


1пЕ псрах, 1; 


гед = пем ТВедлузеку; 

гедч->КооеКеу = НКЕУ ТОСАТ МАСНТМЕ; 

В1срЕа11->5е1Аеег1Бибез->56у1е = 
В1срЕа11->5е1АфЕг1роакез$->56у1е<<ЕзВо]1а; 

В1свЕа11->Ь1пе5->АЧа ("Процессор"); 

В1свЕа11->5е1Асег1Бисез$ = К1сьЕа1&1->ПеЕАсег1расез; 

1Е (хеа->ОрепКеу 

("НАВОМАВЕ\ \РЕЗСВТРТТОМ\ \бузЕем\ \СепЕга1Ргосеззог\ \0", Еа15е)) 

{ | 

В1срЕа11->Т1пе5->АЧда ("идентификатор: " + 
гез->Кеаа5 © г1пча ("ТаепЕ1Е1ег")); 
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В1свЕа1 $ 1->11пез->Ааа ("производитель: " + 
гед->Кеаа5Ег1пча ("УепаогТаеп*1ЁЕ1ет")); 

} 

хеч->С]озекКеу (); 

гед->Ргее (); 
СеебузеетТт Ро (&5Т); 

$и16ср (5Т.амРгосеззогТуре) 

{ 

сазе 386: $ = "процессор, совместимый с 80386, "; 

1Е (НТВУТЕ (5Т.мРгосеззогВеу1$1оп) == ОхЕЕ) 
5 = 5+ "модель " + 


ТпеТобехг ( (5Т.мРгосеззогВе\у1$1оп && 0хЕ0) - ОхА) + 
" версия " +сВаг(5Т.иРгосеззогВеу1$1оп && ОхОЕ); 


е15е $ = $ + "версия "+. 


срВаг (НТВУТЕ (5Т.мРгосеззогВе\у1$1оп)} + 1106('А!)) 


ТпЕТобЕг (5Т.мРгосеззогВеу1$1оп && ОхЕЁЕ); 
Бгеак; 
сазе 486: 5 = "процессор, совместимый с 80486, ."; 
1Е (НТВУТЕ (5Т.мРгосеззогВеу1$1оп) == ОхЕР) 
5 = 5+ "модель " + 


- ТреТоЗсг ( (5Т.мРгосеззогВе\у151оп && ОхЕО) - ОхА) + 
" версия " +сВаг(5Т.мРгосеззогКе\у1$1оп && ОхОРЁ); 


е1зе $ = $ + "версия " + 
сраг (НТВУТЕ (5Т.мРгосеззогВеу1$1оп) + 110% ("А") )} 
ТпеТобЕг (5Т.мРгосеззогВе\у1$1оп && ОхЕР); 
Ьгеак; 
сазе 586: $ = "процессор, совместимый с Реп&1ащт, модель " + 
Трое ТобеЕг (НТВУТЕ (5Т.мРгосеззогКеу1$1о0оп)) + 


" версия "+ТпеТобЕг (5Т.мРгосеззогВе\у1$1оп && ОхЕЁ); 


ЮгеаКк; 
ЧеЁац1{ : $ = "Неизвестный процессор"; 


} 
В1срЕа1т1->Ъ1пе$->Ааа (5$); 
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Вряд ли этот код нуждается в комментариях. А результат его выполнения 


вы можете увидеть на рис. 2.1 в средних строчках окна редактирования. 


2.1.3 Память 


Информация о памяти может требоваться, чтобы определить, способно ли 
приложение эффективно выполняться на данном компьютере, и какой объем 
памяти оно может использовать, не мешая другим приложениям. Сведения 
о ресурсах памяти и ее текущем состоянии можно получить с помощью функ- 
ции СоБа]Метогу$афиз, объявленной в файле И7тфазе.й следующим образом: 


УОТР С1оБа1Мемогу5вабаз (ТМ ОЧТ ЬРМЕМОВУЗТАТО$З 1]рВоЕЁЕег); 


Единственный параметр функции является указателем на структуру типа 


ГРМЕМОКУЗТАТОЗ, 


суреаеЕ зегисе _МЕМОВУЗТАТОЗ$ { 
РИОКО АмьепаеВ; 
РМОКО аАмМептогуГоаа; 
512Е Т аАмТова1РВуз; 
512Е Т АмАуа11РПу$; 
512Е Т амТока1РадеЕ11е; 
512Е_ Т АмАуа11РадеЕ11е; 
5Т2Е Т АмТофа1У1гечца1; 
5128 Т ЧмАуа11У1г6па1; 

} МЕМОВУЗТАТО$, *ГРМЕМОВУЗТАТОЗ; 


104 | Глава 2. Работа с устройствами 
Поля этой структуры обозначают следующее: 


4\Гепо{В Размер структуры. Это поле должно быть заполнено до вызо- 
ва функции Софа] Метогу фаз. 


4\МетогуГоаЯ | Процент занятой в данный момент памяти (от 0 до 100). 


4\АуаПУ1г аа! |Свободный объем в байтах текущего адресного пространства. 


Ниже приведен тестовый пример, иллюстрирующий чтение подобной ин- 
формации. Это фрагмент проекта Р/п], который вы найдете на приложенном 
к книге диске в каталоге Сотр. Окно этого приложения во время выполнения 
было показано на рис. 2.1. На форме помещено окно Вас ВЕЧИТ, в которое при 
щелчке на кнопке ВиЙоп1 заносится соответствующая информация. 


ТМепогузфтаеиз$ МешТпРо; 


МепТпЕо.амЪепаеВ = $12еоЕ (МетТптЕо); 
С]1ора]1Метогу5$ аз (&МемТпЕо); | 
В1свЕЗ11->5е1А + г1расез->56у1е = 

| В1срЕа1&1->5бе1АеЕг1рафез->5$у1е<<ЕзВо1а; 
В1срЕа11->Г1пез->Ааа ("Память"); 
В1свЕа11->5е1Аеег1раеез$ = В1срЕа11->РеЕАЕЕг1ракез; 


сВаг $[100]; 

зре1пЕЕ (Е, "ОЗУ: всего %а М (%а байт)," 
" свободно %а М (%а байт), занято %а$%", 
МепТпЕо.АмТо®а1Рпуз$ >> 20, МетТпЕо.амТофка1Ртуз, 
МемТпЕо.ЧмАуа11РРуз >> 20, МетТпЕо.АмАуа11РПуз$, 
МепТпЕо.АмМетогуГоаа); 

В1срЕа1 + 1->11пез->Ааа (+); 


зре1пЕЕ (&,"Файл подкачки: всего %аА М ($а байт)," 
" свободно %$А М ($А байт)", 
МепТпЕо.аАмТоса1РадеЕ11е >> 20, МемТпЕо.амТофа1РадеЕ11е, 
МепТпЕо.АмАуа11РадеЕ11е >> 20, 
МепТпЕо.АмАуа11РадеЕ11е); 

К1свЕа11->11пез->Ааа (+); 


зрг1пЕЁ(,"Адресное пространство: всего %а М (%а байт)," 
" свободно %а М (%а байт)", 
МепТпЕо.АмТо$а1\У1г6оа1 >> 20, МептТпЕо.аАмТоба1\У1г%аа1, 
МепТпЕо.АмАуа11У1геца1 >> 20,МепТпЕо.аАмАуа11\У1г%ча1); 
В1срЕа11->1пез->Ааа ({); | | 


Результат выполнения этого кода, вряд ли нуждающегося в комментари- 
ях, вы можете видеть на рис. 2.1 в нижней части окна редактирования. 
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2.1.4 Клавиатура 


Получить информацию о типе клавиатуры, используемой на компьютере, 
можно функцией де КеуБоагаТуре, объявленной в модуле И’таоишз$ следую- 
щим образом: 


116 бесКеуБоагаТуре (ТМ 1пе пТуреЕ1ад); - 


Параметр пТуре 1ар указывает характер требуемой информации: 0 — тип 
клавиатуры, 1 — подтип клавиатуры, 2 — число функциональных клавиш. 

Возвращаемое функцией значение зависит от заданного значения пТуре- 
Нас. При пТуреЕ1ай = 0 могут возвращаться следующие значения: 


значение |тип клавиатуры функциональ- 
ные клавиши 
клавиатура 1ВМ РС/ХТ (83 клавиши) или со- 
вместимая с ней 


клавиатура ОПуе 1 “ТСО” (102 клавиши) 12 или 18 


клавиатура 1ВМ РС/АТ (84 клавиши) или со- 10 
вместимая с ней 
расширенная клавиатура ВМ (101 или 102 12 
клавиши) 
5 


клавиатура Мока 1050 или совместимая с ней 


клавиатура Мова 9140 или совместимая с ней |24 


т японская клавиатура определяется 
изготовителем 


В последнем столбце приведенной таблицы указано число функциональ- 
ных клавиш, которое может возвращаться при вызове функции Се КеуБо- 
агаТуре с пТуреЕ 1аг = 2. При пТуре Лай = 1 может возвращаться подтип кла- 
виатуры, если он предусмотрен изготовителем. 

Ниже приведен пример получения сведений о клавиатуре. 


Ап$15Ег1па 9; 


5м1ЕсВ (сееКеуБоагаТуре (0) ) 
{ 
сазе 1: $5 = 
"Клавиатура ТВМ РС/ХТ (83 клавиши) или совместимая с ней"; 
Ьгеак; 
сазе 2: $ = 
"Клавиатура О11\%еф+е1 'ТСО' (102 клавиши)"; 
ргеак; 
сазе 3: $ = 
"Клавиатура ТВМ РС/АТ (84 клавиши) или совместимая с ней"; 
ЬгеаКк; 
сазе 4: $ = 
"Расширенная клавиатура ТВМ (101 или 102 клавиши)"; 
Ьгеак; 
сазе 5: $ = 
"Клавиатура Мок1а 1050 или совместимая с ней"; 
Ьгеак; 
сазе 6: $ = 
"Клавиатура МокК1а 9140 или совместимая с ней"; 
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| Ьгеак; 
сазе 7: $ = 
"Японская клавиатура"; 


: = 5 +". Число функциональных клавиш - " + 
ТпеТоЗег (СесКеуБоагаТуре (2)); 
Таре11->Саретопт = $5; 
В действии этот пример представлен в приложении Р/[п] в каталоге Сотр, 
на приложенном к книге диске. Сообщение о клавиатуре вы можете видеть 
в окне, представленном на рис. 2.1. 


2.1.5. Имя компьютера 


Получить имя компьютера, используемое при работе в сети, можно функ- 
цией деСотрщегМате, объявленной в модуле \/114о\з следующим образом: 


ВОО СеСопракегМате (.РТЗТВ 1рВаЕЁЕег, БРОМОВКР п512е); 


Параметр 1рВи#ег указывает буфер, в который будет записано имя компью- 
тера в виде строки с завершающим нулевым символом. Параметр п512е — пере- 
менная, в которой при вызове функции указывается максимальное число симво- 
лов, помещающихся в буфере. Это значение должно быть не меньше МАХ _ 
СОМРОТЕВКМАМЕ ТЕМСТН + 1, где МАХ _СОМРОТЕВМАМЕ_ТГЕМСТН — 
константа, определяющая допустимую длину имени (обычно 15). 

Если функция успешно выполнена, она возвращает фгае, заносит в буфер 
имя компьютера, а в переменную п$12е число символов имени, не считая за- 
вершающего нулевого символа. 

Таким образом, чтение имени компьютера может быть организовано, на- 
пример, следующим образом: 


сваг ВоЕ [МАХ СОМРОТЕВМАМЕ ТЕМСТН]; 
РИОВР з12е = МАХ СОМРОТЕВМАМЕ ЪЕМСТН + 1; 


1Е (СееСомрибегМаме (ВоЁ, &$127е)) 
бРромМеззасще (ВаЕ); 
е15е 5ПомМеззасде ("Ощибка: недостаточный размер буфера - " + 
ТпеТобег ($12е)); 


Впрочем, учитывая изменение значения $17е после первого вызова @еф- 
СотрщегМате, надежнее перед вызовом этой функции задавать явным обра- 
зом необходимое значение з17е. 

Установить новое имя компьютера можно функцией Зе СотрщегМаше: 


ВОО Зе Сотри егМаме (ТМ .РСЗТВ 1рСотриаеегМаме); 


Параметр 1рСошрщегМащше указывает новое имя. Число символов в нем 
не должно превышать значения МАХ _СОМРОТЕВМАМЕ_ТЕМСТН. Имя мо- 
жет содержать символы букв, цифр, а также символы "!", "@", "#", "$", "%", 
а", С," , "-","", "{", "}", "-". Вели в имени встретились не- 
допустимые символы, то при работе в \У/1п4о\мз 95 эти символы заменяются до- 
пустимыми, а при работе в \У/1п4о\5 МТ/2000/ХР функция Зе Сошрщег Мате 
вернет #а1$е. В этом случае последующий вызов функции Се ТГа$& Еггог вернет 
значение ЕККОВ_ТМУАТГТО_РАКАМЕТЕВН. 

Устанавливаемое функцией Зе СотрщегМате новое имя будет восприня- 
то только после перезагрузки системы. Надо также учитывать, что приложе- 
ние, использующее функцию Зе СотршегМате, должно обладать правами 
администратора. | 
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Ниже приведен пример задания имени компьютера, которое пользователь 
записал в окне ЕЧИЛТ: 

1Е (! бе СотрибегМаме (Е91%1->ТехЕ.с_$ег())) 

1Е (СееЬазеЕггог() == ЕВКОК ТМУАГТО РАВАМЕТЕВ) 

ЗПомМеззасе ( 
"Имя не установлено из-за недопустимых символов в имени"); 
е15е 5ПомМеззаде ("Имя не установлено, вероятно, у Вас нет" 
"прав администратора"); 

е15е 5помМеззаде ("Имя будет воспринято после перезагрузки компьютера"); 


2.1.6 Имя пользователя 


Имя пользователя определяется функцией Се ОзегМаше: 
ВООТ СееОзетгМапме (О0Т ГРЗТВ 1рВаЕЁЕег, ТМ ОЧТ ЬРОМОВКР п5$12е); 


Параметр 1рВийЁег указывает буфер, в который будет записано имя поль- 
зователя в виде строки с завершающим нулевым символом. Параметр п$12е — 
переменная, в которой при вызове функции указывается максимальное число 
символов, помещающихся в буфере. 

Если функция успешно выполнена, она возвращает фгие, заносит в буфер 
имя пользователя, а в переменную п512е число символов имени, включая за- 
вершающий нулевой символ. 

Ниже приведен пример получения имени пользователя. 

сваг 1рз2бузбен1тЕо [256]; 

РИОВР ссВВчЕЕ=256; 


СееЧзегМаме (1р52бузбемТпФ о, &сспВиЕЕ); 
ЗромМеззаде (1рз25уземТптЕо); 


В многопоточных приложениях возвращается имя пользователя, владею- 
щего данным потоком. 


2.2 Выключение компьютера и перезагрузка 


2.2.1 Выключение компьютера и перезагрузка системы, 
запрет выключения 


Выключение компьютера или его перезагрузка осуществляется функцией 
Ех и МУ шдо\мз$Ех, объявленной в файле Утизег.й следующим образом: 


ВООТ Ех1М1паомз$Ех (ТМ ОТМТ оЕ1ааз,ТМ ОМОВО аиВезекуеа); 


Параметр 9\ВезегуеЯ не используется, а параметр иЕ1айз может содер- 
жать флаги, управляющие процессом выключения компьютера. Флаг 
ЕУУХ ГОСОЕЕ обеспечивает смену пользователя:. завершение всех процессов 
данного пользователя и переход в окно У/ш4омз смены пользователя. Флаг 
ЕУУХ_ ВЕВООТ обеспечивает перезагрузку У т4о\$, флаг Е\УХ_$НОТРВО\/М — 
выключение компьютера без выключения питания, флаг Е\УХ_РО\ЗУЕВОЕЕ — 
выключение компьютера и питания. Подробнее о флагах функции 
Ехи\У/тдоу5 Ех см. описание этой функции в гл. 8. 

Функция возвращает 0 при успешном окончании вызова и возвращается, 
не дожидаясь окончания выключения системы. 

Приведем пример. Следующий оператор завершает выполнение всех при- 
ложений данного пользователя и осуществляется переход в окно У/ш@4о\з сме- 
ны пользователя: 
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1Е (!Ех1ЕМ1паомзЕх (ЕМХ ГОСОЕЕ, О0)) 
ЗПомМе$засве ("Не удалось сменить пользователя"); 


Смена пользователя — единственный режим, не требующий особых при- 
вилегий. Все остальные режимы не будут выполняться, если приложение не 
имеет соответствующих привилегий. Например, оператор 


1Е (!Ех1ЕМ1паом$Ех (ЕМХ _ВЕВООТ, О0)) 
ЗПомМез$заае ("Не удалось перезагрузить систему"); 


сработает только в \У/ш4о\з$ 95, а в более современных версиях \//т4о\з выдаст 
сообщение, что перезагрузить систему не удалось. Так что прежде, чем выпол- 
нять подобный оператор, приложение должно получить соответствующие при- 
вилегии. Перечисленные далее функции подробно описаны в гл. 8. Так что 
ограничимся перечислением только тех их параметров, которые потребуются 
для решения задач выключения компьютера и перезагрузки системы. 

Прежде, чем устанавливать привилегии, надо получить доступ к привиле- 
гиям данного приложения. Это может быть сделано функцией ОрепРгосе5$- 
ТоКкеп, объявленной в файле И7пфазе.й следующим образом: 


ВООЪ ОрепРгосез$$ТокКеп (ТМ НАМОГЕ Ргосез$Напа1е, 
ТМ ОМОВКО Без1гедАссез5$, ОЧТ РНАМОТЕ ТоКкепНапа]1е); 


Параметр РгосеззНап Ще является дескриптором процесса, к привилегиям 
которого требуется получить доступ. Для текущего процесса этот дескриптор 
можно получить, вызвав функцию Се Сиггеп&Ргосе$$ (см. разд. 3.7). Параметр 
Дезге4Ассе$$ является комбинацией флагов, определяющих права доступа. 
Для нашей задачи выключения или перезагрузки компьютера надо задать флаг 
ТОКЕМ_АРЛО$ЗТ _РВТУПЕСЕ$, обеспечивающий возможность изменения 
привилегий. Имеется также флаг ТОКЕМ_©ОЕКУ, позволяющий описанной 
далее функции Ад} ТокКепРиуПегез получить информацию о предыдущих 
значениях привилегии. 

Параметр ТокепНапЩМе определяет переменную, в которую в результате вы- 
полнения функции будет занесен дескриптор, дающий доступ к привилегиям. 

Получив этот дескриптор, можно определить локальный уникальный 
идентификатор (ГОТО) привилегии с помощью функции ГоокКирРих!ере- 
УаШше, объявленной в файле ИТтфазе.й следующим образом: 


ВООЪ ТоокорРг1\у11едеуа1ае (ТМ .РСЗТВ 1рЗузфепМаме, 
ТМ .РСЗТВ 1рМате, ОЧТ РЬОТО 1рЬо19); 


Параметр 1рэЭузетМаше может указывать имя системы, для которой 
ищутся привилегии. Если это локальная система, то значение этого параметра ` 
можно задать равным МОЕГ.. Параметр 1рМаше указывает строку, определяю- 
щую имя привилегии, определенное в заголовочном файле ИтлпЕ.А. Для на- 
ших целей это строка “БебесогцуРиуПее” или константа ЗЕ_$ЗЕСОВ1- 
ТУ_МАМЕ. Параметр 1рГли 4 — это переменная, в которую возвращается ГОШ 
указанной привилегии. 

Вот теперь можно изменить привилегию с помощью функции А9]а$$- 
ТокепРтуПеге$, объявленной в файле И1п4ошз$.й следующим образом: 

ВОО Аа] а ТокКепРг1\1]1едез (ТМ НАМОТЕ ТоКепНапа1е, 

ТМ ВООТЪ Р15аб1еА11Рг1\у11едез, 
ТМ РТОКЕМ РВТУТЬЕСЕ$ Мембкаке, 
ТМ ОМОВО ВаЕЕегцепафв, 


ОЧТ РТОКЕМ РВТУТЬЕСЕЗ Ргеу1ои$бфафе, 
ОЧТ РРИОВО Вебагпьепаей); 
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Параметр ТокКепНап е — та переменная, которая была задана парамет- 
ром ТоКепНапе в вызове функции ОрепРгосеззТоКеп, и в которую был зане- 
сен дескриптор, дающий доступ к привилегиям. Параметр О1за еАПРимч- 
]еге$ определяет доступность привилегий. При 01а еАПРг1уЦерез = фгие все 
привилегии недоступны. А при 01а /еАПРиуПехез = #а15е новые значения 
привелегий определяются параметром Мем5фафе. 

Параметр М№ем5+ае указывает на структуру типа ТТоКепРихЦере$, кото- 
рая содержит два поля: РУЦерез — массив структур типа Т.ОШАпдАЙнт- 
Без, и РиуПереСоип{ — число элементов в этом массиве. Структуры типа 
ТОГШАпдАИгЬше$ содержат поле [ли@ — идентификатор ГОТО, и АЙм- 
Ъще5 — значение которого может быть сочетанием некоторых флагов. Для на- 
ших задач потребуется флаг ЗЕ РАТУШЕСЕ — привилегия доступна. 

Параметр Ргеу1оп55${ж{е определяет буфер, в который функция загрузит 
прежние значения привилегий, а параметр ВийЙегГепе определяет размер 
этого буфера. Для наших задач вы можете задать Ргеу1ои$5$2е = МОТ, 
и ВиЁЙегГепо4В = 0. В параметр ВеагиГепо{В функция записывает требуе- 
мый размер буфера Ргеуоц; 5$ же. 

Описание процесса получения требуемых привилегий получилось доста- 
точно громоздким. Это естественно, так как мы хотим получить возможность 
выключить компьютер, и, значит, завершить работу всех приложений и всех 
пользователей. Но я считаю, что при получении рецептов выполнения тех или 
иных действий всегда полезно представлять их суть. Поэтому вместо того, что- 
бы просто написать результирующий код, я пояснил все его аспекты. А сам 
код достаточно простой. Ниже приведен обработчик щелчка на кнопке, вы- 
ключающий компьютер: 

у01А _ Еаз6са11 ТЕогп1: : Ва оп1С11сК (ТОр)есе *5бепаег) 


{ 

НАМОТЕ БТокеп; 

_ЪОтТр База; 
ТТокепРг1\11едчез &кКр; 
Сага1па1 ВефагпЪепаЕВ; 


1Е (ОрепРгосеззТокКеп (бесСиггепЕРгосезз (), ТОКЕМ АОШФОЗТ_РВТУТЬЕСЕЗ, 
&ПТокеп) ) 
{ 
ТооКарРг1\11ече\а1ае (МОЪ,. "бе5ВоаомпРт1\11еде", &Гоа1а); 
ЕКр.Рг1\11едез[0].а1а = Ьа1а; | 
сКр.Рг1у11едеСоип*=1; 
сКр.Рг1\11едез [0] .АЕЕг1рифез=5Е _РВТУТЬЕСЕ ЕМАВЬЕО; 
1Е (Аа) о5%ТокКепРг1\11едез (РТокеп, Га1зе, &6кр, 0, МОШЦ, 
(ипз1апеа 1опда*) (Кебагльепа® В) )) 
1Е (!Ех1ЕМ1паомзЕх (ЕМХ ЗНОТРОММ || ЕМХ РОМЕВОЕЕ, О0)) 
ЗВомМеззасвде ("Не удалось ‘выключить компьютер"); 
} 
} 


Все особенности этого кода уже рассмотрены. Если вы хотите не выклю- 
чить компьютер, а перезагрузить систему, надо в приведенном коде изменить 
только вызов функции Ехи УМ точ Ех: 


Ех1И1паом$Ех (ЕМХ_ВЕВООТ, О0) 


Пример перезагрузки системы вы можете посмотреть в разд. 2.2.2. 


. Иногда возникает задача, противоположная рассмотренной — запретить 
выключение компьютера или перезагрузку системы, пока ваше приложение 
выполняется, так как при этом вы можете потерять какие-то невосполнимые 
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данные. Это можно сделать, введя в приложение обработчик сообщения 
\М_ОЧЕВУЕМОЗЕ$ ТОМ. Параметр \“Рагат этого сообщения пока не ис- 
пользуется, а параметр 1Рагат показывает, идет ли речь о завершении работы 
системы (значение 0), или только о завершении сеанса работы текущего поль- 
зователя (значение ЕМОЗЕЗЭТОМ _ТОСОЕЕ). Если обработчик сообщения 
У\М_ОЧОЕВУЕМОЗЕЗ ТОМ возвращает 1, это означает согласие с закрывани- 
ем системы. В Ушдо\жз МТ/2000/ХР в этом случае приложение получает по- 
сле этого сообщение УМ_ЕМРЗЕЗЗТОМ, о котором будет сказано далее. Это 
сообщение означает завершение приложения, независимо от ответов на сооб- 
щение \М_ООЕКУЕМОЗЕ$З ТОМ других приложений. В Утдо\з 95 сначала 
посылаются сообщения \УМ_@ОЕКУЕМОЗЕЗ ОМ всем выполняющимся 
. приложениям, и только если все они вернули 1, тогда приложениям посыла- 
ются сообщения \УМ_ЕМОЗЕЗЗТОМ. 

Если обработчик сообщения УМ_9ОЕКУЕМОЗЕ$ ТОМ вашего приложе- 
ния вернет 0, то приложение не закроется и процесс выключения У/Лт@4о\з 
прервется. Так что обеспечить невозможность выключения \У/ш4о\з до тех 
пор, пока выполняется ваше приложение, можно следующим образом. 
Фрагмент заголовочного файла: 


с]аз$ ТРГогп1 : руЬ11с ТЕРогм 


{ 
ре1уате: // Озегк аес]агаЕ1топз$ 
Уу01А _ ЕазЕса11 ИМОПЕВУЕМОЗЕ$ 5 ТОМ (ТМеззаде & ); 
ис: // Пзег аес1агае1опв 
ВЕСТМ МЕЗЗАСЕ МАР 
МЕЗЗАСЕ НАМОЬЕВ (ИМ ОЧЕВУЕМОЗЕ$ ТОМ, ТМеззаче, ИМОЧЕВУЕМОЗЕ$ ТОМ); 


ЕМР МЕЗЗАСЕ МАР (ТСопропеп®); 


Фрагмент файла реализации: 


\01а _ Еаз®са11 ТРГогм1: : ИМООБВУЕМОЗЕ$ ТОМ (ТМеззаде & Мз9) 
{ 
эромМеззасще ( 
"Нельзя закрывать систему, пока не завершится моя работа"); 
Мза.Вези1е =0; 
} 


Теперь рассмотрим сообщение \УМ_ЕМОЗЕ$ЗЗТОМ. В нем параметр мРа- 
гат равен 1, если система закрывается. В противном случае этот параметр ра- 
вен 0. Если мРагаш = 1, система может закрыться в любой момент, после того, 
как ваше приложение завершит обработку сообщения. Так что перед заверше- 
нием обработки надо выполнить какие-то завершающие действия: сохранить 
данные, убрать «мусор» и т.п. 


2.2.2 Автозапуск приложений 


Некоторые приложения, постоянно работающие в фоновом режиме, целе- 
сообразно запускать автоматически одновременно с У ш@4о\мз. Сведения об ав- 
томатически запускаемых приложениях хранятся в реестре в ключе 
НКЕУ 1ОСАЕ_МАСНИМЕ \ ЗОРТМУ/АЕЕ \ МесгозойЯ \ М/Итдо\из \ СитетУегзюп \ Кип. Ка- 
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ждый параметр этого ключа содержит в качестве имени название программы, 
а в качестве значения — полное имя файла программы. 

Посмотрим, как можно реализовать автозапуск приложения на примере 
содержащегося на диске, приложенном к книге, приложения НоёКеу1 в ката- 
логе Кеубоата. Это приложение, регистрирующее горячие клавиши, подробно 
описано в разд. 2.3.5 Окно приложение показано в том же разделе на рис. 2.6. 
В нижней части этого окна находится индикатор Открывать вместе с \\Итдом$, 
который позволяет управлять автозапуском приложения. Если этот индика- 
тор включить, приложение автоматически будет запускаться при каждой за- 
грузке У/1т4омз. Если выключить индикатор, автозапуск отменится. Рассмот- 
рим коды этого приложения, связанные с организацией автозапуска: 


#1пс1аае <геч15егу.Врр> 


у01Аа __ Газ са11 ТГогм] : : Вик $оп1С11сК (ТОБ]есе *5епаег) 


{ 
ТВедч1$6еку *гед15ег = пем ТКед1зеху; 


гед1 56 х->Коо$Кеу = НКЕУ ТОСАТ МАСНТМЕ; 
геч1зЕг->Орепкау ( 
| "боЕЪмаге\ \М1сгозоЕЕ \ \М1паомз \ \СиггепеУегз1оп\\Вип", Еа1зе); 
1Е (СрескКВох1->СБескеа) 
теа1 $ г->Иг1$ебег1па (Арр11са1оп->Т161е, Рагатбекг(0)); 
е1зе гед1зЕг->ре1ефеУа1че (Арр11са&1оп->Т141е).; 
геа15Ег->Егее (); | 


} 


Функция СВескВох1СИсК является обработчиком щелчка на индикаторе. 
В ней создается временный объект геё1$%г, он соединяется с требуемым клю- 
чом, и в зависимости от того, включен или выключен индикатор, в реестр 
включается или из реестра удаляется параметр, название которого совпадает 
с именем приложения. Значение параметра — полное имя приложения, полу- 
чаемое функцией Рагат5%т(0). 

Отметим одну особенность автозапуска. При автоматическом запуске при- 
ложения текущим является не тот каталог, в котором расположен файл. про- 
граммы, а каталог автозапуска \У/ш4о\з. Иногда это надо учитывать в прило- 
жении. Например, вариант приложения, описанный в разд. 2.3.5, содержит 
оператор 


$Р1]е = СесСаггепЕ)1ах + "\\" + $5Е11е; 


который формирует имя текстового файла, используемого в приложении, из 
этого имени, первоначально запомненного в переменной ЗЕШе, и текущего ка- 
талога, получаемого функцией Се Сиггеп Олт.. Но при автозапуске этот опера- 
тор сформирует ошибочное имя файла. Поэтому в полном варианте приложе- 
ния этот оператор заменен следующим: 


5Е11е = Ехегас®Е11ер1г (Арр11са®1оп->ЕхеМмапе) + "\\" + 5Е11е; 


Вот этот оператор, извлекающий имя каталога из полного имени файла прило- 
жения, будет работать всегда, независимо от того, как было запущено прило- 
жение. 

Имеется еще один вариант автозапуска приложения — однократный за- 
пуск. Он применяется, в частности, в программах установки и иных програм- 
мах, работающих с \!114о0\з, когда требуется перезагрузка системы для того, 
чтобы вступили в силу установленные параметры. После перезагрузки управ- 
ление сразу должно быть передано той же программе. 
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Информация о программе, которая должна быть запущена после очеред- 
ной загрузки \Мш@4о\з, хранится в реестре в ключе НКЕУ (ОСА МАСНМЕ \ 
ЗОЕТУМАЕЕ \ Мсгозой \ УМтаоми$ \ СитетМегзюоп \ КопОпсе. Параметр в этом ключ 
содержит в качестве имени название программы, а в качестве значения — пол- 
ное имя файла программы. 

Указанное в этом ключе приложение будет запущено сразу после очеред- 
ной загрузки У\У/1т4о\мз, до того, как будут запущены все другие автозагружаю- 
щиеся программы. В частности, пользователь не увидит ни полосу задач, ни 
кнопку Пуск, вообще ничего, кроме окна этого приложения. И пока он не про- 
изведет с ним какие-то необходимые действия и не закроет его, он не увидит 
на экране привычного ему рабочего стола. Так что подобное приложение мож- 
но использовать не только в программах установки, но и в различных про- 
граммах запроса пароля. 

После того как приложение будет закрыто, ссылка на него автоматически 
удалится из реестра. Так что все это произойдет только один раз, если, конеч- 
но, приложение перед тем, как завершится, не занесет в реестр новую ссылку. 

Посмотрим, как все это можно оформить. Соответствующий пример име- 
ется на приложенном к книге диске в каталоге Сотр. Это проект РЕхИОпсе, 
имитирующий одну из операций программы установки. Его окно показано 
на рис. 2.2. Предполагается, что, якобы, перед этим проведены какие-то опе- 
рации по установке некоторой программы и пользователю предлагается пере- 
загрузить систему. На рис. 2.2, кроме соответствующей надписи, видна только 
одна кнопка Перезагрузка (ее имя в коде ВиЙоп1). В действительности под ней 
расположена другая кнопка (ВиЙоп2) с надписью ОК. Она станет видна после 
перезагрузки системы. Изменится и текст надписи на форме. 


Рис. 2.2 :; Имитация установки программы с 
Окно программы РЕхКОпсе | —. 
перед перезагрузкой Нажмите кнопку “Перезагрузка”, 


чтобы завершить установку. 
После перезагрузки пояучите 
сообщение. что установка 


Приложение должно как-то знать, запускается ли оно в первый раз, или 
запускается после перезагрузки. Для этого перед перезагрузкой оно создает 
в своем каталоге файл бе ир.даЕ. В настоящем приложении в него можно 
что-то записать, чтобы приложение знало, на какой стадии работы оно нахо- 
дится. Но в данном примере предполагается только одна перезагрузка, так что 
приложение в начале выполнения просто проверяет, есть ли такой файл. 

Ниже приведен код этого демонстрационного приложения: 


#1пс1и4ае <гед1зегу.Врр> 
#1пс10ае <1озЕгеам.В> 


Уу01А _ Еаз®са11 ТРГогм1: :Ваеоп1С11сК (ТОБЗ]есЕ *бепаег) 


{ 
ТВедазЕгу *гед1зЕг = пем ТВедузеку; 
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НАМОТЕ БТокКеп; 

_ЪОТЬ Ъаза; 
ТТоКепРг1\у11едез &кКр; 
Сага1па1 ВебогпЪепаеН; 
ЕТЬЕ *ЁЕ; 


// регистрация в реестре 
гед1з+г->ВооЕКеу = НКЕУ ТОСАЬ МАСНТМЕ; 
гед1зЕг->Орепкеу ( 

"СоЕЕмаге\ \М1сгозоЕЕ \ \М1паом<$ \ \СаггепеУег$1оп\\ВопОпсе", Еа15е); 
геа1 $ г->Иг1бебег1па (Арр11са&1оп->Т1%1е, Рагамбег(0)); 
геч1 Е г->Егее (); 
// создание файла на диске 
Е = Еореп ( (Ех гас®Р11ер1г (Рагам$%г (0)) + "\\5ефор.Чае") .с_5%г(),"м"); 
Ес1озе (Г); 
// перезагрузка компьютера 
1Е (ОрепРгосеззТокКеп (СееСиггеп®Ргосез$$ (), 

ТОКЕМ_АРУОЗТ_РКТУТЬЕСЕЗ, &ПТокеп) } 
{ 
ГоокКирРг1\11еве\Уа11е (МОЪЬ, "безраЕаомпРг1\11еде", &Га1а); 
ЕКр.Рг1\11ечез$[0].а1а = Газа; 
ЕКр.Рг1у1]1едчеСоип®=1; 
ЕКр.Рг1\11едез [0] .Абег1рабез=5Е РВТУТЬЕСЕ ЕМАВТЕО; 
1Е (Аа]азЕТоКкепРг1\у11едаез (ВТокеп, ЕГа15е, &6Кр, 0, МО, 
(1п$1апеа 1опа*) (КебоагпЬепа®П))) 
1Е (!Ех16\М1паомз$Ех (ЕМХ_ВЕВООТ, 0)) 
ЗРомМеззаде ("Не удалось выключить компьютер"); 

} 
} 


У01А __Еаз®са11 ТКГогш1: : ГогиСгеаее (ТОБ]ес® *5епаег) 


{ | 
1Е (2Р11еЕх15%$ (Ехо гас®Е1ер1г (Рагат5% г (0)) + "\\бебсоар.аа®")) 


{ 
Таре11->Сар®1оп = "Установка завершена"; 
Ва $оп1->\У1$151е = Еа1$е; 
Ви оп2->\У1$11е = фгое; 
Ре1ефеР11е (Ехегас®Е11е01т (Рагамбег (0)) + "\\5ебор.Чае"); 
} 
} 


Уу01А _ Еаз®са11 ТРоги1 : :Вибкоп2С11ск (ТОБЗесе *Зепаег) 


{ 
С1о$е (); 


} 


Функция Вивбоп1СПсК — это обработчик щелчка на кнопке Перезагрузка, 
которую вы видите на рис. 2.2. Первые операторы заносят в реестр параметр, 
обеспечивающий однократный автоматический запуск приложения при сле- 
дующей загрузке У/1т4омз. Следующая группа операторов создает файл 
беир.аат, наличие которого говорит программе о том, что она запущена после 
перезагрузки. И последняя группа операторов обеспечивает перезагрузку ком- 
пьютера. Эти операторы подробно рассмотрены в разд. 2.2.1. 

Обработчик ЕогтСгезе, срабатывающий при запуске приложения, прове- 
ряет функцией ЕШеЕх1${$, существует ли файл Зетир.аа1 в каталоге, в котором 
располагается файл приложения. Если существует, значит, приложение запу- 
щено после перезагрузки. Тогда изменяется надпись в метке Гафе]1, делается 
видимой кнопка ВиЙоп2, а файл беир.аат удаляется функцией еее Пе, 
чтобы он не мешал следующему запуску приложения. 

Ну а об обработчике щелчка на кнопке ВиЙопё2 говорить не приходится — 
он просто закрывает приложение. 
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2.3 Клавиатура 


2.3.1 Сведения о переключении клавиш: 
проверка и установка регистра и режима вставки 


Определить состояние клавиш, когда ваше приложение активно, можно, 
как известно, в обработчиках событий ОпКеуромп, ОпКеуОр, в которые пере- 
дается через параметр Кеу — виртуальный код клавиши (см. тему «Уп-аа!| Кеу 
со4ез» во встроенной справке С++Ви!@4ег или «Коды клавиш» в справке [4]). 
Но эти события обладают ограниченными возможностями распознавания кла- 
виш. Например, в их обработчиках можно определить, нажата ли в данный 
момент клавиша тег. Но невозможно узнать, включен ли этой клавишей ре- 
жим вставки или замены символа. 

Более детальные сведения о состоянии. той или иной клавиши дает функ- 
ция СеКеу же. Она объявлена в файле Итизег.Й следующим образом: 


ЗНОВТ сСееКеузфаке (ТМ 1пЕ пУ1геКеу); 


В функцию передается единственный параметр пУш&Кеу — виртуальной код 
клавиши, состояние которой требуется определить. Возвращаемый результат 
содержит в старшем бите 1, если клавиша нажата, и 0, если клавиша отпуще- 
на. Младший бит содержит 1, если соответствующая клавиша переключена, 
и 0 в противном случае. Возможность переключения известна для таких кла- 
виш, как пзен, ЗМ, Мит [юосК, Сарз [осК, Зсгой [оск. Переключенное состояние 
(1 в младшем бите) для клавиш Мот [оск, Сарз юск, Эсго|Й [осК соответствует 
включенному индикатору клавиатуры. Для клавиши |пзей 1 в младшем бите 
соответствует тому состоянию, в котором текстовые редакторы осуществляют 
режим замены символа, а не вставки. 
Например, выражение 


(бесКкКеу5&ате (УК _ТМЗЕВТ) & 1) == 0 


вернет фгие, если установлен режим вставки символа, и вернет Ё#а15$е, если 
установлен режим замены. 
Следующий обработчик выдает сообщение о состоянии клавиши Шшбегё: 


\01А _ Еаз®са11 ТГогт1: : Ви оп1С11сК (ТОр)]есЕ *5бепаег) 


{ 
1Е ( (СесКеуб®аке (УК _ТМУЕВТ) & 1) == 0) 
Таре11->Сар®*1оп = "Замена"; 
е1зе Гаре11->Сар®1оп = "Вставка"; 


} 
Выражение: 
СесКкКеу5еаее (УК_САРТТАЦ) & 1 


вернет фгие, если клавишей Сарз [1осК установлен по умолчанию нижний ре- 
гистр, и вернет #а15е, если установлен верхний регистр. | 

Переключателями могут работать не только указанные выше, но и любые 
другие клавиши. Например, выражение 


(СесКкеубтате('А') & 1) == 0 


будет поочередно изменять возвращаемое значение с фгае на Ё#а1$е и обратно 
после каждого нажатия клавиши с латинской буквой "А". 

Функция СеКеу{2же позволяет различать левые и правые вспомогатель-. 
ные клавиши. Если коды заданы константами УК ЭНТЁЕТ, УК_СОМТВОЕГ, 
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УК_МЕМО, то вернется состояние соответственно клавиш ЗП, С|, А№ независи- 
мо от того, какая из клавиш нажата: левая или правая. Например, выражение 


СеЕКеу5®аее (УК_5НТЕТ) & 0х100 


вернет фгие, если нажата любая из двух клавиш 5ИЁ#. Но виртуальные коды мо- 
гут быть заданы константами УК_ГЗНТЕТ, УК_ТГСОМТВОГ, УК_ТМЕМО, 
позволяющими найти состояние левых клавиш, или константами 
УК_В5НТЕТ, УК_ВСОМТВОГ, УК_ВМЕМО, относящимися к правым клави- 
шам. Причем состояния переключения этих клавиш не зависит друг от друга. 
Например, состояние, выдаваемое для виртуального кода УК_Т.ЗНТЕТ, будет 
переключаться при каждом нажатии левой клавиши ЭВИ\, но не будет изме- 
няться при нажатии правой клавиши 561. Состояние, выдаваемое для вирту- 
ального кода УК_ВЗНТЕТ, будет переключаться при каждом нажатии только 
правой клавиши 304. А состояние, выдаваемое для виртуального кода 
УК_5НТЕТ, будет переключаться при каждом нажатии левой или правой кла- 
виши 961. 

Функция деКеу{ае дает состояние только одной клавиши. Имеются 
также функции деКеубоага {же и Зе Кеубоага$ {е, определенные в фай- 
ле И/тдизег.й следующим образом: 


ВОО бсееКеуроагаафе (О0Т РВУТЕ 1рКеубфаее); 
ВООГ 5е*Кеуроага «афе (1М ГРВУТЕ 1рКеубка%е); 


Функция СеКеубвоага {а е заносит в буфер 1рКеу5{же значения кла- 
виш, соответствующих сразу всем виртуальным кодам. К отдельным элемен- 
там массива 1рКеуз{ же можно иметь доступ с помощью констант виртуаль- 
ных кодов. А функция Зе КеуБоага фа{е заносит состояние буфера в клавиа- 
туру. Например, следующий код: 

\014 __Еазеса11 ТГоги1: : Ви оп1С11сК (ТОБ)ес® *5епаег) 

`ткеуьоагавкаке БыЕ; р 

сСесКкКеуроагаб асе (раЕЁ); 
риЕ [УК САРТТАТЬ] = 1; 
зееКкеубоакА$ Кафе (роЕ); 

} 


устанавливает клавишу Сарз [оскК в верхний регистр. Правда, учтите, что каж- 
дый поток многопоточного приложения и каждое приложение работает как бы 
со своей клавиатурой. И функции Се КеуБоага$ {же и Зе КеуБоага {же ра- 
ботают с этими представлениями клавиатуры. Так что приведенный выше код 
переключит регистр только образа клавиатуры данного потока. И лампочка 
Сарз [осК на клавиатуре при этом не зажжется. 

Регистр можно установлть и иначе: эмуляцией нажатия клавиши Сарз$ 
[осК с помощью функции КеуБ4_еуепф, рассмотренной в разд. 2.3.3. Например, 
следующий код установит верхний регистр: 


\01А _ Еа5Еса11 ТГогм1 : :Ви®оп1С11сК (ТОЮ)ес® *бепаег). 
{ 
1Е ((СеесКеуббасе (УК САРТТАГ) & 1) == 0) 
{ 
кеура_ еуеп® (УК_САРТТАЬ, 0,0,0) ; 
кеуБа_ехуепу (УК_САРТТАЬ, 0, КЕУЕУЕМТЕ КЕУОР, 0); 
} 
} 


Условие в структуре Ё# проверяет, переключена ли клавиша Сарз [осК. 
Если не переключена, то имитируется нажатие и отпускание этой клавиши, 
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что устанавливает по умолчанию верхний регистр. Если изменить условие 
в приведенном коде на следующее: 


1Е ((СбееКеубфафе (УК_САРТТАЬ) & 1) != 0) 


то тот же код будет принудительно устанавливать по умолчанию нижний ре- 
гистр. 

Отличие установки регистра функцией Кеу9_еуепф от рассмотренной ра- 
нее установки функцией Зе КеуБоага $ а&е заключается в том, что функция 
КеубЧ_ еуепё переключает не локальное представление клавиш для данного 
потока, а задает состояние клавиш, воспринимаемое любым приложением. 
Так что рассмотренный вариант переключения регистра приведет к включе- 
нию или выключению соответствующей лампочки на клавиатуре и будет дей- 
ствовать на все приложения. 

На приложенном к книге диске переключение регистра иллюстрируется 
в проекте РСа[ в каталоге Кеубоага (см. разд. 2.3.3). В нем имеется два окна 
В1еВЕаЦ, в одном из которых в обработчике события ОпЕщег записан приве- 
денный выше оператор, устанавливающий верхний регистр, а в другом — опе- 
ратор, устанавливающий нижний регистр. Так что переключение из одного 
окна в другое изменяет регистр по умолчанию. В тех же окнах задаются также 
разные языки: русский и английский — см. об этом в разд. 2.3.4. 


2.3.2 Асинхронный опрос клавиш 


В предыдущем разделе рассматривалось получение текущего состояния 
клавиш. Но иногда требуется узнать, не нажималась ли какая-то клавиша на 
определенном отрезке времени. Например, в приложении могут проводиться 
какие-то длительные вычисления, но вы хотите дать пользователю возмож- 
ность прервать или приостановить их, чтобы посмотреть промежуточные ре- 
зультаты и что-то изменить в настройках. Предположим, пользователь для 
этого должен нажать клавишу с символом ‘©’. 

Но во время вычислений приложение не реагирует на действия пользова- 
теля. Вы можете предусмотреть в процессе вычислений периодический опрос 
клавиши '@’ функцией СеКеу$4же, описанной в предыдущем разделе. Но 
этот опрос сработает, только если именно в момент опроса клавиша окажется 
`’ нажатой. Если же пользователь нажал клавишу между опросами, приложение 
этого не заметит. 

Для решения подобных задач можно использовать функцию Се А5$упс- 
Кеуз{жще, объявленную в файле Утизег.й следующим образом: 


ЗНОВКТ сбесАзупсКеубфаее (ТМ 1пе уКеу); 


Параметр уКеу — виртуальный код клавиши. Задаваемый виртуальный 
код может, в частности, различать левые и правые вспомогательные клавиши 
так же, как описанная в предыдущем разделе функция деКеуЗ$афе. 

Функция деАзупсКеу{а{е возвращает значение, в котором старший 
разряд показывает, нажата ли клавиша в данный момент, а младший разряд 
показывает, нажималась ли она с момента предыдущего вызова ве Азупс- 
Кеу5фж{е. Таким образом, решение поставленной выше задачи может выгля- 
деть следующим образом: 

СесАзупсКеубсафе ('0'); 

<цикл вычислений> 


// оператор опроса: | 
1Е ((СесАзупсКеуб $ аее (108 ('0')) << 1) !=0) 
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С1о5е(); // прерывание вычислений 
<продолжение цикла вычислений> 


Перед началом вычислений функция деАзупсКеу {же вызывается, что- 
бы очистить буфер от возможных предыдущих нажатий клавиши '©`’. Затем 
следуют циклические вычисления, и на каждом цикле выполняется приведен- 
ный выше оператор опроса. Если между опросами пользователь нажимал кла- 
вишу '©', выполнение вычислений прервется. 

Ниже приводится элементарная имитация подобной организации вычис- 
лений, в которой вычисления заменены диалоговым окном: 

сесАзупсКеу< $ аее (116 ('0')); 

мр11е ((сСесАзупсКеубкаее (11% ('0')) << 1)==0) 

{ 


ЗРомМез5ачде ("Если нажмете 0, цикл завершится"); 

} 

Если пользователь в диалоговом окне просто нажимает кнопку ОК, то 
окно будет показываться ему вновь и вновь. Но если он нажмет и отпустит 
клавишу '©”, а затем закроет диалоговое окно, цикл прервется, и приложение 
начнет реагировать на действия пользователя. 


2.3.3 Эмуляция нажатия клавиши 


Эмуляция нажатия клавиши может быть выполнена посылкой соответст- 
вующему окну сообщения \М_СНАКВ. Его первым параметром (мРагат) ука- 
зывается код символа. Второй параметр (ТРагат) содержит дополнительную 
информацию, которая при эмуляции не используется. 

Например, следующий код заносит посимвольно в окно Мето1 строку Ъ, 
выдерживая задержки между посылкой отдельных символов. Подобная ани- 
мация иногда полезна во всяких демонстрационных или обучающих приложе- 
ниях. 


\у01А _ Еаз®са11 ТГогп]1: : Ва оп1С11ск (ТОр]есе *5епаег) 
{ 
Ап$15г1па $; 
$ = "Привет и наилучшие пожелания !!!"; 
Бог (11% 1=1; 1 <= 56г1еп($.с 56г()); 1++) 
{ 
Мемо1->РегЕогм (ММ СНАВ, 1п%($[1]), 0); 
51еер (300); 
} 
} 


Более интересные возможности открывает функция КеуБ9_еуепф, объяв- 
ленная в файле Утизег.й следующим образом: 


УОТР Кеура еуеп® (ТМ ВУТЕ БУК, ТМ ВУТЕ о5сап, 
ТМ РИОВР ЧмЕ1аачз, ТМ ЧУЪОМС РТВ АмЕхегатТпЕо)}; 


Ее первый аргумент БУК задает виртуальный код клавиши. Второй аргу- 
мент определяет так называемый зсап-код. Это аппаратно зависимый код, по- 
лучаемый непосредственно с клавиатуры. Обычно его не имеет смысла исполь- 
зовать в приложениях, так что не будем на нем останавливаться. Третий аргу- 
мент 4мЕ 1а5$ определяет действие: если он 0 — эмулируется нажатие клави- 
ши, если его значение равно КЕУЕУЕМТЕ_КЕУТР (в И1таоиз этой константе 
задается значение 2) — эмулируется отпускание. Четвертый аргумент содер- 
жит развернутую информацию о клавише. Мы его рассматривать не будем. Ре- 
ально для эмуляции работы с клавишами второй и четвертый аргументы мож- 
но всегда задавать равными 0. 
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В разд. 2.3.1 приведен пример применения процедуры КеубБЧ_еуепф для 
переключения регистра по умолчанию. Особенностью процедуры КеуБЧ_еуеп 
является то, что она эмулирует операции с клавишами для окна любого прило- 
жения, которое в данный момент активно, т.е. воспринимает сигналы клавиа- 
туры. Это открывает возможности для управления из вашего приложения дру- 
гим приложением. Вы можете, эмулируя операции с клавишами, выполнять 
любые доступные в этом приложении команды, а результаты выполнения этих 
команд можете переносить через буфер обмена в свое приложение. 

Подобная возможность пригодится вам для решения различных задач. 
Одна из них — создание приложения, автоматически демонстрирующего 
и рекламирующего какую-то созданную вами прекрасную программу. Это 
приложение может демонстрировать на экране различные режимы работы ва- 
шей программы, выполнять различные команды, открывать окна и т.п. Если 
вы снабдите все это какими-то текстовыми пояснениями, да еще дадите музы- 
кальное сопровождение, то впечатление будет неотразимое, и покупатели, 
увидевшие на какой-либо выставке подобную демонстрацию, придут к вам 
толпами. | | 

Другая возможность — создание обучающей системы, демонстрирую- 
щей приемы работы с некоторой программой, в частности, и с С++Во!аекг. 
Пользователь сможет запустить ее и увидеть без всякого вмешательства обу- 
чающего, как надо работать с программой, чтобы добиться того или иного 
эффекта. 

И, наконец, может быть наиболее серьезная задача. Нередко вам надо за- 
пускать из вашего приложения какую-то внешнюю программу, чтобы она вы- 
полнила некоторую работу, результаты которой ваше приложение смогло бы 
использовать. Если эта внешняя программа представлена только исполняе- 
мым модулем, исходные коды которого вам неизвестны и который не поддер- 
живает СОМ, то одна из возможностей обеспечить управление этой програм- 
мой из вашего приложения — имитировать работу пользователя с нею. Дру- 
гой, часто более эффективный способ управления внешней программой, рас- 
смотрен в разд. 5.1. 

На приложенном к книге диске в каталоге Кеуфоага имеется пример 
РСа[с, иллюстрирующий работу с имеющейся на любом компьютере програм- 
мой Калькулятор. На рис. 2.3 представлено это приложение в работе. Внизу ос- 
новное окно приложения. При щелчке на кнопке Выполнить приложение вызы- 
вает программу Колькулятор (слева вверху на рис. 2.3) и начинает ею управ- 
лять. С задержками, равными 1 секунде, проводятся следующие операции. 
Сначала раскрывается меню Вид (этот момент показан на рис. 2.3) и в нем вы- 
бирается раздел Инженерный. Вид калькулятора соответственно меняется. За- 
тем с помощью того же меню калькулятор приводится к обычному виду. После 
этого в калькуляторе выполняется сложение 3 + 1 и получается резуль- 
тат — 4. Затем этот результат переносится в окна редактирования приложе- 
ния, а на вспомогательную форму приложения (окно справа вверху на 
рис. 2.3) переносится изображение калькулятора. Перенос результатов расче- 
та и изображения призван продемонстрировать возможности получения в при- 
ложении результатов, подготовленных управляемой программой. 

Помимо описанных процедур, в приложении реализовано еще особое пове- 
дение окон редактирования ЕЗИ1 и ЕдЕ2. Но это относится к темам разд. 2.3.1 
и 2.3.5, в которых и описаны соответствующие приемы. 
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РУССКИЙ ЗА! ЗАглАВНЫЙ 


Ниже приведен с некоторыми сокращениями код этого приложения. 


#10с1а4е <С11рьга.врр> 
#1пс1о4Ае <ахсёх1$.Прр> 


\01А РгеззКеу (1пе Кеу) 
{ 


Кеуб4_еуеп% (Кеу,0,0,0); 


\у01А Ве1еазеКеу (1п% Кеу) 


При щелчке на "Выполнить" 
откроется программа Калькулятор. ! 

продемонстрируются возможные , 

виды калькулятора и выполнится | 
сложение 3 + 1. Попробуйте также 
работать с окнами я редактирования. р 


3+1=4 о 4 о 
_ Выпо ===] 


| 


английский лийский строчный | 


Рис. 2.3. Приложение РСа[ в работе 


// имитация нажатия клавиши Кеу 


// имитация отпускания клавиши Кеу 


{ 


КеурЯ еуеп+ (Кеу, 0, КЕУЕУЕМТЕ КЕУОР,О0); 


уо1а С11скККеу (10% Кеу) 
{ 


// имитация щелчка на клавише Кеу 


кеура еуепь (Кеу,0,0,0); 


Кеура еуепе (Кеу, 0, КЕУЕУЕМТЕ КЕУОР, 0); 


У01Яа __Еазкса11 ТГоги1: 


: Все ол1 са ск (тОБЗесь *Зепаег). 


Сгарр1с$::ТВ1емар * ВМСору = пем СкарВ1сз::ТВ1®щар; 


// поиск программы 'Калькулятор' 


з 


= 


ИА то Ш ме рта АИ 2 ЗИФ ы - 
НИМ Я = Краван (Иботсл 


/ ь тм у гра Ух = хи’: 
// активизация программы 


а, ‘Каль пУя ятор"); 


К алькулято р’ 
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ЗееГогедагоцпай1паом (Н); 

// если 'Калькулятор' не выполняется 

1тЕ (Н == 0) 

// запуск программы 'Калькулятор' 
зре11Ехесиее (Напа1е, "ореп", "Са1с", МОЪЬ, МОБ, 5И _ВЕЗТОВЕ); 
// задержка 

51еер (1000); 

// щелчок АЛЕ 

С11скККеу (УК _МЕМО); 

51еер (1000); | 

// щелчок стрелкой вправо - в меню "Вид" 
С11сККеу (УК_ВТСНТ); 

51еер (1000); 

// щелчок ЕпЕег - раскрытие меню 

С11сККеу (УК_ВЕТОВМ); 

51еер (1000); 

// щелчок стрелкой вниз - во второй раздел меню 
С11сККеу (УК_РОИМ); 


°51еер (1000); 


// щелчок ЕпЕег - выполнение раздела 
С11сКкКеу (УК_ВЕТОВМ); 

51еер (1000); 

// нажатие А1Е - переход в полосу меню 
РгеззКеу (УК_МЕМО); 

// щелчок клавиши с латинским 'Ш0' и русским 'В' - 
// клавиши быстрого доступа | 
С11скККеу (1106 ('0')); 

// отпускание АЛЕ 

Ве1еазеКеу (УК _МЕМО); 

51еер (1000); 

// щелчок ЕпЕег - выполнение раздела 
С11сккКеу (УК_ВЕТОВМ); 

51еер (1000); 

// щелчок цифры 1 

С11сккКеу (108 ('1')); 

51еер (1000); 

// нажатие 5В1ЕЁЕ 

РхеззКеу (УК _5НТЕТ); 

// щелчок клавиши с цифрой 8 и знаком умножение 
С11сккеу (187); 

// отпускание $5УВ1ЕЕ 

ВКе1еазекКеу (УК _5НТЕТ); 

// щелчок цифры 3 

С11скКкКеу (11% ('3')); 

З1еер (1000); 

// щелчок клавиши с символами '=' и '+' - результат 
С11сККеу (187); 

$1еер (1000); 

// нажатие СЕг1-С - копирование результата 
РгеззКеу (УК_СОМТВОЬ); 

С11сккКеу (1108('С')); 

Ке1еазеКеу (УК_СОМТВОГ); 

51еер (1000); 

// чтение результата 
В1срЕа1*1->РегЕоги (ИМ РАЗТЕ, 0,0); 

// занесение окна в буфер обмена 

РгеззКеу (УК_МЕМО); 

С11скКеу (УК_5МАРЗНОТ); 
Ве1еазекКеу (УК. МЕМО); 

5]1еер (1000); . 

// возврат активности в данное приложение 
Зесгогеагочпа\1птаАом (Напа1е); 

опомМез5засаде ("Программа управления Калькулятором выполнена"); 
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Гогм2->\/13151е = Еа]1зеа; 


ВМСору->Г.оааЕгомС11рроагЯГогта* (СЕ _ВТТМАР, 
С11рроага (}-> сбесАзНапа1е (СЕ_ВТТМАР),0); 
Гоги2->Тмтаде1->Сапуаз->СоруВесе (Вес ( 
(Роги2->С11еп6М1АЕВ-ВМСору->И1аев) / 2, 
(Рогм2->С11епЕНезай&-ЕРГоги2->Ттаде1->Незан®) / 2, 
(Роги2->С11еп6\1А1+ВМСору->И1аев) / 2, 
(Гоги2->С11еп&Не1а1&+ВМСору->Незай*) / 2), 
ВМСору -> Сапуаз, 
Вес® (0,0, ВМСору->И1аЕй, ВМСору->Не1апе)); 
Когт2->5Вом (); 


} 
О 
у01А _ Еа5®са11 ТГогм1:;: : В1свЕЗ11Епеег (ТОБ)есЕ *5епаег) 


{ | 
ТоааКеуроагЯГауочц® ("00000419",КЬЕ АСТТУАТЕ); 
1Е ((СесКеузфафе (УК _САРТТА!) & 1) == О0) 
С11сККеу (УК _САРТТАЦ); 
} 
И | 
\014 __Еаз®са11 ТГоги1: : ВаАсВЕЧлЕ2Епеег (ТОБ)есе *5епаег) 


{ 
ТоааКеуроагАГауоц* ("00000409",КЬЕ АСТТУАТЕ); 


{Е ((Сеекеузкаее (УК_САРТТАЬ) & 1) != 0) 
С11скКеу (УК_САРТТАТ,) ; 
} 


Прокомментируем этот код. Модуль ОИСа[<2 — это вторая форма приложе- 
ния, содержащая компонент Гтабе1, в который заносится изображение из бу- 
фера обмена. 

Теперь рассмотрим основной код. Функция Ргез5Кеу имитирует нажатие 
клавиши с виртуальным кодом Кеу. Клавиша только нажимается и не отпус- 
кается. Функция К@еа5еКеу имитирует отпускание клавиши с виртуальным 
кодом Кеу. А функция СЦПеККеу имитирует щелчок на клавише. Все эти 
функции многократно вызываются из основной функции ВиИЙоп1СЦсК. 

В функции ВиНоп1СПеК сначала находится функцией Еш9\У/т@4о\ Каль- 
кулятор, и его дескриптор заносится в переменную Н. В первом аргументе 
функции Еша\У том записывается класс окна искомого приложения 
"5с1!Са[с”", а во втором — текст заголовка этого окна "Калькулятор" (предпола- 
гается русифицированная версия \У/194о\з). Второй оператор функцией $е- 
РЕогеггопп 9 Ут 9о\ делает окно Калькулятора активным, так что теперь все со- 
общения клавиатуры будут поступать ему. 

Первые операторы выполнят свою задачу, если на компьютере уже запуще- 
на программа Калькулятор. Если же Калькулятор не запущен, то функция Ет9- 
У\М/т9до\ не найдет его и вернет 0. Поэтому следующий оператор проверяет, не 
равна ли нулю переменная Н. Если равна, то функция ЗВе|Ехесще запускает 
Калькулятор. Таким образом, первые операторы обеспечивают, что на компьюте- 
ре не будет запущена лишняя версия Калькулятора. Если уже есть выполняю- 
щийся экземпляр программы, то работа будет проводиться именно с ним. 

Далее начинаются операторы, управляющие калькулятором. Большинст- 
во из них разделены операторами с вызовом функции ЧШеер (см. разд. 3.2), за- 
держивающим выполнение на 1 сек. В данном приложении задержки сдела- 
ны, чтобы пользователь мог не спеша посмотреть весь ход работы. Но надо от- 
метить, что небольшие задержки (конечно, много меньшие секунды) полезно 
делать всегда. Иначе некоторые операции, инициируемые в управляемом при- 
ложении, не успеют выполниться до прихода следующего управляющего воз- 
действия, и при этом возможно появление ошибок. 
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Ну, а остальное, наверное, понятно из детально прокомментированного 
кода. Сначала имитируется щелчок на клавише А!, что перемещает управле- 
ние в полосу главного меню. Затем клавиша со стрелкой вправо смещает 
управление во второе меню, клавиша Епег раскрывает его, стрелка вниз пере- 
мещает указатель на второй раздел, который в калькуляторе соответствует 
виду "Инженерный". Затем следует открытие раздела меню, соответствующее 
виду "Обычный". Для разнообразия это делается иначе: с помощью клавиш 
быстрого доступа А!-В (русская буква). Для этого сначала функцией РгеззКеу 
имитируется нажатие клавиши А|, затем имитируется щелчок на клавише, 
содержащей русский символ “В” и латинский "О”, и после этого функцией 
ВееазеКеу имитируется отпускание А!. Дальнейшие манипуляции с клави- 
шами производятся аналогично. Открывается обычный вид калькулятора 
и проводятся вычисления: определяется, чему равняется 3 + 1. 

Столь замечательный результат хочется перенести в свое приложение. 
Для этого выполняется стандартная операция копирования в буфер обмена 
СИрЬоаг4а, инициируемая горячими клавишами С!-С. Затем с помощью сооб- 
щения \М_РАЗТЕ, посылаемого компоненту ВасВЕЗИТ на главной форме 
приложения, этот результат заносится в окна В1еВЕЗИТ и Вл ВЕЗИ2. 

Заключительные операторы иллюстрируют перенос в ваше приложение 
изображения окна калькулятора. Занесение этого изображения в СПрЬоага 
осуществляется сочетанием клавиш А!-Рип!{ Зсгееп, читающим изображение ак- 
тивного окна. Если использовать просто клавишу Рип! 5сгееп, то в СИрБоагА за- 
несется изображение всего экрана. После занесения изображения в СИрБоага 
активизируется функцией Зе Рогесгоипа\ том данное приложение, изо- 
бражение читается в компонент Ппабе1, расположенный на вспомогательной 
форме Еогт2, и эта форма становится видимой. 


2.3.4 Установка языка 


Для установки языка ввода символов (русский, английский ит.п.) служит 
объявленная в файле штизег.й функция ГоадКеуБоагаГауой{: 


НКЬ ГоааКеуроагаТауой® (ТМ БРСЗТВ риз2КЬТрО, ТМ ОТМТ Е]1ааз); 


Параметр рм$2КТ.ТО указывает раскладку клавиатуры, соответствующую 
тому или иному языку. А параметр Е1а#$ содержит флаги, определяющие, как 
именно должна загружаться указанная раскладка. Для нашей задачи. пред- 
ставляет интерес флаг КГЕ_АСТТУАТЕ, активизирующий указанную рас- 
кладку. Остальные флаги относятся к деталям организации смены раскладки 
в \т4о\з$ и вы можете их посмотреть во встроенной справке. 

- Раскладка в параметре рм$2КТ.ЛЛ задается в виде строки, содержащей код 

языка и код диалекта этого языка. Английский язык соответствует коду 

"00000409", русский — коду "00000419". Остальные коды, если вдруг они вам 
понадобятся, можете посмотреть в справке. 

Таким образом, оператор 


ГоаЧКеубоагаТауоц* ("00000419", К.Е _АСТТУАТЕ); 


устанавливает русский язык, а оператор 
ТоааКеуроагаГауоц* ("00000409", КЕ АСТТУАТЕ); 
устанавливает английский язык. 


На приложенном к книге диске установка языка иллюстрируется в проек- 
те РСа[с (см. разд. 2.3.3). В нем имеется два окна Вас БЕЯЦ, в одном из которых 
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в обработчике события ОпЕщег записан приведенный выше оператор, уста- 
навливающий русский язык, а в другом — оператор, устанавливающий анг- 
лийский язык. Так что переключение из одного окна в другое изменяет язык. 
В тех же окнах задаются “также разные регистры по умолчанию: верхний 
и нижний — см. об этом в разд. 2.3.1. 


2.3.5 Горячие клавиши для неактивного приложения 


Горячие клавиши используются в приложениях для доступа к разделам 
меню и действиям, которые могут быть связаны с любыми инициаторами дей- 
ствий, в частности, с кнопками. Задаются горячие клавиши для действий 
и разделов меню их свойством ЭВог Си. В общем случае для инициализации 
действия вам даже не нужен инициатор в виде кнопки или раздела меню. Дос- 
таточно ввести объект действия с помощью компонента ТАсНоп!1$ или 
ТАсНопМапардег, задать в объекте свойство ЭВогСиф$, написать обработчик со- 
`’ бытия ОпЕхееше и данный обработчик будет выполняться, в какой бы момент 
пользователь не нажал занесенную в ЭВог Си комбинацию горячих клавиш. 

Но все это будет работать только пока ваше приложение активно. Если 
пользователь переключится из вашего приложения в другое, то определенные 
в нем горячие клавиши перестанут действовать. А иногда желательно, чтобы 
пользователь, работая в любом приложении, имел доступ по горячим клави- 
шам к некоторому действию. Например, мог вызвать какое-то приложение, 
вызвать некий справочный файл, открыть базу данных и посмотреть ее содер- 
жимое. О решении именно такой задачи и пойдет речь в данном разделе. Сразу 
оговорюсь, что помимо рассмотренного в данном разделе механизма регистра- 
ции горячих клавиш имеется возможность перехвата событий клавиатуры 
с помощью ловуптек. Этот механизм будет рассмотрен в разд. 4.3. 

Для того чтобы некая комбинация горячих клавиш была доступна из лю- 
бого приложения, ее надо зарегистрировать в системе. Это делается объявлен- 
ной в файле итизег.й функцией АР! У/1т4о\з ВелфегНо{Кеу : 


ВОО МТМАРТ Вед1з$ехНо%еКеу (ТМ НИМР ИМпа, тм 1пЕ аа, 
ТМ ОТМТ ЕзМоа1Е1ет$, 1М МТ ук); 


Параметр В\У/п4 является дескриптором того окна приложения, в котором 
описана реакция на данную комбинацию горячих клавиш. Параметр 14 — иден- 
тификатор данного сочетания горячих клавиш. Подобные идентификаторы 
фиксируются в глобальной или локальной таблицах атомов (см. разд. 1.16). 
Они должен лежать в пределах от 0 до ОхВЕЕЕ. При этом надо обеспечить уни- 
кальность этого идентификатора, чтобы избежать конфликтов с другими прило- 
жениями. В частности, многие РЫ, регистрируют свои идентификаторы. Их 
идентификаторы лежат в более узких пределах: от 0хС000 до ОхЕЕЕЕ. Так что 
если вы зададите идентификатор вне этих пределов, то конфликта с какими-то 
работающими ОШ не будет. Но надежнее вызывать для задания уникального 
идентификатора функцию С1офа1АдЧА ют, о которой будет сказано позднее. 

Параметр ##Мо@1Шег$ указывает комбинацию вспомогательных клавиш. 
Он может включать флаги: | 
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Пусть, например, вы хотите зарегистрировать сочетание горячих клавиш 
А!-СН-Т, по которому пользователь, работая в любой программе У/ш4о\мз, мог 
бы вызвать некоторое действие, описанное в вашем приложении. Это делается 
следующим оператором: 


Вед+зкегНо+Кеу (Напа1е,25,МОР АЬГТ | МОР СОМТВОЬ, 1пе('Т')); 


Здесь для данного сочетания горячих клавиш задан идентификатор 25. 
Можно было бы задать любой другой с учетом указанных ранее ограничений. 

Если в некоторый момент вы хотите снять с регистрации ваше сочетание 
горячих клавиш, надо вызвать функцию ОпгерлегНо{&Кеу: 


ВООГ ИТМАРТ Упгед1з$егНоеКеу (ТМ НИМО БИпа, ТМ 10Е 1а); 


В функцию передается дескриптор окна В\\!пд и идентификатор 14, исполь- 
зованные при регистрации. Если продолжить предыдущий пример, то снятие 
с регистрации должно осуществляться оператором: 


Опгеа1$$егНо%Кеу (Напа1е, 25); 


Теперь рассмотрим, как определить действие, связанное с зарегистриро- 
ванными горячими клавишами. В объявлении класса надо указать обработчик 
сообщения \М_НОТКЕУ: 


с1азз ТГогм1 : роаБ]11с ТЁЕРогм 


{ 


рг1уаее: // ПОзег аес1ага®1Топ$ 
у01А _ Еазса11 ИМНоеКеу (ТИМНоеКеу&); 


рар]11с: // 0Озег аАес]1агаЕ1опз$ 
__Еа$&са11 ТКогм1 (ТСотропепе* Омпег); 


ВЕСТМ МЕЗЗАСЕ МАР 

МЕЗЗАСЕ _НАМОТЕВ (ИМ _НОТКЕУ, ТИМНо%Кеу, ИМНо%Кеу); 
ЕМР МЕЗЗАСЕ _МАР (ТСотропеп®); 
}; 


Параметр обработчика (в приведенном далее примере он назван а) имеет 
тип Т\МНо{Кеу. Это структура, в которой поле НойКеу указывает идентифи- 
катор зарегистрированных горячих клавиш. 

Пусть, например, вы хотите, чтобы при нажатии пользователем соответст- 
вующих клавиш открывалось окно, в метке которого отображались бы теку- 
щая дата и время. Тогда вам надо включить в свое приложение вторую форму, 
разместить на ней метку Габе!1, установив ее свойство Ашо512е в #а]15е, задав 
соответствующий размер, чтобы уместились 3 строки, и написать в основном 
модуле приложения следующий обработчик: 


\01А _ Еаз&са11 ТЕогм1 : : ММНоЕКеу (ТИМНО®Кеу& а) 
{ 
Ап$156гапа 5; 
1Е (а.Но&Кеу==25) 
[. 
РафеТ1меТъТобег1па ($, 
"Сегодня Аааа\па ппим ууу года\пбВ часов пм минут", 
Мом ()); 


Гогм2->Таре11->Сар®1опт = $5; 

Когм2->\/1$16]е = Егие; 

бееИ1паомРо$ (Гоги2->Напа1е, НИМР_ТОРМОЗТ, 0, 0, 0, 0, 
5ИР_МОМОУЕ + $МР_МОЗТаЕ); 
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Условие в структуре проверяет по значению поля Но{Кеу, тот ли иден- 
тификатор имеет сообщение (в приведенном выше примере вы зарегистрирова- 
ли горячие клавиши с идентификатором 25). Далее формируется функцией 
ОжмеТ!теТо{гше и заносится в метку формы Еогт2 текст вида: 

Сегодня среда 


10 Май 2006 года 
10 часов 36 минут 


Теперь надо сделать форму видимой. Если бы речь шла о том, чтобы пока- 
зать окно пользователю, работающему с данным приложением, хватило бы 
оператора 


Коги2->\У15161е = Егие; 


Но если данное приложение свернуто, а пользователь в этот момент рабо- 
тает с другим приложением, например, с У№ога, то он ничего не увидит. Так 
что надо позаботиться, чтобы окно разместилось поверх всех иных окон. 
В приведенном коде это сделано функцией Зе \Ут@домРоз: 

ВОО ЗеЕ\1паомРоз$ (ТМ НММО Б\па, ТМ НИМО РипаТозек Е АЕсет, 


ТМ 1пЕ Х,1М 10 У,ТМ 116 сх,ТМ 1106 су, 
ТМ ОТМТ оЕ1ад5$); 


Параметр В\У/п4 указывает дескриптор отображаемого окна. Параметр В\/п9- 
пбег{ АЁег определяет положение окна в Й-последовательности: 


Ве 


Н\УМО_ВОТТоМ 
Н\МО_ МОТОРМО$Т 


внизу (перекрывается другими окнами) 


выше всех окон, не имеющих статуса «поверх дру- 
гих», но ниже окон, имеющих этот статус; работает, — 
только если окно в данный момент имеет статус «по- | 
верх остальных» 


Н\УМО_ ТОР — на вершине /-последовательности (перекрывает все 
прочие окна); работает только для активного окна 


Н\МО_ТОРМОЗТ то же, что Н\УМО_ МОТОРМОЗТ, но работает даже 
для неактивного окна 


Параметры Х, У, сх, су указывают соответственно координаты левого 
верхнего угла, ширину и длину окна. Но эти параметры не учитываются при 
соответствующих флагах, включенных в параметр иЕ1а5$. Параметр иЕ1а5$ 
является комбинацией различных флагов, в частности, З\УР_МОМОУЕ — не 
сдвигать (игнорировать параметры Х и У), ЗЭМР_МОЗТАЕ — не изменять раз- 
меров (игнорировать параметры сх и су) и ряда других. 

В приведенном примере использован параметр Н\МО_ ТОРМОЗТ и флаги 
З\УР_МОМОУХЕ и 5\Р_МОЗТИЕ. Это обеспечивает отображение окна, даже 
если приложение свернуто, поверх других окон. 

Описанное приложение вы найдете на приложенном к книге диске в ката- 
логе Кеубоатга в примере РНоЁКеу. Приложение чисто демонстрационное. Его 
основное окно (рис. 2.4 а) имеет кнопку, по которой проводится регистрация 
горячих клавиш, и кнопку, снимающую регистрацию. В них используются 
описанные ранее операторы, связанные с регистрацией. Так что подобное при- 
ложение вы легко можете сделать сами. Если запустить это приложение, на- 
жать кнопку регистрации и свернуть приложение, то, работая с любой про- 
граммой \!11п4о\з, вы в любой момент можете нажать клавиши СН|-А!-Т и уви- 
деть окно с датой и временем (рис. 2.4 6). 


126 Глава 2. Работа с устройствами 


: Регистрация горячих ‚клавиш С БА 


Сегодня среда 
10 Май 2006 года 
10 часов 36 минут 


Рис. 2.4. Приложение РНсо{Кеу: основное окно (а) и окно с сообщением о текущем 
времени (6) 


Теперь рассмотрим более сложное приложение, которое вы найдете на дис- 
ке в каталоге Кеубоата в проекте Но{Кеу и главное окно которого показано на 
рис. 2.5. Оно позволяет пользователю зарегистрировать различные комбина- 
ции горячих клавиш, связанные с вызовом указанных им программ или с от- 
крытием указанных им документов. Эти горячие клавиши пользователь мо- 
жет использовать при работе с любыми программами \У!ш@о\мз. Настройки 
пользователя сохраняются в файле и автоматически загружаются при следую- 
щем запуске приложения. 


Рис. 2.5 Аз список горячих клавиш” 1 
Главное окно приложения Но{Кеу 


РАНЕГР\АСВБ_1\СВАЦ561.НИР 
Сас 


Программа, документ 


О ео Нм. | 
Изменить | 
Горячие клавищи 


Удалить | [Сы + А+ С 


Детали этого приложения, не связанные непосредственно с заданием горя- 
чих клавиш, вы можете посмотреть в примере на диске. А ниже рассмотрим 
только отдельные фрагменты кода. 

Главное окно приложения содержит список 11$ Вох], в который загруже- 
ны названия программ и документов, вызываемых горячими клавишами. 
Другой список 11$ Вох2 содержит текстовое отображение соответствующих 
комбинаций горячих клавиш. В объектах, привязанных к строкам списка, 
хранятся целые числа, содержащие заданные горячие клавиши. Список сде- 
лан недоступным, чтобы пользователь мог перемещаться только по первому 
списку. 

На форме расположено также окно редактирования ЕЯЩ1, в котором поль- 
зователь может задавать или изменять имя файла программы или документа. 
Рядом с ним размещена кнопка Найти, позволяющая занести в окно имя фай- 
ла, выбранное пользователем в стандартном диалоге У\У/1194о\з. Ниже окна 
ЕЗ1 помещен компонент Но*Кеу1, в котором пользователь может ввести или 
изменить комбинацию горячих клавипт. В свойстве Мо4Шег$ этого компонен- 
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та включены значения №КСЬ] и ВКАЦ, что задает клавиши СШ и А! как вспо- 
могательные клавиши по умолчанию. 

Помимо главного окна приложение содержит второе окно, аналогичное 
рассмотренному в первом примере (рис. 2.4 6). Оно сделано просто для того, 
чтобы продемонстрировать отображение окна по горячим клавишам. 

В обработчике события ОпСгеа4е формы списки 11$ Вох1 и 11$4Вох2 за- 
гружаются данными, хранящимися в текстовом файле НоЁКеу.аа+, располо- 
женном в том каталоге, из которого запускается приложение. Обработчик 
в несколько сокращенном виде выглядит следующим образом: 


ЕТЬЕ *Е; 
Ап$15Ск1па $5Е11е = "Носкеу.аа®"; 


014 _ Еаз®са11 ТКГоги1: : ЕогмСгеафе (ТОр)есе *5епаег) 
{ 
сраг $[100]; 
// к имени файла надо добавить текущий каталог, так как при вызове 
// Орепр1а1оч каталог может измениться, и если имя файла без пути, 
// то файл будет формироваться в другом каталоге 
$Е11е = СееСиггеп®0О1к() +"\\"+ 5Е1]1е; 
Е = Еореп (5Е11е.с _з&г(),"кё"); 


1Е (! Е11еЕх156$ (5Е11]е) )} 
{ 
// Создание файла, если его не было ранее 
РГ = Гореп(5Е11е.с $%кЕ(),"ме"); 
ЕрутпЕЕ (Е,"Время\п"); 
ЕретпЕЕ (Е, "Сёх1+А1+Т\п"); 
Ес1о5е (ЕЁ); 
} 


Е = Еореп (5Е11е.с $з6г(),"гё"); 
Т15ЕВох1->С1еах(); 
.1$ЕВох2->С]еаг(); 
ий11е (!ЕеоЕ (Г) ) 
{ 
1Е(! Еаее$ (5, 99,Е)) Бкеак; 
$ [5х] еп (5$)-1] = 0; 
Ь1$ЕВох1->1Еемз->Ааа (5); 
Еаефкз (5, 99,Е); 
5 [56х1еп (5)-1] = 0; 
Вед (115ЕВох2->Г%епз->Ааа (5)); 
} 
Ес1о5е (Е); 
.1$&Вох1->тЕепш1раех = 0; 
.1$5ЕВох1С11сКк (Т1$%Вох1); 
} 


В начале обработчика в переменной ЭЕШе формируется полное имя файла 
добавлением к нему текущего каталога (возвращается функцией Се{Сиггеп{- 
О!:). Затем, если файла нет, то он создается, и в него заносится строка "Вре- 
мя” и строка "С4:1+АЦК-Т” — название и горячие клавиши первого раздела _ 
списка. После этого файл закрывается. Затем он, или тот файл, который суще- 
ствовал ранее на диске, открывается, и строки из него записываются в списки 
1.15 Вох]1 и [1$&Вох2. При этом в цикле вызывается приведенная ниже проце- 
дура Вех, в которую передается текущий индекс элементов списков Шдех. 


Уо1 ТЕГогм1: :Вед (11% Тплаех) 


{ 
Ап5156г1па оНоекКеу; 
МИога абом, ЕзМоа1Е1егз, УК; 
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ЗНоеКеу = 1Г1$%Вох2->Т{&етмз->5Ег1паз [Тпаех]; 
асом = С1ора1Ааалфом (Т15ЕВох1-> 
Теетз->5&г1па$ [1п4ех] .с_$56г()); 


Г15ЕВох2->Т$епз->0ОЮ)есез [Тпаех] = (ТОБ)есе *)абом; 

Е$Моа1Е1етз = 0; 

1Е (5Ехэбг (5НоеКеу.с з6г(), "А1%") > 0) 
ЕзМоа1ЁЕ1егз = ЕзМоа1Е1егз | МОР АПТ; 

1Е (56 хз6г (5НоеКеу.с_$6г(),"СЕгт") > 0) 
Е5Моа1ЁЕ1ег5 = Е5Моа1Е1егз | МОР СОМТВОГ; 

1Е (56гзег (бНоЕКеу. с _56г(), "5р1Ее") > 0) 


ЕзМоа1Е1егз = ЕзМоа1Е1егз | МОР $НТЕТ; 
УК = 1106 (5Но%Кеу [56 г1еп (5НоеКеу.с_5%г())]); 
// задание кодов Е1 - ЕЭ 
1Е (5НосКеу [5 г1еп (5НоЕКеу.с_з%х())-1] == 'Е') 
УК = УК + 63; 
// задание кодов Е10 - Е12 
е1з5е 1Е (5Но%еКеу [5$ г1еп (5НоЕКеу.с_з%г())-2] == 'Е') 
УК = %К + 73; 
Кеч156егНо%&Кеу (НапЯа1е, абом, Е5Моа1ЁЕ1етз, УК); 
} 


Первый оператор этой процедуры читает в переменную 5Но{Кеу строко- 
вое отображение комбинации горячих клавиш из списка 1/1$Вох2. Второй 
оператор заносит в переменную авот уникальный идентификатор, возвращае- 
мый функцией С1оБа1 АЧЧАфот. Единственный параметр этой функции — 
строка глобального списка атомов. Если аналогичной строки в списке нет, она 
туда занесется, с ней будет связан уникальный идентификатор — атом, кото- 
рый и вернет функция С1оБа1 АЧ4А фот. Если такая строка в списке уже есть, 
функция вернет соответствующий ей атом и увеличит на 1 число ссылок на эту 
строку. В дальнейшем строка будет вычеркнута из списка только после того, 
как число ссылок на нее станет равно 0. 

Третий оператор процедуры заносит атом в объект, связанный с соответствую- 
щей строкой списка 11$ Вох2. Последующие операторы формируют в резуль- 
тате анализа строки ЭНо{Кеу флаги ##МодШег$ и виртуальный код клавиши 
УК, которые были описаны ранее и которые будут переданы в вызов функции 
Вег1$4егНо{Кеу. Наличие в строке модификаторов “А”, "С4г|" и "ЗЫЁ” оп- 
ределяется функцией $&5$й‘, которая возвращает положительное значение, 
если соответствующая подстрока найдена в строке. Наличие в строке обозначе- 
ний клавиш Ё1-Г9 определяется по равенству символу “Е” предпоследнего 
символа строки. А наличие в строке обозначений клавиш [10-112 определяет- 
ся по равенству символу "Е" третьего с конца символа строки. В обоих случаях 
происходит соответствующий сдвиг значения УК, определенного ранее по вир- 
туальному коду последнего символа строки. 

В заключение процедуры комбинация горячих клавиш регистрируется 
функцией ВезлзегНо{Кеу. | 

Выполнение действий, связанных с той или иной комбинацией горячих 
клавиш, осуществляется обработчиком сообщения \УМ_НОТКЕУ, объявление 
которого не отличается от предыдущего примера, а реализация имеет вид: 


Уу0о1А _ Еаз®са11 ТГогм1:;: : ИМНо%Кеу (ТИМНо®Кеу ва) 
{ 
Ап$15ег1па 9; 
Еог (Мога 1=0; 1 <1156Вох2->СойпЕ;1++ ) 
1Е ((Мога) (.15&Вох2->Теет$->0Б]есе$[1]) == а.Но%кКеу) 
{ 
1Е (.1$56Вох1->Гем$->56г1п95[1] == "Время") 
{ 
РасеТт1теТъто$г1па (5, 
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"Сегодня АЧаа\па пипм ууу года\пВВ часов пм минут", 
Мом ()); 

Коги2->Таре11->Сарё1оп = $5; 

Когт2->\/1$161е = Егае; | 

беЕ\1паомРо$ (Еогм2->НапЯ1е, НИМО ТОРМОЗТ, 0, 0, 0, 0, 
$ИР_МОМО\УЕ + ЗМР_МОЗТ2Е); | 


} 
е]зе $е11Ехесиаее (Напа1е, МОЪЬ, 11$5%Вох1->ТЕеп$-> 
ЗЕг1паз[1].с_з6х(),МОЬЬ, МОГ, $М ВЕЗТОВЕ); 


} 


Здесь в цикле ищется в объектах списка 1:15 Вох2 идентификатор горячих 
клавиш а.Но&Кеу. Если найденный идентификатор соответствует строке "Вре- 
мя” в списке 115&Вох1, то так же, как в предыдущем примере, пользователю 
отображается окно с датой и временем. Если же строка иная, то она восприни- 
мается как имя файла, передаваемое в функцию ЭВе|Ехесще. Функция вы- 
зывает указанную программу или программу, связанную с ‘указанным фай- 
лом. Чтобы можно было использовать функцию ЭВеПЕхесще, к приложению 
директивой шеш4е подключен модуль ойеПАРГ. 

Остальные процедуры примера выполняют вспомогательные технические 
функции. Обработчик щелчка на окне списка 11$ Вох1 имеет вид: 


Еа1*1->Тех® = 11$6Вох1->Т%епз->5&г1па$ [11$ЕВох1->Т+ешТпаех]; 
Но%Кеу1->Но<Кеу = ТехеТозвогеСие ( 

Т15ЕВох2->Т$етз->56ег1па$ [Ъ15$ЕВох1->ТЕемТпаех]); 
.1$ЕВох2->Т$еещТпаех = 115$%Вох1->ТЕешГ!Гпаех; 


Первый оператор этого обработчика заносит в окно ЕЯ 1 выбранную поль- 
зователем строку списка 11$ Вох1, чтобы ее можно было исправить. Второй 
оператор заносит в окно НоёКеу1 преобразованное из строки списка 11$ Вох2 
функцией Тех ГоЗвог(Сий сочетание горячих клавиш, которое пользователь 
может далее изменять. Последний оператор синхронизирует списки 11$ Вох1 
и 11$Вох2. 

Щелчок на кнопке Добавить вносит в списки и регистрирует новую строку 
и соответствующие горячие клавиши. Обработчик щелчка имеет вид: 


у01А _ Еаз®са11 ТРГогт1::ВАЯАЯС11ск (ТОБ]есе *бепаек) 
{ 
Ап515Еглпа оНоеКеу; 
1Е (НоеКеу1->Но&Кеу == 0) 
{ 
ЗПомМеззасде ("Вы не задали комбинацию горячих клавиш"); 
ех1е (0); 
} 
5Но&Кеу = пог СаеТоТехе (НоеКеу1->Но&Кеу); 
1Е (115ЕВох2->Т$бетз->ТпаехоЕ (5НоеКеу) != -1) 
5ромМе$засде ("Заданная комбинация горячих клавиш" 
" уже зарегистрирована"); , 
е1зе 1Е (115ЕВох1->Т6емз->ТпаехоЕ (Еа1*1->Техе) != -1) 
ЗПомМе$з5асде ("Для этого действия комбинация горячих " 
"клавиш уже зарегистрирована"); 
е1зе 
{ . 
.1$ЕВох1->Т6емз->Ааа (Еа1{1->Тех®); 
Вед (115ЕВох2->Тфемз->Ааа (5ПпогеСоЕТоТех® (Но&Кеу1->Но%Кеу) )); 
} | 
} 


Первые операторы проверяют, заданы ли горячие клавиши, являются ли 
они уникальными и не заданы ли уже горячие клавиши для той же строки. 
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Две последние проверки осуществляются методом Шш@4ехОФ, возвращаю- 
щим —1, если соответствующей строки не имеется в списке. Предпоследний 
оператор обработчика заносит новую строку в список 11$Вох], а последний 
оператор заносит строку горячих клавиш в список 11$ Вох? и одновременно 
вызывает описанную ранее функцию Вей. 

Щелчок на кнопке Удалить удаляет из списков и снимает с регистрации те- 
кущую строку списков. Обработчик щелчка имеет вид: 

Опгед15сегНо%Кеу (Напа1е, 

(Йога) (.1$ЕВох2->ТЕепз->05]есе$ [11$%Вох1->Т+епТпаех])); 


.1$ЕВох2->Т%емз5->Пе1есе (Т115&Вох1->Т{емТпаех); 
.1$ЕВох1->ТЕемз->ре]1еке (11$ЕВох1->ТЕешТпаех); 


Первый оператор снимает с регистрации соответствующее сочетание горя- 
чих клавиш, а следующие операторы удаляют строки из списков. | 


При завершении работы приложения срабатывает процедура Еогт(С]ове: 


Уу01А __ЕазЕса11 ТГоги1: : ГогаСТозе (ТОБ]есЕ *5беп4ег, ТС1озеАсЕ1оп &Асе1оп) 


{ 

Е=Еореп ($Е11е.с_ 6х (),"ме"); 

Еог (МохЯ 1=0; 1<1.1$ЕВох1->СоцпЕ ;1++) 

{ 
Опгед1зсегНоеКеу (Напа]1е, (Мога) (Т115ЕВох2->Ткетз->0ОБ]есе$[1])); 
Ерг1пЕЕЁ (Е, "%5\п", 115ЕВох1->Т6Еем$->56г1паз[1]); 
Еру1тп ЕЕ (Е, "%5\п", 115ЕВох2->ТЕет$->56г1паз[1]); 


} 
Ес1озе (Е); 


} 


В этой процедуре строки списков заносятся в текстовый файл, хранящий- 
ся на диске, и одновременно функцией ОпКег1${егНо(Кеу горячие клавиши 
снимаются с регистрации так же, как в приведенном выше обработчике щелч- 
ка на кнопке Удалить. 

Остальные операторы примера особого интереса не представляют. Вы мо- 
жете посмотреть их на приложенном к книге диске. 


В целом, рассмотренный пример является довольно удобным приложени- 
ем. Так что его имеет смысл доработать. Дело в том, что в нем для большей на- 
глядности не реализовано свойство, которое очень желательно в подобных 
приложениях. Приложение, постоянно работающее на компьютере в фоновом 
режиме, не должно. быть все время видно и даже в свернутом виде не должно 
занимать место в полосе задач. Гораздо удобнее, если оно будет отображаться 
пиктограммой в области Зуз$ет Тгау. Это область в правом нижнем углу экра- 
на, в которой располагаются часы. 

Еще один недостаток рассмотренного упрощенного приложения — назва- 
ния разделов списка, совпадающие с полными именами файлов. Конечно, 
пользователю удобнее, чтобы названия отражали суть разделов, а имена фай- 
лов рассматривались просто как технические детали. И последнее — имена 
файлов вместе с путями могут быть очень длинными и не помещаться целиком 
в видимой части‘ окон редактирования и списков. Хотелось бы, чтобы, выде- 
лив соответствующий раздел списка и задержав над ним или над окном редак- 
тирования курсор мыши, можно было во всплывающем ярлычке посмотреть 
полный текст. Хотелось бы также иметь возможность обеспечить или отме- 
нить автоматический запуск приложения при загрузке У\У/ш4омз. 

Все это реализовано в примере Но{Кеу1, который вы найдете на прило- 
женном к книге диске в каталоге Кеубоага. В данном разделе мы не будем ос- 
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танавливаться на всех аспектах этого примера. Все связанное с отображением 
пиктограммы в области вузбет Тгау, рассмотрено в разд. 1.10. Автозапуск 
приложения описан в разд. 2.2.2. А в данном разделе остановимся только на 
том, что связано с горячими клавишами. 

Форма данного приложения во время выполнения, в режиме, когда эта фор- 
ма видна, показана на рис. 2.6. Она отличается от рассмотренной ранее допол- 
нительным списком (его имя 11$ Вох3, остальные списки имеют прежние име- 
на), содержащим названия разделов. Добавлено соответствующее ему окно 
ЕЗ2, в котором можно задать имя раздела. Кроме того, добавлена кнопка Свер- 
нуть. Ее назначение следующее. При запуске приложения его форма не появля- 
ется на экране. Вместо этого в области зузет Тгау появляется его пиктограм- 
ма. Если поднести к этому значку курсор мыши, всплывет список нескольких 
первых разделов зарегистрированных горячих клавиш. Если щелкнуть на знач- 
ке правой кнопкой мыши, всплывет меню, одним из разделов которого являет- 
ся Развернуть приложение. В этом случае пользователь увидит ту форму, которая 
показана на рис. 2.6. В ней он может добавить новый раздел, удалить или изме- 
нить один из прежних разделов. Ту же форму пользователь увидит, если сдела- 
ет двойной щелчок на значке в области зуз4ет Тгау. А после того, как пользова- 
тель провел необходимую ему правку, он может щелкнуть на кнопке Свернуть. 
Форма опять исчезнет и останется только значок в области Бузет Тгау. 

Индикатор Открывать вместе с /Утао\мз позволяет управлять автозапуском 
приложения. Если этот индикатор включить, приложение автоматически бу- 
дет запускаться при каждой загрузке У\У/1п4о\мз. 


Рис. 2.6 Список горячих клавиш | 


Приложение Но{Кеу1 Реван ернНав\а? Нр 


Н/ез\Вопайд\Нер\ЬБ.Н 


Название Горячие клавиши Программа, документ 


[Калькулятор | [Сы + ДЕ+ С [Сас 


Добавить | Изменить | Удалить | Свернуть | 


№ Открывать вместе с \Ипдомз 


Коды этого приложения, связанные с горячими клавишами, мало отлича- 
ются от рассмотренных выше. Обработчики событий формы ОпСгезжфе и Оп- 
С]озе отличаются только за счет того, что для каждого раздела имеется еще 
одна строка, содержащаяся в списке 1:1$%&Вох3 и сохраняемая в файле. Осталь- 
ные коды изменяются еще меньше, так как новый ‘список [11$Вох3 — вспомо- 
гательный и не имеет отношения к регистрации клавиш и открытию связан- 
ных с ними файлов. Этот список используется при общении с пиктограммой, 
размещенной в области Буз4ет Тгау. Но анализ кодов данного приложения, 
связанных с пиктограммой, смотрите в разд. 1.10. 

В целом, это приложение оказалось довольно удобным. Я сам с немалой 
пользой для себя использую его. Оно запускается на моем компьютере одно- 
временно с У шЧо\з и позволяет, работая с любыми приложениями, вызывать 
простым нажатием горячих клавиш те документы и программы, которые мне 
в данный период времени часто нужны. 
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2.3.6 Горячие клавиши окна 


Помимо рассмотренной в предыдущем разделе регистрации горячих кла- 
виш, имеется еще одна возможность — связывание горячих клавиш с главным 
окном какого-то приложения. Тогда, если запустить это приложение, а затем, 
не сворачивая его, перейти в другую программу, окно, конечно, закроется ок- 
нами нового приложения. Но если пользователь при работе с любым приложе- 
нием нажмет соответствующие горячие клавиши, то окно, с которым они свя- 
заны, снова появится на экране поверх остальных. 

Горячие клавиши, связанные с окном, не имеют ничего общего с ранее 
рассмотренными, регистрируемыми в системе клавишами. Задание клавиш, 
связанных с окном, осуществляется посылкой сообщения \УМ_ЗЕТНОТКЕУ: 


ИМ ЗЕТНОТКЕУ (МРАВАМ) МАКЕМОВГР (уКеу, по41{1егз), 0) 
Его параметр мРагат в младших разрядах содержит виртуальный код 


клавиши, а в старших — флаги, указывающие нажатие вспомогательных кла- 
виш. Возможные значения флагов (определены в файле СоттСИ1.П): 


[НОТКЕУЕ_ АГТ о клавиша АН ОИ ОНИ 
НОТКЕУЕ _сомтво. — — __ | Клавиша "ОНИ | 
НОТКЕУЕ_ЕХТ ОИ " клавиша ООО 
| НОТКЕУЕ НЕТ —__ [клавиша < и | 


Объединение флагов и виртуального кода в единое значение может осуще- 
ствляться функцией МаКе\ога. В качестве виртуального кода нельзя зада- 
вать коды, соответствующие клавишам Езс, пробела и табуляции. 

Если в качестве параметра задать МОТГ, никакие ранее назначенные го- 
рячие клавиши с данным окном связаны не будут. 

Сообщение возвращает следующие значения: 
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функция успешно выполнена и другого окна с подобными горячими 
клавишами нет 


функция успешно выполнена, но имеется другое окно с такими же | 
горячими клавишами _ 


Например, если вы включите в модуль файл СоттСЁ\.й: 


#1пс104е <Сопшсег1.46> 


и в обработчике события формы ОпСгезжфе запишете оператор 


РегЕогм (ИМ ЗЕТНОТКЕУ, МАКЕМОБВР (110% ('А'), 
(НОТКЕУЕ СОМТВОГ | НОТКЕУЕ АТТ)), 9); 


то с данным приложением будут связаны горячие клавиши СН-А!-А. Подоб- 
ный пример вы найдете на диске в каталоге Кеубоага в проекте РНо1Кец2. По- 
сле запуска этого приложения вы можете перейти в любую другую программу 
и в любой момент нажать соответствующие горячие клавиши. Если вы не свер- 
нули приложение, с которым они связаны, то окно этого приложения появит- 
ся на экране поверх любых других окон. 
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2.4 Курсор мыши 


2.4.1 Сообщения клавиш мыши 


ВАРТ \/114о\з определен ряд сообщений, связанных с нажатием клавиш 
мыши и перемещением курсора мыши: 


—_ двойной щелчок левой кнопкой мыши в кли- 
ентской области окна 


У\М_ГВОТТОМрОммМ ° | нажатие левой кнопки мыши в клиентской об- 
ласти окна 


\М_ГВОТТОМОР отпускание левой кнопки мыши в клиентской 


области окна | 
о 


\УМ_МВОТТОМОВГСЕК двойной щелчок средней кнопкой мыши 
в клиентской области окна 


\М _МВОТТОМро\м нажатие средней кнопки мыши в клиентской 
области окна 


\ММ_МВОТТОМОР отпускание средней кнопки мыши в клиент- 


ской области окна | 


перемещение курсора мыши в клиентской об- 
ласти окна | 


\М_МООЗЕМОУЕ 


вращение колесика_ мыши | 


_ _ що : 


УМ_МООЗЕМНЕЕТ, 
\УМ_МСЕВОТТоМОвтсЕк 


ДВОЙНОЙ щелчок левой кнопкой мыши вне | 
клиентской области окна 


\УМ_МСЬГВОТТОМОмМ нажатие левой кнопки мыши вне клиентской 


области окна 


\ММ_МСЬЕВОТТОМОР отпускание левой кнопки мыши вне клиент- | 
ской области окна | 


\М_МСМВОТТОМРОВТСЕК | щелчок средней кнопкой мыши вне 


клиентской области окна | 


\М_МСМВОТТОМООММ нажатие средней кнопки мыши в клиентской 
области окна 
У\УМ_МСМВОТТОМОР отпускание средней кнопки мыши в клиент- 
ской области окна 

рева сле —__ | 

перемещение курсора мыши вне клиентской 


ДВОЙНОЙ щелчок правой кнопкой мыши вне 


области окна_ - 
клиентской области окна | 


\М_МСВВОТТОМООММ нажатие правой кнопки мыши вне клиентской 
области окна 


\М_МСКВОТТОМОР отпускание правой кнопки мыши вне клиент- 


ской области окна | 

о Не ———-— 
\М_КВОТТОМРВТСЕК Е щелчок правой кнопкой мыши в кли- | 
ентской области окна. 
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ММ _ввоттомромм. нажатие правой кнопки мыши в клиентской 
_ области ‹ окна. 


| \УМ_ВВОТТОМОР ‘отпускание правой кнопки мыши в клиент- 
МИ —_ о _ | ской области окна_ 


Во всех этих сообщениях параметр мРагат показывает, какие в этот мо- 
мент нажаты вспомогательные клавиши. Этот параметр может быть комбина- 
цией следующих флагов: 


мк соо 
‚ МК_СОМТКОГ _ нажата клавиша Фи 
мк твоттом нажата левая кнопка мыши 


— —_ __ ИО ООИИИ | _ О 
МК_МВОТТОМ _ ____ | Нажата средняя кнопка мыши — 


МК_ВВОТТОМ _. ‘нажата правая кнопка мыши 
| МК_ ЭНТЕТ нажата клавиша ЗН 


- ИН 


В событии ММ_МООЗЕМНЕЕГ младшие разряды параметра мРагат по- 
казывают то же, что в других сообщениях, а старшие указывают, насколько 
и в какую сторону поворачивается колесико. Положительные значения соот- 
ветствуют вращению вверх (от пользователя), отрицательные — вращению 
вниз (к пользователю). 

Параметр сообщения ПШРагат содержит в младших разрядах координа- 
ту Х, а в старших — координату У курсора. Координаты указываются относи- 
тельно левого верхнего угла клиентской области. 

В приложениях С++ВаИаег обычно нет необходимости непосредственно 
обрабатывать все эти сообщения, так как это проще делать с помощью обработ- 
чиков событий компонентов ОпМоизедоу\ут, ОпМоизе Ор, ОпМоц5еМотхе и др. 
Но иногда косвенно с обработкой этих событий приходится иметь дело — см., 
например, разд. 5.2.2.2. Имеется возможность перехвата событий мыши с по- 
мощью ловушек. Этот механизм будет рассмотрен в разд. 4.3. 


2.4.2 Получение и задание координат курсора мыши, 
ограничение подвижности курсора 


Получить экранные координаты курсора мыши можно функцией Се Саг- 
5огРо$ (файл Итизег.й): 
ВОО. СееСогзогРоз$ (ООТ ТРРОТМТ 1рРо1пЕЁ); 


Функция заносит в структуру 1рРошё значения координат. 
Например, операторы 


ТРо1ПпЕ А; 
СееСиузотРос (&А); 


позволяют найти экранные координаты курсора как значения полей Р.Х — 
‘координата Х, Р.У — координата У. Методы ЭегеепТоСПепё: 


Турез: :ТРо1пЕ __Еаз&са11 5сгеепТоС11еп® (сопзе Турез::ТРо1пе &Ро1п®); 


присущие всем оконным компонентам, позволяют пересчитать экранные коор- 
динаты в систему координат клиентской области компонента. 
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Задать экранные координаты курсора мыши можно функцией Зе СигзогРов: 
ВООТ Зее СагзогРо$ (ТМ 10 Х, ТМ 1пЕ У); 


Параметры Х и У — соответствующие координаты курсора. Например, оператор 


бееСигзогРоз (0, 0); 


переместит курсор в верхний левый угол экрана. Оператор 


зееСогзогРо$ (Гогм1->1еЁе, Еоги1->Тор); 


переместит курсор к левому верхнему углу формы Роги]. А следующие опера- 
торы устанавливают курсор внутри клиентской области окна Мето] и с секун- 
дной задержкой имитируют щелчок правой кнопкой мыши, вызывающий вы- 
зов контекстного меню окна Мето1: 
бееСигзогкРоз (Мемо1->С11еп Ог1а1п.х + 10, 
Мемо1->С11епОг191п.у + 10); 
51еер (1000); 


Гоги1->Мемо1->РегЕогм (ИМ КВОТТОМРОмМ, О, МАКЕГРАВАМ (10, 10)); 
РКогт1->Мето1->РегЕогм (ИМ ВВОТТОМОР, 0, МАКЕГРАВАМ (10, 10)); 


Ниже приведен аналогичный вариант имитации щелчка на кнопке ВиНип1: 


ЗеЕСогзогРо$ (Ви боп1->С1лепеОг1а1т.х + 10, 
Ва оп1->С11епЕОг1ла1пт.у + 10); 
51еер (1000); 
ВаЕвоп1->РегЕогм (ИМ ЬВОТТОМРОММ, 0, МАКЕГРАКАМ (10, 10)); 
5$1еер (1000); 
Ва оп1->РегЕоги (ИМ ТВУТТОМОР, 0, МАКЕТРАВАМ (10, 10)); 


Подобные операции иногда требуются в различных демонстрационных 
и обучающих приложениях. 

Функция СИрСогзог позволяет ограничить область перемещения курсора 
мыцти. Синтаксис функции: 


ВОО С11рСогзог (ТМ СОМЗТ ВЕСТ *1рВесЁ); 


Параметр 1рВес+ является указателем на прямоугольную область типа ВЕСТ. 
Если в качестве параметра рВесф задать МОТ, курсор освободится и сможет 
перемещаться по всему экрану. | 

Например, создайте форму с кнопкой Зреед4ВиЦИоп, установите в кнопке 
свойство АПомАП р в (ше, и задайте в ее свойстве СгоирШдех значение 1. А 
в обработчике щелчка на кнопке напишите код: 

1Е (брееяаВи® оп1->ромп) 

С11рСигзохг (&Вопипа$Вес®); 


е1зе 
С11рСиогзох (МОЬЬ); 


Запустите приложение и щелкните на кнопке. Вы увидите, что курсор 
мыши не сможет вырваться за пределы окна формы, поскольку указатель на 
область этого окна задан в вызове функции СИрСигзог при нажатии кнопки. 
Только если вы повторно щелкните на кнопке, отпустив ее, курсор обретет 
обычную свободу. 

Это пример того, как вы можете сфокусировать внимание пользователя на 
окне, в котором он обязательно должен выполнить какую-то операцию. Прав- 
да, у пользователя остается возможность закрыть окно. Но от этого ему будет 
только хуже. Приложение закроется, но курсор мыши так и не будет освобож- 
ден. Так что и в других приложениях его перемещение будет ограничено обла- 
стью уже не существующего окна. Если вы не хотите так наказывать пользова- 
теля, то в обработчике события ОпОе$ {гоу формы надо освободить курсор: 
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С11рСагзок (МОЬЬ); 


А если пользователь все-таки обязательно должен выполнить какую-то 
операцию в окне формы, то вы можете запретить ему закрыть или свернуть 
окно. Как можно запретить пользователю доступ к системным кнопкам, рас- 
сказано в разд. 5.2.1. В нашем случае это можно реализовать, изменив обра- 
ботчик щелчка на кнопке следующим образом: 


1Е (ЗрееаВи $ оп1->Вомп) 


{ 

С11рСогзох (&Воипа$Весе); 

НМЕМО МубЗузеетМепоа = СеббузфсетМепи (Напа1е, Еа15е); 
Ре1екеМепли (МубузЕетмМепи, $С_СТО$Е, МЕ _ВУСОММАМО); 
Ре1ефеМепи (МубузеемМепи, $С_ МТМТМТЕ, МЕ ВУСОММАМО); 


} 


е1зе 


{ 
С11рСагзохг (МОГ); 
сефбузсептМепи (НапЯ1е, &гие); 


} 


Впрочем, сворачивание окна можно запретить проще, убрав соответствую- 
щую кнопку из свойства Вог4егсоп$ формы. 

В нашем примере у пользователя остается еще возможность закрыть окно 
горячими клавишами А!|-Г4. Это легко запретить, введя соответствующий 0об- 
работчик события ОпКеудо\т: 


1Е (ЗрееаВае+оп1->Ромп && ЭР1ЕЕ. Сопба1пз$ ($55А16) && (Кеу == УК _Е4)) 
Кеу = 0; 


Подобный пример имеется на диске в каталоге Сигзог в проекте СйрСитзог. 
У пользователя остается в нем только один способ покинуть окно — перейти 
в другое приложение, нажав горячие клавиши А!-ТоБ. Но это ему не поможет, 
так как курсор и в другом приложении останется связанным. Так что или надо 
выполнить требуемую операцию (в нашем примере всего-навсего нажать еще 
раз кнопку), или нажать горячие клавиши С%#1:1-АЙ-Ое] и закрыть проект с по- 
мощью Диспетчера Задач У/шао\з. 


2.4.3 Управление видимостью курсора мыши 


_ Управление видимостью курсора мыши в пределах окна приложения осу- 
ществляется функцией ЗвомСигзог: 


116 ЗРомСигзохт (ТМ ВООТЪ Б5ЗРВом); 


Значение 6ЭВо\м = Ёа[$е делает курсор невидимым, а значение фгие делает 
невидимый курсор видимым. Обратите внимание на то, что курсор становить- 
ся невидимым только в вашем приложении. При выходе с формы курсор ста- 
новится видим. 

Точнее, так происходит при однократном вызове функции ЭВо\Саогжог. 
В более общем случае надо учитывать, что в \У/ш4о\мз$ подсчитывается число 
ссылок на курсор. Если число ссылок неотрипательно — курсор виден. На- 
чальное значение числа ссылок равно 0. Каждый вызов ЭВомСагзог с парамет- 
ром гие увеличивает число ссылок на 1, а каждый вызов ЭВомСагзог с пара- 
метром #а]5е уменьшает на 1 число ссылок. Как только число ссылок станет 
отрицательным, курсор станет невидимым. Так что если вам требуется сделать 
курсор невидимым, независимо от числа ранее выполненных команд, делаю- 
щих его видимым, это можно сделать, например, оператором: 
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имр1]1е (бПомСотзог (ЁЕа1зе) > 0) 


Функция ЭВомСиг$ог возвращает число ссылок, полученное в результате 
вызова функции. 


2.4.4 Изменение функций левой и правой кнопок мыши 


Иногда может возникнуть потребность взаимно поменять функции левой 
и правой кнопок мыши. Это можно сделать функцией ЗмарМоизеВи Ков, объ- 
явленной в модуле УЛп4о\мз: 


ВООГ $марМоизеВие оп ( ТМ ВООТ ЕЗмар); 


Если параметр Ё{$\ар равен #гае, то левая кнопка начнет генерировать со- 
бытия, свойственные правой кнопке, а правая кнопка начнет генерировать со- 
бытия, свойственные левой кнопке(инвертирование кнопок). Например, кон- 
текстные меню будут всплывать при щелчке левой кнопкой. А делать щелчки 
на кнопках приложений надо будет делать правой кнопкой мыши. 

Если параметр Ё5мар равен #а]5е, то восстанавливаются нормальные 
функции кнопок. 

Учтите, что если вы переключили функции кнопок, а затем их не восста- 
новили, то измененные функции будут действовать не только на ваше прило- 
жение, но и на все остальные приложения \У14о\з. Причем измененные 
функции кнопок сохранятся, даже если ваше приложение завершится. 


2.4.5 Изображения курсоров, анимированные курсоры 


В \У194о\мз предусмотрено множество курсоров для отображения различ- 
ных ситуаций в приложениях. Доступ к доступным в приложении курсором и 
к текущему курсору дает глобальная переменная У%сгееп типа ТЭсгееп. Теку- 
щий курсор определяется свойством Сиг$ог этого объекта. По его значению 
можно определить, какой курсор в данный момент активен, или можно акти- 
визировать тот или иной курсор. Для этого могут использоваться константы, 
перечисленные в столбце Константа типа ТСигзог в табл. 2.1. 
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Если свойство Сигзог объекта %сгееп равно сгОе#аий, то вид курсора при пе- 
ремещении над компонентами определяется установленными в них свойства- 
ми Сшбог. Но если свойство Сиг$ог объекта %Зсгееп отлично от сгОеёащЁ, то соот- 
ветствующие свойства компонентов отменяются, и курсор имеет вид, показан- 
ный в табл. 2.1. Этим можно воспользоваться для такой частой встречающей - 
ся задачи, как изменение курсора на форму «песочные часы» во время выпол- 
нения каких-то длинных операций. Подобное изменение формы курсора мож- 


но оформить следующим образом: 
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ссгееп->Сагзог = сгНоцгС1а$$; 

гу 

{ | 

// выполнение требуемых длинных операций 


} 


саесН (...) 

{ | 
Зсгееп->Сигзог = сгрегай1*; // восстановление курсора 
Сбгом; | 

} . 

5сгееп->Сигзог = сгреЁач]1*; 


При успешном или аварийном окончании длинных операций курсор в лю- 
бом случае возвращается в значение по умолчанию. | 

Если в приложении в какие-то отрезки времени используется отличный от 
сгре!аиЁ глобальный вид курсора, то приведенный код можно изменить, чтобы 
по окончании длинных операций восстановить прежнее глобальное значение: 


ТСигзог 5ауе Соагзог = 5сгееп->Сагзохг; 
5сгееп->Сигзог = сгНоцгС1аз3; 
фгу 


{ 
// выполнение требуемых длинных операций 


} 


саеср (....) 

{ 
5сгееп->Сагзог = бауе Сигзог; 
ЕВгоим; 

} 

ссгееп->Сигзог = бауе Согзог; 


В объекте %$сгееп имеется также свойство Сиг$ог$[ 1], которое представляет 
собой список доступных приложению курсоров: 


__ ргорекеу НТСОМ Сагзог$ [1пе Тпаех] 


Индексы Шшдех — могут лежать в пределах от —327168 до 32767. Для предо- 
пределенных в системе стандартных курсоров индексы лежат в диапазоне от 0 
до —21. Вы можете видеть их в столбце Значение в табл. 2.1. 

В приложении можно создать и использовать свои собственные курсоры, 
загружая их из ресурсов или из файлов. Включение в ресурс курсора рассмот- 
рено в разд. 4.1.2, а использование курсора из ресурса в приложении показано 
в разд. 4.1.4 и 5.2.2.3. Для использования курсора его надо зарегистрировать 
с помощью функции Гоа@4Сиг$ог: 


НСОВ$ОВ ГоаЧСогзог (НТМ5ТАМСЕ ВТрзфкапсе, БРСТЗТК 1рСогзогМапе); 


Параметр Вш%апсе указывает дескриптор того приложения, из ресурсов 
которого извлекается курсор. Если это то приложение, из которого вызывает- 
ся функция, значение этого параметра следует задавать равным Нш®апсе. Па- 
раметр рСиг$огМате указывает имя курсора в ресурсе. Оно пишется обяза- 
тельно заглавными буквами. | 

Функция возвращает дескриптор курсора, или МОШ,, если курсор не найден. 

Пусть, например, вы создали свой курсор и включили его в ресурс прило- 
жения под именем МЕ\УСОВ$ОВ. Тогда в своем приложении вы можете ввести 
глобальную константу, обозначающую ваш курсор. Например: 


сопзе сгМуСигзог = 1; 
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В обработчике события ОпСгеж{е формы вы можете ввести оператор, реги- 
стрирующий ваш курсор в свойстве Сигзог$: 


осгееп->Сигзог$ [сгМуСигзог] = ГоааСогзог (НТпз®апсе, "МЕМСОВ$ОВ"); 


В нужный момент вы можете установить этот курсор в качестве глобаль- 
ного оператором 


эосгееп->Сигзог = сЕМуСоагзоЕ; 


а затем восстановить значение глобального Курсора оператором 


5сгееп->Сиагзог = сгПОе#ац1{; 


Вы можете использовать ваш зарегистрированный курсор и как локаль- 
ный, например, для панели Рапе1 оператором 


Рапе11->Сигзог = (ТСоагзог) сгМуСиг$ог; 


Функцию ГоадСиг$ог можно использовать и для извлечения системных 
курсоров. Для этого аргумент Вт$апсее надо задать равным МОШ,, а в качестве 
аргумента рСиг$огМате указать одну из предопределенных в файле штизег.й 
строковых констант. Эти константы перечислены в столбце Строковая констан- 
та в табл. 2.1. Например, следующий оператор задает в качестве курсора, заре- 
гистрированного вами с индексом сгМуСиг$ог, курсор «песочные часы». 


5сгееп->Сигзог$ [сгМуСигзог] = ГоааСагзог (МОЪЬ, ТОС МАТТ); 


Курсоры можно загружать во время выполнения из файла. Для этого ис- 
пользуется функция ГоадСиг$огЕгот Е Пе: 


НСОВЗОВ ТоааСагзогРгойЕ11е (.РСТУТВ 1рЕ11еМапе); 


Аргумент рЕЦеМате указывает имя файла, содержащего курсор. Это мо- 
жет быть файл .сиг, содержащий данные статического курсора, или. файл .апу, 
содержащий анимированный курсор. 

Файлы курсоров, поставляемые с Ут4о\мз, рзмещаются обычно в подка- 
талоге Сигзог$ каталога У/1190\з. Так что следующий код позволяет посмот- 
реть любой выбранный пользователем файл курсора: 


соп5Е схМуСигзог = 100; 


сраг АРсвахг [МАХ _РАТН]; 

СееИ1п4ом$01гесвогу (АРспаг, МАХ _РАТН); 

Орепр1а10о391->1п1161а101г = (Апз156г1па)АРсВагк + "\\Сагзогз"; 
Орепр1а1о031->Е1]$ег = "Анимированные курсоры|*.ап1|Все файлы|*.*"; 
1Е (Орепр1а10о91->Ехесиее ()) 

{ 


Зсгееп->Сиагзог$ [сгМуСиагзог] = 
Тоа9СигзогЕгомЕ1 1е (Орепр1а10о31->Е11еМаме.с_$%г()); 
эсгееп->Саг5ог = (ТСиагзог) сЕМуСаг$ог; 


} 


Выше упоминались анимированные курсоры .апЁ. Эти курсоры отобража- 
ются движущимися изображениями, иногда довольно забавными. Данные 
анимированных курсоров состоят из ряда фреймов — кадров, отображающих 
отдельные стадии движения. Приведенный выше код позволяет посмотреть те 
анимированные курсоры, которые имеются на вашем компьютере. Кроме того, 
в Интернете можно найти множество других анимированных курсоров. Созда- 
вать такие курсоры удобнее всего с помощью специальных программ. Напри- 
мер, имеется программа АщейЙ.ехе, которую вы можете получить на сайте 
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Нр.ппсгозоН.сот/Зегусез/ТесиМе/затр!ез/РЗ/\М/т98 /Кезки/РЕЗКТОР. С помощью 
нее можно создавать анимированные курсоры, если вы обладаете соответствую- 
щими способностями. А можно взять какой-то из имеющихся курсоров и что-то 
в нем изменить. Например, добавить к изображению какую-то надпись. 

Мы рассмотрели, как курсоры можно загружать и назначать в качестве 
глобальных или в качестве курсоров каких-то компонентов. Но пользуясь тем, 
что свойство Зсгееп->Сиг$ог$ [МуСиг$] возвращает дескриптор курсора, курсоры 
можно изображать на любой канве. Для изображения статического курсора 
может использоваться функция Ога\Гсоп: 


’ВООЬ ПРгамТсоп (ТМ НОС ПИРС, ТМ 1пЕ Х,ТМ 116 У, ТМ НТСОМ ВТсоп); 


В качестве параметра ВОС обычно задается дескриптор канвы. Параметры 
Х и У задают координаты левого верхнего угла изображения. А в качестве па- 
раметра Шсоп можно использовать дескриптор курсора. 

Например, следующий оператор отобразит курсор, зарегистрированный 
с индексом МуСиг$ог, на канве компонента Ппасе1: 


ПгамТсоп (Тиадче1->Сапуа$->Напа1е, 10, 10, 5Зсгееп->Сиагзог$ [МуСаг5ог] ); 


Правда, он сработает только для статического курсора. Анимированный 
курсор отобразить этой функцией невозможно. 
Гораздо большие возможности предоставляет функция Огау[сопЕх: 
ВОО РгамТсопЕх (ТМ НОС Вас, ТМ 1пе хЬеЕЕ, ТМ топе уТор, 
ТМ НЕСОМ ЬТсоп, ТМ 1пе схМ1аев, ТМ 1пе сумлафь, 


ТМ ОТМТ 156ертЕАп1Сиг, ТМ НВВО$ЗН ЮЬгЕ11скегЕгее кам, 
ТМ ОТМТ а1Е1ааз$); | 


Эта функция позволяет изменять размер изображения курсора, а также 
позволяет рисовать отдельные фреймы анимированного курсора. Параметры 
ВОС, Х, Уи Шсоп имеют тот же смысл, что и в предыдущей функции. Парамет- 
ры сх\\ 4 и су\ 4 — это логическая ширина и высота изображения. Эти 
значения могут отличаться от реальных размеров курсора. Параметр 
%ерНАшСиг указывает отображаемый фрейм анимированного курсора. Номе- 
‚ра фреймов отсчитываются от нуля. При изображении статического курсора 
этот параметр задается равным 0. Параметр иБгЕЙйсКегЕгееОгазу — дескриптор 
кисти Вги$В контекста, используемой для фона. | | 

Параметр 91 а2$ — флаг, определяющий, в частности, размер изображе- 
ния. Если задать 9а$ = 0, то размеры изображения будут определяться зна- 
чениями параметров схУ\1А и су\ А. А если значения этих параметров зада- 
ны равными 0, то размер изображения будет равен истинному размеру пикто- 
граммы. Если задать 9а2$ = ОГ СОМРАТ, то значения схУЛА и су\1а бу- 
дут игнорироваться, и размер изображения будет равен заданному в системе 
по умолчанию. Если задать 91 ао$ = ОТ ОЕКАОГ. Т.Е, то размеры будут рав- 
ны размерам по умолчанию, даже если сх и су\ ЧЕ равны нулю. 

Пример использования функции Огау[сопЕх вы найдете в разд. 2.4.7. 


2.4.6 Системная информация о схемах курсоров 


В разд. 2.4.5 многократно говорилось о предопределенных системных кур- 
сорах. Но реальный вид этих курсоров определяется тем, какая схема курсо- 
ров задана при настройке \У!114о\мз. Схема курсоров задается апплетом Мышь 
программы Панель управления. Если вы перейдете в окне этого апплета 
на страницу Указатели, то можете настроить множество используемых форм 
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курсоров. На рис. 2.6 показана эта страница для УИ 1ш9домз ХР. В других верси- 
ях \Упо\з$ она может быть несколько другой, но основные элементы страни- 
цы остаются те же. Список Схема позволяет выбрать одну из предопределен- 
ных схем. В панели Настройка вы можете выбрать тот или иной курсор, и его 
вид отобразится в правом верхнем углу окна. Можете изменить с помощью 
кнопки Обзор файлы некоторых или всех курсоров, а затем сохранить сфор- 
мированную схему кнопкой Сохранить как под каким-то новым именем. Таким 
образом вы можете сформировать новые схемы курсоров. 


Рис. 2.6 Свойства: Мышь _— в: 1х 
Окно настройки схем курсоров _ Параметры указателя Колесикю | Оборудование 
мыши | Кнопки мыши Указатели 


‚ Снема Е с 
\/тдочиз ОеЁаий [системная] КТ 
Сохранить как... | ет | 


Настройка: 

1 Основной режим 
Выбор справки 
ЧФоновый режим 

1 Система недоступна 


Графическое выделение 


\ Включить тень указателя 


Зарегистрированные в системе схемы курсоров хранятся в реестре в ключе 
НКЕУ ОСАЕ_МАСНИМЕ\ ЗОЕТУ/АКЕ\ М'сгозоН\ \У/таомэ\ СитетМУегяюп\ Соп!то| 
Рапе|\ Согзог\ ЗсВетез. В этом ключе записаны параметры, имена которых сов- 
падают с именами схем, которые видит пользователь в списке Схемы в окне 
рис. 2.6. Значения параметров — это списки имен файлов, соответствующих 
курсорам схемы. Последовательность перечисления файлов соответствует той, 
которая видна в окне рис. 2.6. Имена файлов отделяются друг от друга запя- 
тыми. Если для какого-то курсора специальный фал не предусмотрен, его имя 
остается пустым. Для параметра схемы по умолчанию Утдо\у$ Ве!ашЕ все име- 
на файлов пустые, т.е. значение этого параметра равно «,,,,,,,,,,,,›». Значения 
некоторых параметров заключаются в кавычки, но для некоторых параметров 
кавычки отсутствуют. 

Указанный выше ключ имеется в УИш4омз 2000\ХР ит.д. В У/шао\з 9.х 
аналогичная информация содержится в ключе НКЕУ СУКВЕМТ_ОЗЕК\ Сопно| 
Рапе|\ Сигзог$\ Зспетез. Так что информацию надо черпать из этого ключа. 
В У114о\жз 2000\ХР такой ключ тоже имеется, но он пустой. 

Имеется еще один ключ реестра, содержащий информацию о курсорах — 
ключ НКЕУ СОККЕМТ _ЧЗЕК\ Сопно| Рапе\ Сигзог$. В нем хранятся данные курсо- 
ров. Наиболее информативен параметр без имени (он отображается надписью 
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«(По умолчанию)»). Его значение содержит имя принятой по умолчанию схе- 
мы. Имена остальных параметров — это имена стандартных курсоров. Если 
курсору назначен файл, то соответствующий параметр содержит относительное 
имя этого файла (относительно каталога \!114о\з). Впрочем, соответствующие 
имена файлов проще извлекать из параметров описанного ранее ключа. 


2.4.7 Пример работы с информацией о курсорах 


В данном разделе рассмотрено демонстрационное приложение, иллюстри- 
рующее работу с описанной в разд. 2.4.5 и 2.4.6 информацией о курсорах. Этот 
пример имеется на приложенном к книге диске в каталоге Сигзог в проекте 
РСигзог. Окно приложения показано на рис. 2.1. 

Панель Файлы курсоров позволяет посмотреть курсоры, файлы которых 
имеются на компьютере. В списке Статические курсоры \/тдо\м$ (его имя в при- 
веденном далее коде СотБоВохСиг) содержатся имена всех файлов статиче- 
ских курсоров, имеющиеся на компьютере в подкаталоге Сигзогз каталога 
У/1п4о\мз. В списке Анимированные курсоры \/тао\з (имя СотфоВохАпй) содер- 
жатся имена аналогичных файлов анимированных курсоров. Если пользова- 
тель выбирает файл в этих списках, курсор приобретает соответствующую 
форму, в метке внизу панели (имя ГЕЦе2) отображается полное имя файла, а на 
нижней панели в окне Увеличенное изображение (компонент Йпа?е1) появляется 
увеличенное изображение курсора. Если курсор анимированный, то это изо- 
бражение соответствует его первому фрейму. 


Рис. 2.7 ый 
Окно приложения | `Файлы курсоров ' 


Статические курсоры МИтмоше. Анимированные курсоры МАпиощз 


Бапапз . ыы 


Курсор 


Файл К:\\МММОО\М 5 \Сшзогз\Бапапа. аги 


Схемы курсоров 
По умолчанию установлена схема курсоров \Атдомз БеГаий 


Схемы курсоров Стандартные разделы схемы курсоров 


[Митдомз РеГаий ы Основной режиь 


| Выбор справки 
Увеличенное изображение 


ЧФоновый режим 
Система недоступна 
Графическое выделение 


Выделение текста 


144 | Глава 2. Работа с устройствами 


Кнопка Курсор позволяет пользователю в стандартном диалоге открыть 
любой файл курсора на любом диске компьютера. 

Нижняя панель Схемы курсора на рис. 2.7 позволяет посмотреть курсоры 
всех установленных в системе схем. В метке вверху панели (имя ГЕ/Зсвпет) ото- 
бражается имя установленной по умолчанию схемы. Список Схемы курсоров 
(имя СотБоВох$) содержит имена всех схем, зарегистрированных на компью- 
тере. Список Стандартные разделы схемы курсоров (имя 1/15 Вох1) содержит обо- 
значения стандартных курсоров. Пользователь может выбрать в списке 
СошфоВох$ интересующую его схему, а затем сделать двойной щелчок на ка- 
кой-то строке списка 115 Вох1. Курсор приобретет соответствующую форму, 
а в окне Увеличенное изображение появится масштабированное изображение 
курсора. В метке (имя ГЕПе) внизу панели отобразится имя файла курсора 
или текст вида: «Этот курсор в схеме ... не задан». На рис. 2.7 эта метка 
не видна, поскольку изображен момент выбора пользователем файла из списка 
Анимированные курсоры \\/т\/о\уз, а в этом случае текст метки Е Ее стирается, 
чтобы не путать пользователя. 

Помимо перечисленных компонентов на форме находится диалог Ореп0Ой- 
1021, в свойство ЕШег которого занесены фильтры: 

.ап1 


. СПЕ 


.ап1;*. саг 
х 


Анимированные курсоры (.ап1) 
Статические курсоры (.саг) 
Все курсоры (*.ап1;*.сог) 
Все файлы 


ххх 


Все списки формы заполняются программно, кроме списка [1$ Во»1, в ко- 
торый во время проектирования загружены строки: 


Основной режим 

Выбор справки ‚ 
Фоновый режим 

Система недоступна 

Графическое выделение 

Выделение текста 

Рукописный ввод 

Операция невозможна 

Изменение вертикальных размеров 
Изменение горизонтальных размеров 
Изменение размеров по диагонали 1 
Изменение размеров по диагонали 2 
Перемещёние 

Специальное выделение 

Выбор ссылки 


Эти строки соответствуют названиям стандартных курсоров, которые 
можно видеть в окне Свойства: Мышь, показанном в разд. 2.4.6 на рис. 2.6 (на 
рисунке, конечно, видны не все строки). Записаны они в той последовательно- 
сти, в которой перечисляются в схемах курсоров. 

Ниже приведен код этого приложения. 


#1пс1оае <гед1зегу.Прр> 


// вспомогательный индекс для загрузки различных курсоров 

соп5е МуСигз$ = 101; 

// индекс для загрузки файла курсора "Рукописный ввод" 

соп5Е МуРеп = 102; 

Т5$Ег1па11$6 * 11$36Сиг = пем Т56г1п9115%; 

Т$Ег1п911$Е * 11$6Ап1 = пем Т56г1п9Г1$%; 

// массив констант стандартных курсоров 

ТСигзог Сиг[15] = {сг)еЁаа1®, стНе1р, сгАрр56аг®, сгНоцгС1а$$, 
сгСго5$, сгТВеаш, (ТСигзог)МуРеп, ск№о, сгб17ем$, 
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сг512емЕ, схгб1хеми$зЕ, сгб1хемЕбМ, сгб12еА11, 
сгОрАггом, сгНапаРо1п{}; 


у01А _ Еаз®са11 ТГогш1: : ГогиСгеаее (ТОр]ес®е *5епаег) 
{ 

сваг АРсВаг [МАХ _РАТН]; 

106 1ге$; 

ТбеагсПВес 5ВК; 

Ап$15Ег1па 01гСигзог, ехё, 51; 
сес\1п4ои$01гесфогу (АРспаг,МАХ_РАТН); 

// подкаталог Сигзог$ каталога И1паои5$ 
21гСигзог = (Ап515%к1па)}АРсраг + "\\Сагзог5"; 
// задание курсора "Рукописный ввод" 

1Е (Р11еЕх15%5$ (21гСигзог + "\\реп_г.сиг")) 


5сгееп->Сигзог$ [МуРеп] = ГоаАСагзогЕгойЕ1 Те ( 
(21гСигзог + "\\реп г.сиг") .с_$6г())}; 
е1з5е 5$сгееп->Сигзог$ [МуРеп] = сгОеёао1*; 


// заполнение списков курсоров 
$1 = Б1уСагзог + "\\*.*"; 
СопроВохСиог->С1еаг(); 
СопроВохАп1->С]еаг(); 
1гез = Е1паЕ1г5$ (51, ЕаАпуЕ11е | ЕаАгсЬ1уе , 58); 
мб1]е (1гез == 0) 
{ 
ехЕ = ОррегСазе (Ех гасеЕ11еЕхф (5В.Маше)); 
1Е (ехе == ".СОВ") 
{ 
1 $ЕСиг->АЯа (21гСигзог + "\\" + 5В.Мапе); 
СопроВохСиг->Т+етз$->Ада (5В.Маме.зееГепаерй (58 .Маме.Тепаев ()-4 )); 
} 
е1зе 1ЁЕ (ехЕ == ".АМТ") 
{ 
11 $Ап1->Ааа (21гСагзог + "\\" + 5В.Мапе); 
СопроВохАп1->Т6емз->Ааа (5В .Маме. Зе Гепаер (5В.Маме.1епа®В ()-4 )); 
} 
1гез = ЕРЕ1паМмехе (58); 
} 
Р1паС1озе ($58); 
1Е (СопроВохСаг->Т%&еп$->Соппе > 0) 
СопБоВохСиг->Т&епТпаех = 0; 
е1зе 
СотроВохСиг->Епаб1еа = Ёа15е; 
1Е (СопроВохАп1->Т$епт$->Соип® > 0) 
СопроВохАп1->1ЕепшТпаех = 0; 
е1зе 
СопроВохАп1->Епаб1еа = Ёа]1зе; 


// заполнение списка схем курсоров 
ТВеч1з6гу *гед = пем ТВед15%кгу; 
гед->Воо+*Кеу = НКЕУ ТОСАГ МАСНТМЕ; 
1Е(! геа- >Орепкеу ("БОРТИАВЕ\ \М1скозоЕе\ \И1пдомз\ \СаггепеУегзлоп\\" 
"СопЕго1 Рапе1\\Сигзогз\\бсремез", Ёа1зе)) 
{ | 
гед->КооеКеу = НКЕУ СОВВЕМТ О5ЕБ; 
12Е(! геа->Орепкеу ("СопЕго1 Рапе1\\Сигзогз\\5светез", Еа1зе)) 
{ 
СПомМеззаче ("В реестре нет ключа \"НКЕУ ТОСАГ МАСНТМЕ\ \" 
"ЗОЕТИАВЕ\ \М1сгозоЕ* \ \И1п4омз \ \Сиггепе\Уегз1оп\\" 
"СопЕго1 Рапе1^“\Сиагзогз\ \5сВемез\"\п или ключа \"" 
"НКЕУ ТОСАЬ _МАСНТМЕ\ \" 
"СопЕГо1 Рапе1 \\Сигзогз\\5сВемез\"\п" 
"содержащего схемы курсоров"); 
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СопроВох5->Епаб1еЯ = Ёа15е; 


} 
} 
1Е (СошроВох5->Епа1ея) 
{ 
геч->СбеУа]аеМапез (СотБоВох5->Т$етз); 
1Е (СопроВох5->Т6ет$->Сопцп > 0) 
СопроВох5->ТетТпаех = 0; 
е1зе СопьоВох5->Епар1еа = Ёа15е; 
// Формирование списков файлов для каждой схемы курсоров 
ог (116 1=0; 1 < СотроВох5->Т&емз->СойпЕ; 1++) 
{ 
51 = гед->Веаа5®г1па (СопроВох5$->ТЕетз->5Ег1паз$ [1]); 
// стирание кавычек, если список начинается с них 
1Е ( $51[1] == \'\"') 
51 = $51.барбЕг1лпа (2, 51.ЪепаеБ ()); 
// создание и заполнение списка 
Т5Ег1п911$6 *бсреше = пем Т5®г1п9115%; 
мВ11е (5$1.Роз(",") >О0) 
{ 
5спеме->Ааа ($1.5ЗоЮ5Ег1па (0, 51.Ро$(",") - 1)); 
$1 = $1.барзегклпа ($1.Роз(",") + 1, 51.ЪепоаёВ ()); 
} . 
СопбоВох5->Т6ет$->06)]ес®$[1] = зсрепе; 
} 
} 


// определение установленной схемы курсоров 
гед->Воо&Кеу = НКЕУ СОВВЕМТ О5ЕБ; 


1Е (гед->ОрепКеу ("СопЕгко1 Рапе1\\Сиагзогз", Ёа1зе)) 


{ 
51 = геа->Веаа5®г1па (""); 
1Е(51 == "") 
.бсреп->Саре1оп = 
"Нет схемы курсоров, установленной по умолчанию"; 
е15е 


{ 


.5свеп->СарЕ1оп = "По умолчанию. установлена схема курсоров " + 
51; 
СопроВох5->ТфкешТпаех = СотБоВох5->Т&епз->ТпаехоЕ{51); 


} 
} 
геа->Егее (); 
15ЕВох1->ТепшТпаех = 0; 
.1$ЕВох1061С11сКкК (5епаег); 


у01А _ ЕазЕса11 ТКогм1: : ГКогиС1о5е (ТОр)]есе *5епаег, 
ТС1озеАсе1оп. &Асе1оп) 


: 


.1$ЕСиг->Егее () 
111 $ЕАп1->Ргее (); 


Уу01А __Еаз®са11 ТЕогп1: :СотроВохСигС1озе0р (ТОБ]есЕ *5епаехг) 


{ 
1Е (СопроВохСаг->ТЕешТпаех >=. 0) 


{ 


// загрузка файла и отображение статического курсора 


Зсгееп->Сигзог$ [МуСигз$] = ГоаЧАСагзогЕгомЕ1 Те ( 
| .1$ЕСиг->56г1па$ [СошроВохСиг->ТешТпаех] .с_$5%г()); 
5сгееп->Сигзог = (ТСагзог)МуСигт$; 


Тпаче1->Сапуаз->Е111Вес* (Тмаде1->С11епВес®); 
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ОРгамТсопЕх (Тмаде1->Сапуаз->Напа1е, 2, 2, 
5$сгееп->Сигзогз [МуСиг$], Тмаде1->С11епЕемтаеь - 4, 
Тпаче1->С11епеНезар® - 4, 
О, Тпаде1->Сапуаз->ВгозВ->Напа1е, 0); 


Т1Е11е2->СарЕ1оп = "Файл " + 
15 ЕАп1->56г1па$ [СопроВохСаг->ТеешТпаех]; 
Т.Е1]1е->Саре1оп = ""; 
} 
} 
Ииннннннннннннннннннн-======================-======--- 


\01А _ Еаз®са11 ТГогг1 : : СотроВохАп1С1озе0р (ТОБ]есе *5епаег) 


{ 
1Е (СопбоВохАп1->ТЕепТпаех >= 0) 


{ 


// загрузка файла и отображение анимированного курсора 


5сгееп->Сигзог$ [МуСиг$] = ГоааСагзогЕгомЕ1 Те ( 
13$ Ап1->56г1п4$ [СотроВохАп1->Т6епТпаех] .с_56х()); 
5сгееп->Сиагзог = (ТСагзог)МуСаг$; 


Тпаче1->Сапуа$->Е111Вес® (Тмаде1->С11епВес®); 

РгамТсопЕх (Тпаде1->Сапуаз->Напа1е, 2, 2, 
Зсгееп->Сигзог$ [МуСигз], Гпаде1->С11еп Е МтаЕр - 4, 
Тпаче1->С11епеНезайе - 4, ` 
О, Тпаде1->Сапуа5$->Вгизр->Напа1е, 0);; 


ТЕ11е2->Сар®е1оп = "Файл " + 
1156 Ап1->56 г1па$ [СопроВохАп1 ->ТЕемТпаех]; 
.Е1]е->Сар®1оп = ""; и 
} 
} 
ИЕН ------------- 


У01А _ Еаз®са11 ТЕогм1: : Ва $ оп1С11сК (ТОБ)]есЕ *5епаег) 
{ 
// загрузка и отображение выбранного пользователем файла курсора 
сраг АРсраг [МАХ _РАТН]; 
сееИ1пЧом$01гесфогу (АРсВаг,МАХ _РАТН); 
Орепр1а1091->1п11%1а101х = (Ап5$156:1п9)АРсраг + "\\Сиагзогз"; 
1Е (Орепр1а1о91->Ехеси*е ()) | 
{ 


ТЕ11е2->Сар®1оп = "Файл " + ОрепП1а1о091->Е11еМапе; 

ТЕ1]1е->Сар®1оп = ""; 

5сгееп->Сигзог$ [МуСиг$] = ГоааСагзогЕРгопЕ1 Те ( 
ОрепрО1а1091->ЕР11еМаще.с_з%г()); 

осгееп->Сагзог = (ТСиагзог)МуСагз$; 


Тпадче1->Сапуа$->Е111Вес® (Тмаде1->С11епЕВесе); 

РгамТсопЕх (Тиаде1->Сапуаз->Напа1е, 2, 2, — 
Зсгееп->Сигзог$ [МуСиаг$], Гпаде1->С11еп ИтаеН - 4, 
Тпаче1->С11епНезав® - 4, 
О, Тмаде1->Сапуаз->Вгазв->Напа1е, 0); 


Уу01А __ЁРаз®са11 ТГогт1: :[15%Вох1061С11сКк (ТОр)]есЕ *5епаег) 
{ 
// отображение выбранного пользователем курсора 
1пЕ 1 = 11$56Вох1->ТеешТпаех; 
.Е11е2->СарЕ1оп = ""; 
ТЕ ( (СопроВох5->ТЕемТпаех >= 0) && 
(1 < ((Т56х1109115$е *) (СопроВох5->Гбемз->0ОБ]есез [ 
СотроВох5->ТеетТпаех])) ->СоцпЕ) ) 
{ 
ТЕ11е->СарЕ1оп = ((Т$5Ег1п911$% *) ( 
СопроВох5->Т&ем5->0О5)есе$ [СопроВох5->ТЕешТпаех])) ->56х1па$[1]; 
1Е(ТЕ1]е->Саре1оп != "") 
{ 


148 - | Глава 2. Работа с устройствами 


осгееп->Сиагзог$ [МуСог$] = ГоаЯаСигзогЕгкомЕ1 Те ( | 
ГЕ1]1е->Саре1оп.с_$6г()); 
"Файл " + 1ТЕ11е->Саре1оп; 


ТЕ11е->Саре1оп 
} 


е]1зе _ 


{ 
Т.Е11е->Сар®1оп 


"Этот курсор в схеме \"" + СопроВох5->ТехЕе + 
"\" не задан"; 
5сгееп->Сигзог$ [МуСиг$] = 
5сгееп->Сиг5ог$ [Саг [11$6Вох1->ТепТпаех]]; 
} 
} 


е]1 зе 


{ 
осгееп->Сигзог$ [МуСиг$] = 
Зсгееп- >Сигзог$ [Сиг [11$ЕВох1->Теем!1п4ех]]; 
ЬЕ11е- ->Саре1оп = "Этот курсор в схеме \"" + СотроВох5->Техе + 

м\" не задан"; 


} 

осгееп->Сигзог = (ТСигзог) МуСаг$; 

Тпаче1->Сапуаз->Ё111Вес® (Тмаде1->С11епЕВесе); 

РгамТсопЕх (Тмаде1->Сапуа$->Напа1е, 2, 2, 
осгееп->Ситгзог$ [МуСог$], Тиаде1->С11епе\Мтаер - 4, 
Тпадче1->С11епЕНетзаве - 4, 
О, Тмаде1->Сапуаз->Вгазб->Напа1е, 0); 


уо1Аа __Еазеса11 ТГогм1: :115ЕВох1РгамТеем (ТИ1пСопего] *Сопфго1, 
106 Тпаех, ТВесе &Веск, 
ТОмпегВгаимсаее Зтаее) 


{ 
Т.15$<Вох1->Сапуаз->Тех% Ой (Кесе.БеЕЕ + 2, Весе.Тор + 4, 
113Вох1->Т%емз->5Ег1па$ [Тпаех]); 
РгамТсопЕх (11$ЕВох1->Сапуаз->НапЯ1е, Вес+.Влане - 34, Вес®.Тор + 2, 
Зсгееп->Сигзог$ [Сиг [Тпаех]], 32, 32, 
О, Т15ЕВох1->Сапуаз->Вгозр->Напа1е, 0); 
} 


В начале приведенного кода задаются две константы — МуСш$ и МуРеп. 
Первая из них используется при загрузке различных курсоров, не относящих- 
ся к стандартным. А вторая используется для загрузки курсора, соответствую- 
щего стандартному курсору «Рукописный ввод». Дело в том, что в стандарт- 
ной схеме курсоров моего У\У/1т4о\з такой курсор отсутствует, хотя соответст- 
вующий ему файл в каталоге У\У/то\з есть. Конечно, можно было бы в окне 
Мышь (рис. 2.6) назначить этот файл курсору. Но я решил отказаться от этого и 
загрузить файл программно, чтобы показать, как это можно делать. 

Глобальные переменные [115%Сиг и [18 Аш используются в коде для  кране- 
ния полных имен файлов, связанных со списками СошбоВохСиг и СотБоВох- 
Ап. Массив Сиг элементов типа ТСиг$ог содержит константы, соответствую- 
щие стандартным курсорам. Последовательность их перечисления совпадает 
с последовательностью указания файлов в схемах курсора и с последователь- 
ностью строк в списке [1$Вох1. 

Обработчик ЕогтСгеже события ОпСгеже формы заполняет все списки 
приложения. Сначала с помощью функции Се\Утдом$О/гесогу определяется 
каталог \У/т4о\мз. Затем в переменную Ойи'Сиг$ог заносится путь к подкаталогу. 
Ситгзогз, содержащему файлы курсоров. Следующий оператор И проверяет 
с помощью функции ЕЙеЕх!15 5, имеется ли в этом подкаталоге файл реп_г.сиг, 
обычно использующийся для курсора «Рукописный ввод». Если имеется, то он 
загружается функцией ГоааСиг5огЕготЕЙе и регистрируется с индексом 
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МуРеп. Если файла нет, то в этот индекс заносится курсор по умолчанию 
сг)е{аи Е. | 

Затем следует группа операторов, обеспечивающих загрузку имен файлов 
курсоров в списки СошБоВохСиг, [15Сиг, СотБоВохАш, [15 Аш. Поиск всех фа- 
лов, имеющихся в каталоге ОСиг$ог, ведется функциями Еш@Е!и$, Ета Мехё, 
Еш9ю$е. Если расширение файла, выделяемое из имени функцией Ехгас А 1- 
1еЕхё и приводимое к верхнему регистру функцией ОррегСа$е, равно «.СОВ», 
то полное имя файла заносится в список 145 Сиг, а имя без расширения зано- 
сится в выпадающий список СотоВохСиг. При расширении «.АМГ» имена за- 
носятся в списки 118 Аш и СотБоВохАш. После формирования списков их ин- 
дексы Кеш л4ех задаются равными нулю. На всякий случай предварительно 
проверяется, имеется ли в списке хоть один элемент. Если нет, то соответст- 
вующих файлов курсоров на компьютере нет, и список делается недоступным. 

Следующая группа операторов заполняет список схем курсоров СотфоВох$®. 
Создается переменная ге? класса ТКезгу, которая используется для доступа 
к реестру. Сначала делается попытка открыть в реестре ключ НКЕУ 1ОСАЕ МА- 
СНИМЕ\ ЗОЕТМ/ИАКЕ\ МсгозоН\ М/таомиз\, Сиггег!Уегзюп\ Сопо! Рапе!\ Сигзогз\ ЭсЙе- 
тез. В этом ключе в \У/п4ом\мз МТ\2000\ХР записаны параметры схем курсоров 
(см. разд. 2.4.6). Если попытка открыть этот ключ заканчивается неудачей, 
то возможно, что на данном компьютере установлен \1т14о\з 9.х, в котором 
аналогичная информация содержится в ключе НКЕУ СОККЕМТ ЧЗЕК\ Сопнго 
Рапе!\ Сигзогз\ Эспетез. Тогда делается попытка ‘открыть этот ключ. Если и она 
заканчивается неудачей, то пользователю выдается соответствующее сообще- 
ние и список СотБоВох$ делается недоступным. 

Если ключ, содержащий сведения о схемах курсоров открылся, то с помо- 
щью метода СеГУашеМатез объекта ге? в список СошфБоВохЗ заносятся имена 
всех параметров ключа, т.е. имена схем курсоров. Далее для каждой схемы, 
т.е. для каждой строки списка СошфоВох%, надо сформировать список файлов 
курсоров данной схемы. Это делается в цикле ог. В переменную %1 заносится 
значение очередного параметра — перечень файлов очередной схемы курсо- 
ров. Если первый символ перечня кавычки, то этот символ стирается с помо- 
щью функции-элемента Зи 6 ЗН те класса Ап тг. Затем создается новый 
объект ЭсВете класса Т$т?Тл$, в который будут заноситься имена файлов пе- 
речня. В цикле уе из строки $1 поочередно вырезаются фрагменты, предше- 
ствующие символам запятых, и заносятся в список ЗсВете. В заключение объ- 
ект Зспете заносится в список СотБоВох$ как объект, связанный со строкой 
этого списка. 

Последняя группа операторов определяет активную схему курсоров, уста- 
новленную в системе. Для этого открывается ключ реестра НКЕУ_ СОЕК- 
КЕМТ_ЧЗЕК\ Сопно! Рапе!\ Сигзог$, и читается параметр без имени, содержащий- 
ся в этом ключе. Если значение этого параметра является пустой строкой, 
то в метку ГЗспет заносится сообщение, что нет схемы, установленной 
по умолчанию. Если же значение параметра без имени не пустое, то в метку 
Г. 5свет заносится имя схемы, в списке СошЪоВох$ выделяется строка, соответ- 
ствующая этому имени. 

Последние операторы функции ЕогтСгеже выделяют первую строку спи- 
ска стандартных курсоров 118Вох1, и вызывают функцию 115 Вох ФЫСИШсК — 
обработчик двойного щелчка на строке этого списка. Таким образом, при от- 
крытии приложения будет отображен первый курсор схемы, установленной 
по умолчанию. 
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Функция ЕогтС]озе является обработчиком события ОпСюо$зе формы. 
В этом обработчике память освобождается от объектов 14$ Сиг и Аш. 

Практически одинаковые с точностью до имен списков функции 
СошроВохСигС1о$еОр и СотБоВохАтС1о$е0р являются обработчиками событий 
ОпСюо$еОр списков СотБоВохСиг и СошроВохАт. Так что рассмотрим только 
один из этих обработчиков — СотБоВохСигС1о$еОр. Его задача — отобразить 
курсор, который выбрал пользователь в списке СотшБоВохСиг. Полное имя 
файла этого курсора лежит в списке 115$Сиг под тем же индексом, который вы- 
бран в СотБоВохСиг. Файл загружается функцией ГоадСиг$огЕгот Е Йе и реги- 
стрируется в свойстве Сиг$ог$[МуСиг$] объекта %$сгееп. Затем курсор заносится 
в свойство %сгееп->Сиг$ог, что обеспечивает его отображение. Два следующих 
оператора обеспечивают изображение курсора на канве компонента ГПтаге1. 
Первый оператор методом ЕШВесё очищает канву от прежнего изображения. 
Новое изображение заносится на канву функцией ОгауТсопЕх (см. разд. 2.4.5 
и гл. 8). Первым аргументом в функцию передается дескриптор канвы. Второй 
и третий аргументы задают положение левого верхнего угла изображения — 
на два пикселя ниже и правее соответствующего угла клиентской области 
Ппаре1. Четвертый аргумент — пиктограмма курсора. Следующие два аргу- 
мента задают ширину и высоту изображения — на 4 пикселя меньше ширины 
и высоты Ппазе1. В результате изображение будет увеличено, так как размер 
курсора обычно 32 х 32 пикселя. Следующий нулевой параметр при отображе- 
нии статического курсора игнорируется, а при отображении анимированного 
курсора задает рисуемый фрейм — первый. Два последних аргумента задают 
кисть и нулевой флаг, обеспечивающий учет заданных размеров изображения. 

Последние операторы функции задают текст метки ГЕЙе2 и стирают текст 
метки Е Ее. 

Функция Вийоп1СИсК является обработчиком щелчка на кнопке Курсор. 
Операторы этого обработчика во многом повторяют соответствующие операто- 
ры описанных ранее функций, так что вряд ли нуждаются в дополнительных 
пояснениях. | 

Функция И%&Вох1РЫСИск является обработчиком двойного щелчка 
на строке списка 11$ Вох1. В переменную 1 заносится индекс строки, выделен- 
ной в 118 Вох1. Напомню, что этот индекс определяет тип стандартного курсо- 
ра. А форма этого курсора зависит от того, какая схема курсора выделена 
в данный момент в списке СошЬоВох$. Соответствующая строка схемы имеет 
объект ОБ]есё5 — список файлов, отображающих курсоры схемы. Файлы зане- 
сены в той же последовательности, в которой обозначения курсоров пользова- 
тель видит в списке [15 Вох1. Так что индекс 1 строки в [1% Вох1 одновременно 
является индексом строки с именем файла, относящегося к данному курсору, 
в списке, связанном со схемой, выбранной в СотфоВох». Если строка с именем 
файла пуста, значит, для этого курсора в схеме файл не предусмотрен. Тогда 
надо по умолчанию отображать стандартный курсор. Может также оказаться, 
что в списке файлов число строк меньше, чем в списке [15Вох1. Это значит, 
что для остальных курсоров также надо отображать курсоры по умолчанию. 
Наконец, может оказаться, что список схем СотЪоВох$ пуст. Тогда для всех 
курсоров надо отображать изображения по умолчанию. 

Все эти варианты учитываются в функции [15 Вох ФЫСИскК. Оператор И 
проверяет, заполнен ли список СошБоВох$ (не равен ли его индекс Нет тдех 
отрицательному числу), и не меньше ли значение 1 числа элементов в объекте 
Оес5, связанном с выделенной строкой списка СотБоВох$. Если оба эти ус- 
ловия выполнены, то в метку Г.Е Ше заносится соответствующая строка из спи- 
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ска файлов строки, выделенной в СотБоВохз. Затем проверяется, не пуст ли 
текст в ЕЕе, т.е. указано ли имя файла курсора. Если указано, то, как 
и в ряде рассмотренных выше функций, файл загружается и регистрируется 
в свойстве Сиг$ог$ с индексом МуСигз$. Если же хотя бы одно из перечисленных 
условий нарушено, значит, файл для курсора не указан. В этом елучае в свой- 
ство Сиг5ог$[МуСиг$]| надо занести стандартный курсор. Индексы стандартных 
курсоров занесены в массив Сиг в той же последовательности, в которой эти 
курсоры представлены в [1$ Вох1. Так что занесение стандартного курсора в 
Сиг5ог$[МуСиг$] осуществляется оператором: 


Зсгееп->Сиагзог$ [МуСаг$] = $сгееп->Сагзог$ [Саг [11$&Вох1->Т6епшТпаех]]; 


Описанные операции регистрируют с индексом МуСиг$ курсор из файла 
или стандартный курсор. А далее этот курсор отображается пользователю 
теми же способами, которые описаны ранее для других обработчиков событий. 

Осталось рассмотреть только одну функцию кода — И%®Вох1ОгамКещ. 
Список [1% В0х1, как показывает рис. 2.7, отображает не только текст, 
но и изображения стандартных курсоров. Чтобы это можно было делать, свой- 
ство 5 списка 11$ Вох1 задано равным №ОупегОгау хе, что обеспечивает 
генерацию событий ОпОгауЦешт, обработчиком которых является функция 
[1$ Вох1ОгауЦет. В этой функции можно отобразить на канве компонента то, 
что увидит пользователь — текст и изображение курсора. Параметр Ш4ех 
функции указывает индекс прорисовываемой строки списка. Параметр Вес 
указывает область канвы, предоставленную данной строке. Остальные пара- 
метры функции в коде не используются. Высота каждой строки списка (свой- 
ство ЦешНерв( компонента [1${Вох1) задана равной 36 — на 4 пикселя больше 
высоты изображения стандартного курсора. 

Первый оператор обработчика [15$ Вох1ОгауЦет выводит на канву методом 
Тех Оце( текст строки. При этом делается отступ на 2 пикселя от левой границы 
области строки и на 4 пикселя от верхней границы. Следующий оператор 
функцией Ога\[сопЕх выводит изображение курсора. Точка левого верхнего 
угла изображения задается с отступом на 34 пикселя от правой границы облас- 
ти, выделенной под строку. Это обеспечивает выравнивание изображений кур- 
соров в строках — все они размещаются друг под другом. 


Описанное приложение призвано только продемонстрировать основные 
операции с курсорами и схемами курсоров. Его нетрудно было бы дополнить 
возможностями формирования пользователем собственной схемы курсоров и 
фиксацией этой схемы в реестре. Это не сделано, так как подобные операции, 
пожалуй, проще осуществлять средствами М/тдо\жз. 


2.5 Порты 


2.5.1 Настройка порта 


Работа с последовательным (СОМ) или параллельным (ГРТ) портом требу- 
ется, если компьютер используется в какой-то системе управления, должен 
принимать сигналы от внешних датчиков и, после их соответствующей обра- 
ботки, выдавать сигналы для исполнительных устройств. Задача приема сиг- 
налов через порты возникает также в различных информационных системах, 
в которые информация поступает от внешних источников. 
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Работа с портами в АРТ \/1п4о\з строится так же, как работа с файлами. 
Порт открывается как файл с помощью функции Сгезже Е Ше. О ней подробно 
рассказано в разд. 6.7.1. При работе с портами ряд параметров этой функции 
не используется. Так что применительно к открытию порта ее объявление 
можно представить в упрощенном виде: 

// синхронный режим чтения и записи 

НАМОТЕ СгеафеЕ11е (ТРСТЗТВ 1рЕ11еМаме, ОМОВКР амрез1геаАссез$, 

0, МОЬЪ, ОРЕМ ЕХТЗУТТМС, 0, М0); 
// асинхронный режим чтения и записи - фоновая обработка 
НАМОТЕ СгеакеЕ11е (ГРСТЗТВ 1рЕ11]еМаме, ПОМОВКО амрез1гедАссез$, 


0, МОЬЬ, ОРЕМ_ЕХТЗТТМС, 
ЕТЬЕ ЕЬАС ОУЕВЪАРРЕР, МОГ); 


Параметр 1рЕПеМаше содержит имя открываемого порта. Для последова- 
тельных портов используются имена "СОМ1”, "СОМ?2” ит.д., а для параллель- 
ных — "ГРТ1”, "ГРТ2” и т.п. Однако невозможно открыть порт, к которому 
подключена мышь, принтер и другие устройства. Впрочем, порт, используе- 
мый модемом, открыть можно, если он в данный неактивен. 

Параметр 4мОезге4Аессе$$ определяет флаги доступа к порту. Он может 
содержать комбинацию следующих флагов: 


о 


Разрешает опрашивать атрибуты порта. 
 СЕМЕВТС_ВЕАР 


| Разрешает чтение. 


| 
‚ Разрептает запись. 


Комбинация флагов с помощью операции ИЛИ позволяет открыть порт 
одновременно и для записи, и для чтения. 

В случае успешного выполнения функция СгезеЕ Це возвращает дескрип- 
тор порта. Успешность выполнения можно проверить с помощью функции 
Се Таз Еггог. | 

После завершения работы с портом он должен быть закрыт функцией 
СозеНап4е: 


ВОО С1озеНапа1е (ТМ ООТ НАМРЬЕ ВОБ)ес®); 


Таким образом, работа с портом организуется по следующей схеме: 
НАМОЬЕ роге; 


роге = СгеафеЕ11е ("СОМ1", СЕМЕВТС_ВЕАР | СЕМЕВТС ИВТТЕ, 
0, МОЬЬ, ОРЕМ_ЕХТЗТТМС, 0, МОБ); 

<настройка порта> 

<чтение/запись> 


С1озенапа1е (рог®); 


Первый из приведенных выполняемых операторов открывает порт СОМ1 для 
чтения и записи в синхронном режиме. Последний оператор закрывает порт. 

Если вы работаете с последовательным портом, то после того, как он от- 
крыт, можно получить информацию о его параметрах с помощью функции 
Се Сотшт {$ ае, объявленной в файле Итбазе.й следующим образом: 


ВОО СееСопм5фафе (ТМ НАМОРЪЕ ВЕ11е,ООТ ГРОСВ 1ррСсв); 


Параметр ВЕИе — дескриптор порта, а параметр 1рОСВ определяет струк- 
туру типа ТОСВ, в которую функция СеСотт${же заносит информацию. 
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Как будет показано позднее, такой же тип структуры используется и при на-. 
стройке порта. Описывать все поля этой структуры в рамках данной книги не- 
возможно, так как это требует погружения в тонкости организации работы 
порта. Поэтому ограничусь только теми полями, значения которых чаще всего 
интересуют пользователя и которые он может изменять при настройке порта, 
не погружаясь в особые тонкости. 

Поле Ваид4Ва{е определяет скорость передачи данных в битах в секунду 
(бпс). Это целое число, которое можно указывать или непосредственно, или 
с помощью констант СВВ 110, СВВ_ 300, СВВ 600 ит.д. (полный перечень их 
см. в гл. 8). Например, если значение Ваи4Ва&е можно задать равным 14400, 
или равным СВК 14400. Результат будет одинаковым. 

Поле Вуёе512е определяет число битов данных в передаваемых и прини- 
маемых байтах. Это поле может иметь значения 4, 5, 6, 7, 8. Впрочем, не все- 
гда все перечисленные значения допустимы. 

Поле РагЦу задает схему контроля четности. Оно может принимать сле- 
дующие значения (константы объявлены в файле илтбазе.й): 


| Константа —__ Значение _ Описание __ __ 
'МОРАЩНТУ 0 __ | Отеутетвие бита четности 
ОБРРАВТТУ —_ 1 __ Дополнение до нечетн0ости | 
'ЕРУЕМРАМТУ {2 __ | Дополнение до четности 
`МАВКРАВИТУ — |3 ПИ Бит четности всегда равен 1 о 

| | ЗРАСЕРАВТТУ .4 1 Бит четности всегда равен 0 


Поле ЗФорВЁ$ задает число стоповых бит. Оно может принимать следую- 
щие значения (константы объявлены в файле идтбазе.П): 


Значение Описание . | 
ИН Ко... ИИ | 
1 __ | Полтора бита _ 

12 _ | Два бита с И | 


Поле Еу&СБВаг задает символ, приход которого генерирует некоторое собы- 
тие. Этот символ может использоваться в описанном позднее асинхронном ре- 
жиме работы. 

При ошибке выполнения функция СеСоштшт${аёе возвращает Ёа]зе. 
А если ошибки не произошло, функция заполняет структуру 1рОСВ типа 
'ТОСВ текущими параметрами настройки порта. Далее можно изменить значе- 
ния элементов этой структуры и передать новые значения параметров в порт 
с помощью функции ЗеСотт Эф афе: 


ВОО 5е Сопибфаее (ТМ НАМОЪЕ ВЕ11е, ТМ ГРОСВ 1ррсвВ); 


Параметры этой функции тождественны параметрам функции дСеСотт- 
Эфже. В случае неудачи функция возвращает #а15е. Неудача может быть свя- 
зана с заданием недопустимых значений для данного порта. Например, задан- 
ное значение Ваи4Вае может превышать допустимое. Или может быть задано 
недопустимое число бит данных в поле Вубе$12е. 
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Приведем пример применения рассмотренных функций. На диске, прило- 
женном к книге этот пример реализован в каталоге Рог; в проекте РРо!. 
Окно приложения, позволяющего настроить параметры выбранного пользова- 
телем последовательного порта, показано на рис. 2.8. Точнее, к рассмотрен- 
ным выше функциям относится левая панель формы. В расположенном вверху 
формы выпадающем списке Порт (его имя в приведенном далее коде 
СошфоВох1) содержится список доступных на компьютере последовательных 
портов. В нем пользователь может выбрать порт, о котором он хочет получить 
информацию или который хочет настроить. Кнопка Чтение параметров 
(ВиНКоп1) позволяет прочитать параметры порта в выпадающие списки 
СотшБовВох в левой панели. Пользователь может изменить значения в этих спи- 
сках и, щелкнув на кнопке Установка параметров (ВиЙоп2), занести изменен- 
ные параметры в порт. 


Рис. 2.8 |.“ Последовательные порты 


Приложение, демонстрирующее | Порт [С0мз м 


настройку порта 


`— гИнтерваяы времени (мс} 


: 


| 

Скорость передачи Между символами при чтении | 

[115200 "| | [20 

Бить! данных о | Чтение 

[8 а 
| 

Четность | 


[Нечет ы 


Множитель Константа 


Запись 


| 
Стоговые биты Множитель Константа 
Г 


Го [2000 | 


о -Щ+ 


Установка параметров | 


Рассмотрим сначала компоненты этого приложения. Во всех выпадающих 
списках СопфоВох свойство 5&е равно с$ОгорОо\/п[1$%, чтобы пользователь 
не мог ввести по ошибке недопустимое значение параметра. В списке Скорость 
передачи (его имя в коде СВВаи4 Кайе) в свойство Цетб занесены строки, со- 
держащие все возможные значения поля Вап@Вае структуры типа ТОСВ: 


110 
300 
600 
1200 
2400 
4800 
9600 
14400 
19200 
38400 
56000 
57600 
115200 
128000 
256000 


В списке Биты данных (СВВубе512е) в свойство Цетзб занесены строки, со- 
держащие возможные значения поля Вубе$ те: 
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со 1 © (п н 


Строки свойства Цетз списка Биты данных (СВРагЦу) содержат описания 
различных значений поля РагЦу: 


Нет 
Чет 
Нечет 
Маркер 
Пробел 


Аналогично строки свойства Цетз списка Стоповые биты (СВорВи$5) со-. 
держат описания различных значений поля 5$орВЁ5: 


1 
1,5 
2 


Последовательность строк во всех списках соответствует последовательно- 
сти значений констант, приведенных выше для обозначений различных значе- 
ний полей. Так что индекс строки в списке совпадает со значением константы. 
Это используется в приведенном далее коде. 

Осталось сказать, что в кнопке Установка параметров (Ви Йоп2) в исходном 
состоянии свойство Епае4 равно Ё#а]5е, так как до того, как загружены теку- 
щие параметры порта, изменять их и заносить в порт не допускается. 

Ниже приведены фрагменты кода этого приложения, относящиеся к рас- 
смотренным функциям. 


НАМОЬЕ рогЁ; 
ТРЬСВ 1рЬСсВ; 


у01Я __Еазеса11 ТЕГогш1: :ЕогиСгеа*е (ТОБ]есЕ *5епаег) 
{ 
1106 1; 
Ап$156гапа 5 = "!"; 
бега ЕЕхгког (0); 
1 = 1; 
\р1]е (1) 
{ 
$ = "СОМ" + ТроЕТобЕк (1); 
роге =Сгеа®еЕ11е ($.с зег(), СЕМЕВТС _ВЕАР | СЕМЕВТС ИВТТЕ, 
О, МОЬЬ, ОРЕМ ЕХТЗТТМС, 0, МОЬЬ); 
1Е (СееТазЕЕхгког () == 0) 
{ 
СомроВох1->ТЕемз->Ааа ("СОМ" + ТрЕТоЗЕкг (1)); 
1++; 
С1о5еНапаТе (рог%); 
} 
е1зе БгеаКк; 
} 
СотроВох1->ТЕетмТпаех = 0; 
роге = 0; 


у01А _ Еаз®са11 ТГогм1: :ЕогаС1озе (ТОБ)есЕ *бепаек, 
ТС1озеАсе1оп &АсЕ1оп) 
{ 
1Е (рокЕ != 0) 
С1озеНапа1е (рог\); 
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У01Аа __Еаз®са11 ТРогт1 : : Ви 60п1С11сКк (ТОБ]есе *$епаек) 
{ 
1Е (роге == 0) 
роге = Сгеафег11е (СопроВох1->Техе.с_з%г(), 
СЕМЕВТС ВЕАР | СЕМЕВТС ИВТТЕ, 0, 
МОГ, ОРЕМ ЕХТЗТТМС, 0, 0); 
1Е(! СесСопмбфаее (роге, &1рроСсвВ)) 
{ 
зпомМе$заае ("Не удалось открыть порт " + СопроВох1->Тех®); 
ех1{; 


} 


СВВацЧАКа$е->ТфетТпаех = СВВапаКаке->Т$&ептз->ТпаехоЕ ( 
ТпЕТозег (1рросСВ.ВачаКаее)); 
СВРаг1®у->Т®етшТпаех = 1ррСВ.Раг1®у; 
СВВуфе512е->ТЕетТпаех = 1рроСсВ.Вувеб1те - 4; 
СВ5$орВ1*$->ТкетТпаех = 1рросвВ.5®орВ1%$; 


Ви боп2->Епаб1еа = +гие; 


у01А __Еаз&са11 ТГоги1: : Ва ®оп2С11сК (ТОр)ес®е *5епаег) 
{ 
1росВ .ВацЯаВаее = 5егТоТпе (СВВацЯВа*е->Тех\); 
1рросвВ.Вубе51хе = СВВубеб51хе->ТеетТпаех + 4; 
1ррсСвВ.Раг1ку = СВРаг16у->ТфепшТпаех; 
1рросвВ.56орВ16$ = СВ5&орВ1$$->ТеетТпаех; 


1Е (!бееСошмбЕафе (роге, &1рроСсВ)) 
{ 
бСВомМеззаае ("Значения параметров недопустимые \п" 
"Установка не произведена"); 
Вас еоп1С11сК (5епаег); 
_ @х1%; 
} 


Ва оп1С11сКкК (бепаег); 


Уу01А __Еаз®са11 ТКогп1 : :СопроВох1С1о5е0р (ТОБ)есе *5епаег) 
{ 

Ви боп2->ЕпаЪ1е = Еа]1зе; 

1ЁЕ (роге !=0) 

{ 


СВВацЯВафе->Т$епш{Траех = -1; 
СВВуке51те->ТеемТпаех = -1; 
СВРаг1$у->ТкетТпаех = -1; 

СВ5ЕорВ1*$->ТеемТпаех = -1; 


С1озеНапа1е (рог®); 
роге = 0; 
} 

} 

В приведенном коде вводятся две глобальные переменные: рог — деск- 
риптор порта, и 1рОСВ — структура типа ТОСВ. Функция ЕогтСгез{е являет- 
ся обработчиком события формы ОпСгезфе. В ней список СотфоВох1 заполня- 
ется именами последовательных портов. В цикле мВШе последовательно вызы- 
вается функция СгеавеЕ!е для портов “СОМ1“”, “СОМ?” и т.д. Параметр 
Ч\Сгеайоп 15 `фийоп в вызове этой функции равен ОРЕМ_ЕХТУТИМС — от- 
крытие существующего порта. После каждого вызова функцией Се Та Еггог 
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проверяется наличие ошибки. Если ошибки нет, имя порта добавляется в спи-. 
сок СошфоВох1, а порт закрывается функцией С]озеНап Ше. После первой же 
ошибки открытия порта цикл прерывается. Переменной рог задается нулевое 
значение. Перед циклом возможное состояние ошибки от каких-то предыду- 
щих операций сбрасывается на 0 функцией Зе Га$&Еггог(О. 

Следует отметить, что получить список портов можно было бы иначе, вос- 
пользовавшись тем, что имена последовательных портов хранятся в реестре по 
ключу НКЕУ [ОСА МАСНИМЕ| НАЮРУ/АКЕ\ РЕМСЕМАР\ ЗЕМА(СОММ. В этом 
ключе`имена портов — значения параметров. Так что процедуру ЕогтСгеафе 
можно было бы осуществить так: 


#1пс1аае <гед1$егу.Брр> 


у01А __Газ®са11 ТЕогп1:;: : КогиСгеа®е (ТОр]есЕ *5епаехг) 


{ 
ТВед1з6гу* Вед = пем ТКеа1зекгу; 
1Т56г110911$6е %*Г156Е = пем Т5Ег1пар1$6; 
106 1; 

Ап$15ег1па м; 


Веч->ВооЕКеу = НКЕУ ТОСАТ, МАСНТМЕ; 
Вед->ОрепКеу ("НАВРИАВЕ\ \РЕУТСЕМАР\ \ЗЕВТАЬСОММ", Еа1зе); 
Вед->Сбее\Уа1аеМамез (Т1$%); 
Еог (1 = 0; 1< 11$Е->СоопЕ; 1++) 
у Вед->Кеаа5г1па (11$6->5Ег1па$ [1]) . беефепоаеР (3); 
1Е (м.бееьепаей (3) == "СоМ") 
СопроВох1->Тфет$->Ааа (Ведз->Кеаа$ Е г1па (11$6->56:и1п9$[1])); 
 вк->Етее () 
Вед->С1озеКеу (); 
Вед->Егее (); 
СопроВох1->ТеепТпаех = 0; 
роге = 0; 

} 

Этот вариант имеет определенные преимущества по сравнению с приведен- 
ным ранее, если по каким-то причинам порты нумеруются не по порядку, а 
с пропусками в нумерации. 

Попутно отметим, что в реестре по ключу НКЕУ_ [ОСАЕ _МАСНИМЕ\ НАКО\У/АБЕ\ 
ОЕМСЕМАР\ РАКАЦЕЕ РОКТ$ аналогичным образом хранятся имена параллель- 
ных портов. 

В обработчике ЕогтС1озе события формы Оп(С]озе проверяется по значе- 
нию переменной рог, был ли открыт в приложении какой-либо порт. Если 
был, то он закрывается функцией С1озеНапе. | 

Функция ВиНоп1СИсК является обработчиком щелчка на кнопке Чтение поа- 
раметров. Если в данный момент нет открытого порта (рог = 0), то функцией 
СгежеЕЦе открывается порт с именем, выбранным в списке СотфоВох1. Далее 
функцией Се Сотт5файе структура 1рОСВ заполняется параметрами порта. 
При этом проверяется возвращаемое этой функцией значение. Если возвращено 
{а]5е, пользователю выдается сообщение о невозможности открыть порт. 

При успешном выполнении функции Се Сотшт5{фае в выпадающих спи- 
сках выделяются строки, соответствующие параметрам порта. При этом ис- 
пользуется оговоренное ранее условие, что индексы строк в списках соответст- 
вуют численным значениям соответствующих полей. Только в списке 
СВВу4еб1те индексы на 4 меньше, чем значения поля Вуеб1те, что и учитыва- 
ется в приведенном коде. 


158 Глава 2. Работа с устройствами 


После занесения в списки всех значений кнопка Установка параметров де- 
лается доступной. Теперь пользователь может изменить значения параметров 
в списках и установить новые настройки порта. 

Функция ВиН_оп2СПеК является обработчиком щелчка на кнопке Установ- 
ка параметров. В ней значения параметров, заданные пользователем в выпа- 
дающих списках, переносятся в поля структуры 1рОСВ. Затем вызывается 
функция Зе Сотт же, заносящая новые настройки в порт. Если вызов 
функции завершился ошибкой, пользователю выдается соответствующее сооб- 
щение и вызывается описанная ранее функция ВиЙ_оп1СИеК, чтобы восстано- 
вить в выпадающих списках прежние значения параметров. 

Функция СошБоВох1СВапее является обработчиком события ОпСВвапге 
списка СошфоВох1, в котором сдержится имя порта. Операторы этой функци- 
ей очищают данные в списках, поскольку они относятся к прежнему порту, за- 
крывают прежний порт и делают недоступной кнопку Вивоп2. 


Мы рассмотрели настройку основных параметров порта. Но работа порта 
характеризуется еще рядом параметров, определяющих максимальное время, 
отводимое на операции чтения и записи. Эти параметры определяют тайм-аут 
({1пеоц$) — интервал времени, в течение которого функции записи и чтения 
ожидают появления новой информации. Если это время истекает, чтение или 
запись прерываются. 

Получить информацию о временных параметрах порта можно функцией 
Се СотшшТИпеоц&$$: 


ВООТ, СееСоптТ1теоце$ (ТМ НАМОЬЕ БЕ1Те, 
ООТ ЬРСОММТТМЕООТ$ 1рСопиТ1меочез$); 


Параметр ВЕПе является дескриптором порта, а рСошштТипеоц $ — ука- 
затель на структуру типа ТСотт'Типеоц$, содержащую следующие поля: 


Описание 


' ров ВКеа4Пцегуа!|- Максимальное время, допустимое между двумя 
'Грпеоц | последовательными символами, считываемыми 
с коммуникационной линии. 


. и 


О\ОКО Веа4То{а1Т1теоц- 
Ми ШрЦе _ 


| ОУОВО КВеа4Тоёа!Т!пеочц+- 
'Соп$фапё 


Г ОО 


| ОУ\УОВО УгцеТо{а1Типео- 
и Ми рег 


| рУОВО \М’гЦеТо$а!Типео- |Константа, используемая для вычисления обще- 
 а6Сопзфапй го тайм-аута операции записи. 


Множитель, используемый для вычисления 06б- 
щего тайм-аута операции чтения. 


Константа, используемая для вычисления обще- 
го тайм-аута операции чтения. ‘` 


Множитель, используемый для вычисления об- 
щего тайм-аута операции записи. 


Значения всех полей указываются в миллисекундах. Поле КеаАП\цегуа1- 
Тлеоц{ определяет максимальный интервал между двумя последовательны- 
ми символами, точнее, между началами передачи двух символов, включая 
время передачи самого символа. Если интервал между символами превысит 
заданное значение, операция чтения завершится и все данные, накопленные 
в буфере, передадутся в программу. Нулевое значение данного поля означает, 
что данный тайм-аут не используется. Если же в этом поле задать значение, 
соответствующее МАХОУ\УОВО (42949617295) и одновременно задать нулевые 
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значения полей ВКеа4То&а1Типеоп( Соп$&вап{ и ВеадТоёа!Типео0 Ми рПег, то 
операция чтения немедленно завершится и вернет уже принятый символ, 
даже если ни одного символа не было получено из линии. 

Во время операции чтения временной период начинает отсчитываться 
с момента приема первого символа. Общий интервал времени на операцию чте- 
ния рассчитывается как произведение значения ВКеа4Тофа1Типеоп Ми рПег 
на количество запрошенных символов М, и к этому произведению добавляется 
значение ВеадТо{ёа1 Типео{Соп${апё: 


№ . ВеаЧЯТофа1Т1теоч*Мо1*1р11ег + ВеаЧТо*а1Т1теоч®Сопзбап® 


Пусть, например, вам требуется прочитать 100 символов при скорости 
порта 12000. И пусть на каждый символ используется 8 бит данных, бит до- 
полнения четности, стоповый бит и стартовый бит — итого 11 бит на символ. 
Значит, на всю операцию чтения требуется 100 : 11 / 12000 секунд или 93 мил- 
лисекунд. К, этому времени надо прибавить 99 интервалов между импульсами. 
Например, если средний ожидаемый интервал между окончанием одного и на- 
чалом следующего символа равен 1 миллисекунде, то на всю операцию чтения 
потребуется 93 + 99 = 192 мс. Для решения подобной задачи можно задать 
ВеаЧП\фегуа|Т!иптеоц{ = 4 мс (в 2 раза больше среднего значения, складываю- 
щегося из времени передачи символа и промежутка между ними). Значение 
ВБеаЧТоё а! Типеоп (Ми рНег можно установить равным 2 мс, и задать ка- 
кое-то значение ВеаАТо&а!Типеоц{Соп$&ап{ в качестве страховки от возмож- 
ных колебаний скорости чтения. В результате в нашем примере общее время 
может составить, например, 300 мс. Если операция чтения выполняется доль- 
ше, разумно предположить, что это вызвано какими-то ошибками внешнего 
устройства. В этом заключается смысл задания тайм-аута: через заданный ин- 
тервал времени считывание прекратится и тем самым можно будет избежать 
возможного «зависания» программы. При этом будут возвращены символы, 
прием которых завершился до истечения тайм-аута. Остальные символы мож- 
но получить следующей операцией чтения. Если между началами двух после- 
довательных символов пройдет более 4 миллисекунд, то операция чтения так- 
же будет завершена. 

Параметры Е\тцеТтоаТипео (Ми рПег и Е\гцеТофа!ТГипеоц Сопзап{ 
аналогичны параметрам ЕВеа4Тофа!ТипеоМирИег и ЕВеа4Тофа!Типеоц{- 
Сопзбапф, но относятся к операции записи. 

Рассмотренная функция бе Сотт'Т!Ипеоц&$ позволяет определить теку- 
щие временные параметры порта. А функция Зе СоттТипеоц $ устанавлива- 
ет эти параметры порта: 


ВООТ, Зе СопиТумеоце$ (1М НАМОЬЕ ВЕ+1Те, 
ТМ .ГРСОММТТМЕОЧТ$ 1рСопмТ1меоо*з$); 


Теперь можно расширить предыдущее приложение, введя в него возмож- 
ность настройки временных параметров. На рис. 2.8 в правой панели располо- 
жены окна редактирования, отображающие и задающие эти параметры. Их 
имена в приведенном далее коде ЕВеааПфегуа'Гипеоп$, ЕВеаЧТо{фа]Типеоц{- 
Ми ИрПег, ЕВеа4Тофа!Г1пеои{Соп$ {ап  Е\УтЦцеТо{а!Гипеоп( Мо рПег, 
Е\М/гцеТоф а! Типеоп Сопз$апф. Ниже приведены фрагменты кода этого прило- 
жения, относящиеся к временным параметрам. 

НАМОГЕ роге; 


ТОСВ 1роСсв; 
ТСопиТ1тео<сез$ 1рСопиТ1теоц®$; 
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\01А _Еаз®са11 ТЕогм1: : Ва $оп1С11ск (ТОБ)]есе *бепаег) 
{ 
1Е (рог == 0) 
роге = СгеафеЁ11е (СопроВох1->Техе.с _5%г(), 
СЕМЕВТС ВЕАР | СЕМЕКТС ИВТТЕ, 0, 
МО, ОРЕМ _ ЕХТЗТТМС, 0, 0); 
1Е(! СесСопибафе (роге, &1роСсв)) 
{ 
ЗПпомМез$5асде ("Не удалось открыть порт " + СотроВох1->Техё); 
ех1{; 
} 


СВВачаВафе->ТеемТпаех = СВВацЯКа®е->1$ет$->ТпаехоЕ ( 
сееСопиТ1теоч*$ (роге, &1рСопмТ1меон*$); 

ЕВеааТпеегуа1Т1теой*- —>ТехЕ = 

ТпеТобег (]рСопиТ1теоч®$ .ВеаЧТпеегуа1Т1теоц*); 
ЕКеаЯТофа]1Т1теолЕМи1+1р11ег->ТехЕ = 

Тре Тобег (1 рСопиТ1тмеоце$ .КеаЯТофа1Т1меоцЕМи1&1р11ег); 
ЕКеаАТофа1Т1теоп®*Сопз$апЕ->ТехёЕ = 

ТпЕТобег (1рСоштТ1теочц% $ .ВеаЯТока1Т1меоплСопз*ап*); 
ЕМг1ееТофа1Т1теос{Ми1*1р11ег->ТехЕ = 

ТпеТобзекг (]1рСопиТ1теоце$ .Иг1ееТока1Т1теотЕМи1{1р11ег); 
ЕМг1$еТофа1Т1теоц®Соп$&ап®->Техё = 

ТпеТобег (1рСоммТ1теоце$ .Иг1ееТофа1Т1теочеСопз{апе); 
Ва боп2->ЕпаБ1еЧ = +гае; 


014 _ Еаз®са11 ТГогт1: : Ви $оп2С11сК (ТОБ]есЕ *5епаег) 
{ 


ску 
{ 
1рСопиТ1меоче$ .ВеаЯТптпеегуа1Т1теоц* = 
| ЗЕгТоТпЕ (ЕВеааТп$егуа1Т1теоц*->Тех*); 
]1рСомиТ1теочле$ .ВеаЯТо+а1Т1тмеолЕМи1&1р11ег = 
| ЗЕгТотТпё (ЕВеаЯТока1Т1меоч*Ми1{1р11ег->Техе); 
1рСопмТ1теоче$ .ВеаЧТофа1Т1теочеСопз$апе = 
ЗЕгТоТпЕ (ЕВеаЧТо$а1Т1лтеоц&Сопз ап*->Тех®); 
]1рСопиТ1теоц®$.Иг1сеТофа1Т1теоцЕМи]1&1р11ег = 
ЗЕгТотТпф (ЕМг1ееТофа1Т1теолЕМо1*1р11ег->Техё); 
1рСопиТ1меоце$ .Иг1$еТо$а1Т1теочеСопзвапе =. 
ЗЕгТоТпЕ (ЕМг1сеТофа1Т1меол*Сопзвап*->Тех®); 
} 


сафсй (ЕСопуег Еггог&) 
{ 
ЗпочМеззаче ("Ошибочное значение временного интервала. \п" 
"Установка не произведена"); 
ех1{; 
} 
1Е (!5бееСоптТ1теочез$ (роге, &1рСопмТ1теочез)) 
{ 
бЗпомМеззасде ("Ошибочное значение временного интервала. \п" 
"Установка не произведена"); 
ВаЕЕоп1С11сКк (бепаег); 
ех1*; 
} . 
Ви оп1С11СсК (бепаег); 


\014 _ Еаз®са11 ТГогп1 : :СопроВох1С1озе0Ор (ТОБ)есЕ *5епаег) 
{ 

Ву оп2->Епар1е = Еа1зе; 

1Е (рог® !=0) 
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ЕВеаЧТпеегуа1Т1меоц®->Техе = ""; 
ЕКеаЯТока1Т1теоч{Ми11р11ек->ТехЕ = ""; 
ЕВеааТо$а1Т1теолЕСопзЕап®->Техе = ""; 
ЕМг1еТока1Т1теоц(Ми1%*1р11ег->ТехЕе = ""; 
ЕМг1сеТофа1Т1меоч®Сопз$ап®->ТехЕе = ""; 
С1озеНапа1е (роге); 

роге = 0; 


Вряд ли приведенный код требует каких-то комментариев. 


2.5.2 Синхронный режим работы 


Теперь рассмотрим операции записи и чтения. Обычно перед началом этих 
операций необходимо очистить буфер порта от мусора, а иногда и отменить 
выполняющуюся в данный момент предыдущую операцию записи или чтения. 
Это может осуществляться функцией РигоеСотт: 


ВОО РигдеСоти (ТМ НАМОЬЕ БЕ11е, ТМ РМОВР амЕ1ад$); 


Параметр ВЕПе является дескриптором порта, а параметр 4мЕ1а5$ указы- 
вает выполняемые операции. Он может комбинироваться операцией ИЛИ из 
следующих флагов: 


РОВСЕ_ТХАВОКТ 
Немедленно завершить все операции чтения. 


Немедленно завершить все операции записи. 
РОВСЕ_КХАВОКВТ —__ 


РОВСЕ ТХСГЕАК Очистить. в драйвере очередь передачи. 


РОВСЕ_ ВХСГЕАК Очистить в драйвере очередь приема. 


Функция РагееСотт позволяет очистить буфер от мусора, который мо- 
жет быть следствием работы какой-то предыдущей программы, и позволяет 
прервать операции чтения и записи в случае ошибки. Полезно также вызвать 
эту функцию перед завершением вашего приложения, чтобы не оставлять му- 
сор другим программам. Но надо учитывать, что очистка буфера не означает 
передачу находящихся в нем данных. Эти данные просто стираются. Если же 
надо завершить передачу данных, содержащихся в буфере, то вместо Рагее- 
Сошт надо вызывать функцию Е1а$ВЕЦеВиЁег$, которая подробно описана 
в разд. 6.7.1. Ее синтаксис: 


ВООЪ Е] азрЕ11еВаЕЕегз$ (ТМ НАМОГЕ БЕ1]е); 


Эта функция обеспечивает передачу данных из выходного буфера, и толь- 
ко после этого очищает его. 

Применение функций КеадЕ|е и УгцеЕЦе к файлам описано 
в разд. 6.7.1. В данном разделе мы остановимся на применении этих функций 
непосредственно к портам. 

Синхронный прием и передача данных осуществляется функциями Веа@- 
ЕПе и У\УгцеЕЦе, подробно описанными в разд. 6.7.1. Так что ограничимся 
только примерами передачи данных. Следующий код обеспечивает запись дан- 
ных в порт: 
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Апз15ек1па раЕ; 
1 п; 


БоЕ = "Это передаваемый текст"; 

Е1азрЕ11еВоаЕЕег$ (рог®); 

Иг1ЕеЕ11е (роге, РаЁ.с 56г(), зег1еп(РаЁ.с 56: ()), &ПМОВО (п), МЪЬ); 
ЗпомМеззаае ("Передано " + Тп®Тобег (п) + " байт"); 


В этом примере предполагается, что рог — дескриптор порта. 
Следующий код осуществляет чтение: 


Ап$156г1па раЕЁ; 


106 п; 

БыаЕ — "", 

Е] а5рЕ1 1еВаЕЕег$ (рог®); 

ВеааЕ11е (роге, РаЁ.с_зек(), 128, &рОМОВЬ (п), М0); 
ЗРомМеззасе ("Принято " + ТпЕТоЗег (п) + " байт: " + РаЕЁ); 


Учтите, что если для операций чтения не заданы временные параметры, то 
функция ВеаЯЕПе может бесконечно ожидать прихода входных сигналов. 
В этом заключается один из недостатков синхронного чтения. 

Порт можно перевести в состояние разрыва связи с помощью функции 
Зе СотштВгеаК: 


ВООТ Зе*СоппВгеак (ТМ НАМОШЕ ВЕ11е); 


При вызове этой функции передача данных прекращается, выходная ли- 
ния переводится в состояние "0", после чего и приемник фиксирует состояние 
разрыва. Возобновить прерванную передачу данных можно функцией Щеаг- 
СоттВгеаК: 


ВООЬ С1еагхСопиВгеаКк (ТМ НАМОГЕ ВЕ11е); 


2.5.3 Асинхронный режим работы 


В большинстве случаев рассмотренный в предыдущем разделе синхрон- 
ный режим работы с последовательным портом — не лучшее решение, так как 
приложение останавливается, ожидая завершения команды ввода или вывода. 
Более разумным является асинхронный режим работы с портами. В этом ре- 
жиме вы можете указать системе, какие события порта ей надо отслеживать. 
Это делается с помощью функции Зе СоттМазК: 


ВООЬ ЗееСопмМазк (ТМ НАМОЬЕ ВЕ11е, ТМ ОМОВР аАмЕхЕМазкК); 
Параметр ВЕПе, как всегда, является дескриптором порта, а параметр 


4мЕУ& МазК является маской, в которой можно указывать комбинацию сле- 
дующих событий: 


ЕУ_ВВЕАК Й — 


Разрыв приемной линии 


Т5 __ | Изменение состояния линии СТБ 
ЕУ_О5В, Изменение состояния линии ОБЗК 
ЕУ_ЕВВ 
А С __ Входящий звонок на модем о 


ЕУ_ВТЕ5О Изменение состояния линии ВНЕЗО 
ЕУ_ВХСНАВ Принят символ и помещен в приемный буфер 
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ЕУ_ ВХЕЕАС. Принят символ, заданный полем Еу&Сраг структуры типа 
| ТОСВ, использованной т при настройке порта 
Е. ТХЕМРТУ Передан последний символ буфера передачи 
Если параметр 4мЕу Ма$К в функции Зе СоттМазК равен нулю, ника- 
кие события не отслеживаются. 


Имеется функция беСотштМазК, позволяющая получить текущую маску 
событий; 


ВОО СееСоптМазк (ТМ НАМОЪЕ ВЕ11е,ООТ ЬРЬМОКР 1рЕ\ЕМазК); 


Она заносит маску в переменную, заданную параметром 1рЕ\& МабзК. 

Если вы задали маску отслеживаемых событий, то можете приостановить 
выполнение приложения до наступления события. Это делается функцией 
Ма ЦСоштЕуепЕ: 


ВООТЪ Ма1®СотштмЕуеп® (ТМ НАМОЬЕ ВБЕ1]1е,О0Т ГРРИМОВО 1рЕу%Мазк, 
ТМ ГРОУЕВГАРРЕР 1рОуег1арреа); 


В параметр 1рЕу& МазК будут заноситься флаги, соответствующие произо- 
шедшим событиям. Параметр 1рОуе арре4 является указателем на структуру 
типа ТОуеарре4. Эта структура будет рассмотрена несколько позднее. Если 
вы хотите просто приостановить выполнение до появления соответствующего 
события, параметр 1рОуег1арре4 можно задать равным МОШ.. 

Например, чтение можно организовать следующим образом: 

Ап$15Ег1па рБаЕЁ; 

106 п; | 

РИОВО 1рЕ\УЕМазк; 


зееСотмМазК (роге, ЕУ\У_ВХСНАБК); 

Ма1СопиЕуеп® (роге, &1рЕ\мЕМазк, МОТ); 

ВеааЕ11е (роге, БиЁ.с зег(), 128, &0МОВО (п), МОЬЬ);. 
ЗВомМеззасче ("Принято " + ТпЕТо5ек (п) + " байт: " + РЕ); 


В этом примере вызов функции Кеа4ЕПе произойдет только после того, 
как на входную линию придет первый символ. До этого момента не будет воз- 
врата из функции Уа {СоттЕуеп. 

Подобная организация чтения не очень улучшает ваше приложение. 
Правда, на время ожидания ресурсы компьютера освобождаются, но приложе- 
ние все равно "зависает", пока не придет входной символ. Полноценный асин- 
хронный режим, позволяющий вашему приложению работать, пока ‘осуществ- 
ляются чтение и запись, организуется следующим образом. 

В вызове функции СгежеЕЦе задается 9мЕ1а55Апд4А гие: = ЕПЕ_ 
ЕСАС_ОУЕВГАРРЕО. Вводится глобальная переменная типа ТОуеарред. 
Это тип структуры, содержащей поля ВЕуепф, Пщцегпа1, Пцегпа! Н1оВ, ОЁ5еф, 
ОРзе НВ. Мы не будем рассматривать смысл этих полей, поскольку в про- 
стом варианте, который мы сначала обсудим, значения всех полей должны 
быть равны 0. 

В вызовах функций ВеадЕПе и УгцеЕПе параметр 1рОуеарре@4 должен 
быть указателем на введенную вами структуру типа ТОуе арред. В этом слу- 
чае функции немедленно возвращают управление, и приложение может про- 
должать выполняться. Успешность запуска асинхронного чтения или записи 
можно проверить функцией Се Таз Еггог. Если эта функция вернет значение 
ЕККОК_ТО_РЕМПМС, значит, асинхронная операция стартовала успешно. 
Любое другое значение, возвращаемое функцией Се Та${Еггог, свидетельству- 
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ет об ошибке. Учтите также, что, хотя параметры рМипфегОЁ!ВуёеВеа4 
и пПМитЬегО{ВууеТо\гЦце функций ВеадЕПе и УгцеЕПе по-прежнему надо 
задавать, они не будет содержать никакой полезной информации. Поскольку 
функции возвращаются сразу, соответствующие числа всегда окажутся рав- 
ными нулю, и не будут отражать число переданных или полученных байтов. 

В дальнейшем в процессе выполнения приложения следует периодически 
опрашивать систему, чтобы получить информацию о завершении записи или 
чтения. Опрос производится функцией Се ОуещарреЯВези! (см. разд. 6.7.1). 
В вызове этой функции параметр БУ\УМаК надо задать равным #Б5е. Тогда функ- 
ция немедленно вернет управление. Если возвращенное функцией значение 
равно гие, значит соответствующая операция записи или чтения заверши- 
лась. В этом случае рМишегО!ВуеТгапЁеггед укажет число переданных бай- 
тов. Если возвращенное значение равно #5е, значит операция не завершена 
или получилась ошибка в вызове функции Се ЮОуеНарредВезше. Различить эти 
два варианта можно функцией Се Й.а$Еггог. Если она вернет ЕВВОВ ТО Т\- 
СОМРЕЕТЕ, значит все нормально, но операция не завершилась. В противном 
случае — ошибка в вызове функции СеЮуептарредВезий. 

Рассмотрим пример использования асинхронного режима работы. 

НАМОТЕ рог = 0; 

ТОСВ 1рЬСсв; 


ТОуег]арреа Оуег]арр ; 
Ап515Ег1па раЕЁ; 


\014 _ Ёаз®са11 ТЕогм1: : Ви оп1С11сК (ТОБ]есЕ *5епаег) 
{ 
1Е (рокЕ == 0) 
роге = СгеафеЕ11е ("СОМ1", СЕМЕВТС ВЕАР | СЕМЕВТС ИВТТЕ, 0, 
МОТТ, ОРЕМ ЕХТЗТТМС, ЕТЬЕ ЕТАС ОУЕВЬАРРЕО, 0); 
// чтение в 1ррСВ параметров порта 
1Е(! СееСоштбфафе (роге, &1ррСсв)) 
{ 
бРомМез$заае ("Не удалось открыть порт СОМ1"); 
ех1%; | 
} 
// настройка параметров в структуре 1рросв 


// запись параметров в порт 
1Е(!бееСопибтафе (роге, &1ррсвВ)) 
{ 
ЗВомМеззаае ("Значения параметров недопустимые \п" 
| "Установка не произведена"); 


роге = 0; 

Оуег1арр.ПЕ\хепЕ = 0; 
Оуег]арр.Тпфегпа1 = 0; 
Отег1арр.Тп®егпа1Н1ай = 0; 
О\уехг]арр.ОЕЕзек = 0; 
Оуег1арр.ОЕЁЕзеЕН1ай = 0; 


\у01А . Еаз®са11 ТЕогм1: :ГогмС1о5е (ТОБ)]ес® *5епаехк, 
ТС1озеАсЕ1оп &Асе1оп) 


{ 
1Е (роге !=О0) 


С1о5еНапа]1е (рог®); 


уо1а __ЁЕазеса11.ТЕГогм1: : Ву © оп2С11сК (ТОБ]есЕ *5епаехг) 
{ 

// процедура записи 

Ап$15©г1па 5; 

1пе п; 


5 = "Это передаваемый текст"; 
Е1азВЕ11еВиЕЕегз (рог®); 
Иг1сеЕг11е (роге, 5.с_з6к(), зег1еп(5.с $е:()), 
&РМОВР (п), &Оуег1арр); 
1Е (СестазеЕггог() != ЕВВОК_ТО_РЕМРОТМС) 
ЗВомМеззаае ("Ошибка"); | 
е1зе Т1мег1->ЕпабБ1е = сгие; 


"п | 
у01А _ Еаз®са11 ТЕогм1: : Ви боп3С11сКк (ТОБ)есЕ *5епаег) 


{ 
// процедура чтения 


10 п; 

БаЕ — ""; 

Е] а5РЕ11еВоЕЕегз (рог®); 

ВеааЕ11е (роге, БаЕ.с 56к(), 128, &ОМОВО (п), &Оуег1арр); 
1Е (СееЪазеЕггог() != ЕВВОВК ТО РЕМОТМС) | 


ЗпомМеззасче ("Ошибка"); 
е15е Т1мег1->ЕпаБ1еа = ©гие; 


у01А __Еаз®са11 ТЕогм1: :Т1мег1Т1мег (ТОр)]есЕ *5епаег) 


{ 


106 п; 


1Е (Сесоуег1арреяВези1+ (роге, &Оуег1арр, &ПМОВО (п), Еа1зе)) 
{ 


Таре11->Сар&1оп = "Получены/ переданы новые данные - " + 
ТрЕТоЗЕг (п) + " байт"; 
Т1пег1->Епар1еа = Еа15$е; 


} 


е1зе Гаре11->Сар®1оп = "Новых данных нет"; 


} 


В этом примере пропущены некоторые детали настройки порта, которые 
были подробно рассмотрены в разд. 2.5.1. Среди объявленных глобальных пе- 
ременных обратите внимание только на отсутствовавшую в предыдущих при- 
мерах переменную Оуеарр — структура типа ТОуе]арре. В функции 
РЕогшСгеа{е все поля этой структуре заполняются нулями. 

Функция ВиНоп1СПсК является обработчиком щелчка на кнопке, откры- 
вающей и настраивающей порт. Единственное отличие от ранее рассмотрен- 
ных примеров — указание флага ЕПЕ_ЕГАС_ОУЕВГАРРЕО в вызове функ- 
ции Сгеже Ее. 

Функция ВиНоп2СПИеК является обработчиком щелчка на кнопке, ини- 
циирующей запись. Сначала функцией ЕВ ЕПеВиЁег$ очищается буфер 
порта. Затем вызывается функция УтгЦцеЕ Пе, в которую последним аргумен- 
том передается адрес структуры Оуе арр. Далее функцией Се Та Еггог про- 
веряется отсутствие ошибки. Если ошибки нет, то запускается таймер Титег1, 
который введен в приложение и осуществляет периодический запрос инфор- 
мации об операциях чтения и записи. Свойство ЕпаЁе4 таймера сначала уста- 
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новлено в #а]5е, так что таймер запускается только при успешном начале вы- 
полнении процедур асинхронного чтения и записи. 

Функция ВиЙйоп3 СЦеК является обработчиком щелчка на кнопке, ини- 
циирующей чтение. Она подобна рассмотренной функции ВиЙоп2СПек. 

Функция Типег1 Тег является обработчиком события таймера ОпТитег. 
В ней вызывается функция Се Оуеарред Везо 4. Если она возвращает фгие, 
то в метку Габе1 выводится сообщение об окончании операции чтения или за- 
писи и о числе переданных байтов. Затем таймер выключается. Если функция 
Се{ОуеарреЯ Вези возвращает #а15е, то в метку Габе!1 выводится сообще- 
ние об отсутствии новых данных. 

Рассмотренная организация асинхронной записи и чтения работает в \У/т- 
4о\з МТ/2000/ХР. Если требуется создать приложение, которое работает так- 
жев У ш4до\з 98 и 95, то организовывать запись и чтение надо несколько ина- 
че. В поле ВЕуеп+{ структуры типа ТОуеарред надо заносить результат, воз- 
вращаемый функцией СгеафеЕуепё: | 

НАМОГЕ СгеакеЕуеп® (ТМ ГРЗЕСОКТТУ АТТЕТВОТЕ$ 1рЕхепеАЕЕЕ+Ьоеез, 


ТМ ВООГ БМапиа1Везе*, ТМ ВООТ, ЬТп11а15+а%е, 
ТМ .РСЗТК 1рМапе); 


Эта функция создает объект события и возвращает его дескриптор. Под- 
робнее эта функция описана в разд. 3.5 Для нашей задачи достаточно знать, 
что аргументы 1рЕуе АИгЬше$ и |рМаше в ее вызове надо задавать равными 
МОТ, а аргументы 6Мапиа!Везеё и Мп! а1$5 {же равными Ёа15е. Так что 
в приведенный выше код надо в процедурах записи и чтения добавить перед 
вызовами функций УгцеЕЦе и ВеадЕПе операторы: 


Оуег1арр.БЕуеп® = СгеакеЕуепе (МОТТ, ГЕа15зе, Еа15зе, МОЬ); 


Это единственное изменение, которое надо сделать в первых процедурах 
приведенного выше примера. А вот процедуру Типег1'ТГитег надо изменить 00- 
лее существенно. Опрос в данном случае надо делать функцией УайРогЭшо- 
1еОБесё: 


РИОВКР Ма1®Гог51па91е0Б]ес® (ТМ НАМОЬЕ ПНапаТе, 
ТМ ОМОВО АмМ11115есопаз); 


Параметр ВНап Ме является дескриптором ожидаемого события, а пара- 
метр 4иМИ[5$есоп@4$ указывает в миллисекундах максимальное время ожида- 
ния события. Если задать 4 МИ $есоп4$ = 0, функция вернется немедленно. 
А если задать аи МИ $есоп4$ = ТМЕГМТЕ, ожидание будет бесконечным (ана- 
лог синхронной операции). Функция возвращает значение \УАТТ_ОВУЕСТ 0, 
если событие произошло, \АТТ_ ТТМЕОЧТ, если истекло заданное время 
ожидания, \АТТ_ЕАП.ЕО в случае ошибки. 

В нашем примере, очевидно, имеет смысл задать Чи МИЦ$есоп 9$ = 0, что- 
бы приложение могла нормально выполняться, пока не произошло событие. 
Так что функция Т1тег1Типег может иметь вид: | 


у01А __Еаз®еса11 ТГогм1: :Т1мег1Т1мег (ТОБ)есЕ *5епаег) 
{ 
10 п; 
12 (Ма1{Гог51п91е0Ор)ес® (Оуег1арр.ПЕуеп®,0) == МАТТ ОВУЕСТ_О0) 


{ 
1Е (Сееоуег1арреяВезо1% (роге, &Оуег1арр, &П0МОВЬ (п), Еа15е)) 
{ 
Табе11->СарЕ1оп " Получены/переданы новые данные - " 
+ ТоеТобЕг (п) + " байт"; 


Га1зе; 


Т1мекг1->Епаб1еа 
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С]1о5еНапа1е (Оуег]арр.ПЕуепЕ); 
} 
} 


е1зе Гаре11->СарЕ1оп = "Новых данных нет"; 


} 


Обратите внимание на необходимость закрыть дескриптор объекта собы- 
тия функцией С1юзеНап Че после того, как событие произошло. 

Рассмотренный способ организации асинхронной работы с портами с по- 
мощью объектов событий годится для любых версий У ш4о\м$. 

Выше было рассмотрено асинхронное чтение и запись с помощью функций - 
КеадЕШе и Угие Ше. Имеются также функции ВеадЕПеЕх и УтивЕЙеЕх, специ- 
ально предназначенные для асинхронного чтения и записи. Их описание дает- 
ся в гл. 8. 


2.5.4 Несколько слов о работе с модемом 


С модемом можно работать по тем же принципам, по которым организует- 
ся работа с портами, или работать, используя ТАРТ (М1сгозоЁ \ш132 Тее- 
рпопу аррИса\1оп ргоггаштшя шфег!асе). Второй вариант мы рассматривать 
не будем, так что если хотите его изучить, можете посмотреть в справочном 
файле ТАРГ.Йф, поставляемом вместе с С++Ви|аег. А о том, как работать с мо- 
демом непосредственно через соответствующий порт, имеет смысл сказать 
в этом разделе. 

Прежде, чем работать с модемом, надо определить, к какому порту на ва- 
шем компьютере он подключен. Проще всего это сделать с помощью стандарт- 
ной программы Панель Управления У/Лт9о\з. 

Если вы знаете порт, то открыть его можно той же функцией Сгез4е Е Пе, ко- 
торую вы использовали в предыдущих разделах. А затем функцией УгцеЕье, 
также знакомой вам по работе с портами, можно записывать в порт строки ко- 
манд АТ (АЦКепйоп Бедиепсе), управляющих модемом. Строка, как правило, на- 
чинается с идентификатора АТ — внимание (аЦепйоп) и заканчивается симво- 
лами возврата каретки и перехода на новую строку. А между этими двумя эле- 
ментами могут размещаться с пробелами или без пробелов основные команды. 

Обычно работа с модемом начинается с команды О: 


Р система_набора номер телефона 


Система набора обозначается символами Т — тоновый набор, или Р — импуль- 
сный. Как правило, в наших сетях используется импульсный набор. Номер те- 
лефона — это строка, содержащая цифры и некоторые другие символы. Все 
непонятные модему символы будут просто игнорироваться. Так что телефон 
можно записать набором цифр без пробела: "1234567", или, например, с испо- 
льзованием дефисов: "123-45-67", или с пробелами после некоторых групп 
цифр. Результат будет одинаковым. 

Таким образом, установка соединения может быть оформлена, например, 
следующим образом. Пусть в приложении имеется окно редактирования 
с именем ЕРогф, в котором можно записать имя порта, связанного с модемом, 
например, "СОМЗ”. Имеется также окно с именем ЕМитфЬег, в котором поль- 
зователь пишет номер телефона. И имеется метка Габе]1, в которой отобража- 
ется состояние приложения. Тогда звонок по номеру, указанному в ЕМишфег, 
можно организовать следующим образом: 


НАМОТЕ Н; 
Ап$156г1па АТСоштапа; 
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Уу01А _ Еаз®са11 ТЕогм1: : Ви ®оп1С11сК (ТОБ)есЕ *5епаег) 
{ 


ТЕН) 
{ 
Н = СгеакеЕ11е (ЕРоге->Техе.с _56г(), СЕМЕВТС ИВТТЕ, 0, МО, 
ОРЕМ_ ЕХТЗТТМС, ЕТТЕ АТТКТВОТЕ МОВМАГ, 0); 
1Е (Н == ТМУАБТОЬ НАМОЬЕ УАГОЕ) 
{ 
ЗромМеззасде ("Невозможно открыть порт " + ЕРогЕ->Тех®); 
Таре11->Саре1оп = "Невозможно открыть порт "+ ЕРог®->Техе; 
гебагп; 
} 
е1зе `Таре11->СарЕ1оп = "Порт " + ЕРогЕ->Тех® + " открыт"; 
} 
АТСопмапа = "АТОР " + ЕМапрег->Техе + "\г\п"; 


РИОВО Мимбе’Мг1Е еп = 0; 
1Е(! Мг1еег11е(Н, АТСопшмапа. с _з6г(), 
зЕг1еп (АТСомтапа. с _зег()), 
&МапрегИг1Е еп, М№11.)) 
ЗРпомМез$заде ("Ошибка записи в порт " + ЕРог®->Тех®); 


} 


С открытием порта, наверное, все ясно. В переменной АТСоттап@ форми- 
руется строка команд. Начинается она с команды АТ. Затем идет без пробела 
или с пробелом команда О. После нее следует символ Р, указывающий на им- 
пульсный звонок. После этого следует набираемый номер. Завершается строка 
символами "\г\п” — возврата каретки и перехода на новую строку. Сформиро- 
ванная строка команд заносится в порт известной вам функцией УтгцеЕПе. 

Иногда при наборе номера надо делать паузы после каких-то цифр. Пауза 
задается символом запятой. Например, задание номера в виде "8,0951234567" 
обеспечит паузу после набора цифры 8. Время задержки записано в секундах 
в регистре 8 модема. Если вы хотите изменить это значение, можете выпол- 
нить в команду "58 = ...”. Например, приведенный выше оператор, формирую- 
щий команду, можете записать в виде: 


АТСоммапа = "АТ $8 = 5 ПОР" + ЕМопрег->Техе' + "\г\п"; 


Такой оператор обеспечит в случае, если в номере встретилась запятая, за- 
держку на 5 секунд. 

Надо отметить еще одну команду — Х4, которая обеспечивает проверку 
того, что номер абонента занят. Так что если вы запишете команду в виде 


АТСопмапа = "АТ Х4 ПР " + ЕМипрег->Техе + "\г\п"; 


то если абонент занят, после нескольких коротких гудков звонок прервется. 

Команда А/ обеспечивает повторение последней команды. Она отличается 
от всех других тем, что перед ней не пишется АТ, а после нее не требуются 
символы “\г\п”. Например, повторный звонок по тому же телефону, по кото- 
рому не удалось дозвониться перед этим, можно обеспечить командой: 


АТСошмтапа = "А/"; 


После того как вы дозвонились, можете писать в порт и читать из него 
дальнейшую информацию. Если вам надо в какой-то момент прервать соедине- 
ние (повесить трубку), можно послать в порт команду Н (Напх Ор) — отбой: 

АТСопмапа = "АТ Н\х\п"; 


Иг16ег11е(Н, АТСомтапа. с _з6г(), 5Ег1еп (АТСомтапа.с_з%г()), 
&МипрегИг1Е еп, МОГ) 
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По окончании сеанса не забудьте закрыть дескриптор порта: 


С]1озеНапа]1е (Н); 


Работа с модемом идет, как правило, в асинхронном режиме, подробно 
рассмотренном в разд. 2.5.3. Отслеживание события звонка на модем может 
быть задано рассмотренной в разд. 2.5.3 функцией Зе СоттМазК с флагом 
ЕУ ВМО. 

Мы рассмотрели схему организации работы с модемом. Ну, а остальное 
связано с более сложными командами АТ, с конкретной маркой модема, с кон- 
кретными решаемыми задачами, так что на этом обещанные несколько слов 
о работе с модемом я закончу. 


НИ СЕ 
ОУ 


Синхронизация процессов 
и потоков 


3.1 Объекты синхронизации 


В АРТ \У/114о\5 предусмотрен ряд механизмов, призванных обеспечить 
синхронизацию выполнения различных приложений и их отдельных потоков. 
Необходимость синхронизации может быть связана с использованием ка- 
ких-то неразделяемых ресурсов. Например, несколько приложений хотят за- 
писывать или читать данные, используя один и тот же порт (см. разд. 2.5). Но 
одновременно это делать невозможно. Значит, если одно приложение или один 
его поток захватил ресурс, остальные должны ждать, пока ресурс освободится. 
Необходимо синхронизовать процессы и потоки также в том случае, если один 
из них требует результаты, которые должны быть получены другим. Тогда 
первый из них должен ждать, пока второй получит требуемые данные. 

Для синхронизации предусмотрены различные типы синхронизирующих 
объектов. Это объекты событий (еуеп$), обеспечивающие ожидание некоторых 
событий, мьютексы (шищех), позволяющие только одному из процессов захва- 
тывать какие-то неразделяемые ресурсы, семафоры (зетарпоге), ограничиваю- 
щие число процессов, которые могут одновременно использовать какие-то раз- 
деляемые ресурсы, таймеры ожидания (маца]е Итег), обеспечивающие за- 
держки на заданное время. Все эти объекты будут рассмотрены в следующих 
разделах. В качестве объектов синхронизации могут также выступать такие 
объекты, создаваемые, прежде всего, для иных целей, как сообщение об изме- 
нениях в каталогах (сВапее пои са оп), консольный ввод (сопзое 1при%), про- 
цесс (ргосез$), поток ({геаа). 

Каждый из объектов синхронизации может быть в одном из двух состоя- 
ний: сигнальном (315 па]е) или несигнальном (попз1пае4). Для разных типов 
объектов смысл этих двух состояний несколько различается. В приведенной 
ниже табл. 3.1 даются краткие предварительные сведения об объектах синхро- 
низации, управляющих ими функциях и смысле сигнального состояния. 


Таблица 3.1. Синхронизирующие объекты 


сообщение об изме- `Дескриптор этого объекта возвращается функцией Ет@д- 
нении (сПапбе Е СБапгеМойнЙсайоп (см. разд. 3.9 и 6.6.4). Объект 
пойЁса оп) переходит в сигнальное состояние, когда в указанном 


ОИ 


консольный ввод Дескриптор этого объекта возвращается функцией 

(сопзо]е шриф) СгежеЕЦе (см. разд. 6.7.1) со спецификатором СОМТ\$Ф, 

или функцией Се 5аНапШе. Объект находится в сигна- 

льном состоянии, если во входном буфере консольного 
ввода есть непрочитанные данные, и переходит в несиг- 
нальное состояние, если буфер пуст. 
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——— еее т” == ЕЕ > ==—= === 


событие Дескриптор. этого объекта (см. разд. 3.5) возвращается 

(еуепф) функциями СгежфеЕуеп{ или ОрепЕуеп%. Объект перево- 
дится в сигнальное состояние функциями 5еЕуеп$ 

‚и РШ5еЕуеп+. В несигнальное состояние может перево- 

| диться функцией Кезе Еуепф. 


мьютекс Дескриптор этого объекта (см. разд. 3.3) возвращается 

(пех) функциями СгежеМщех или ОрепМшех. Объект нахо- 
| дится в сигнальном состоянии, если в данный момент 
у него нет владельца. 

процесс Дескриптор этого объекта (см. разд. 3.7) возвращается 


функциями СгежеРгосе$$ или ОрепРгосе$$. Объект пе- 
реходит в сигнальное состояние, когда процесс заверша- 
ется. 


(ргосез$) 


семафор Дескриптор этого объекта (см. разд. 3.4) возвращается 
(зетарНоге) функциями СгежеэетарБоге или ОрепЗетарВоге. Объ- 
ект находится в сигнальном состоянии, если число испо- 
льзующих его процессов больше 0. 


поток Дескриптор этого объекта (см. разд. 3. 8) возвращается 
({пгеаа) _ | функциями СгеафеРгосе$$, СгеаёеТЬгеаа, СгеафеВето- 
феТЬгеа4. Объект переходит в сигнальное состояние, 
когда поток заверптается. 


таймер ожидания Дескриптор этого объекта (см. разд. 3.6) возвращается 
(маЦае Ятег) функциями Сгеже\УаЦаеТ1тег или Ореп\/ацаШеТ!- 

| пег. Объект активируется функцией Зе \ацаеТищег 
| и деактивируется функцией Сапе \ацЦаМеТ1 тег. Пере- 
ходит в сигнальное состояние, когда истекает заданный 


отрезок времени. 


В объектах синхронизации имеются счетчики числа обращений к ним. 
Если объект был М раз подряд переведен в несигнальное состояние, то только 
после М переводов в сигнальное состояние объект действительно перейдет в это 
состояние. 

Удаление созданного объекта синхронизации может осуществляться 
функцией Сю5еНап4@е: 


ВООЪ С1озеНапа1е (1М№ ОЧТ НАМОЬЕ ВОБЗ]ес®); 


где ВОБ]есё — дескриптор объекта. Функция возвращает ненулевое значение 
при успешном завершении. 


3.2 Функции ожидания 


Объекты синхронизации используются совместно с функциями ожидания. 
Эти функции связываются с одним или несколькими синхронизирующими 
объектами и ждут, когда эти объекты перейдут в сигнальное состояние. Тем 
самым выполнение процесса может быть приостановлено до тех пор, пока 
в системе не произойдет некоторое событие. 

Ожидание одного события может быть организовано вызовом функции 
УанЕог5 те ОЦеси: | 


РИОКР Ма16Гог51091е0р)есф (1М НАМОГЕ ПНапа1е, 
ТМ ОМОВБР амМ11115есопаз); 
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Параметр ВНап Ме — дескриптор объекта синхронизации. Параметр 
4\МИ5есоп4; — время ожидания (тайм-аут) в миллисекундах. Если объект, 
на который указывает ВНапШе, в данный момент находится в несигнальном 
состоянии, функция ждет, пока он перейдет в сигнальное состояние, или пока 
не закончится время ожидания. Если объект в момент вызова функции нахо- 
дится в сигнальном состоянии, функция возвращается немедленно. Если воз- 
вращенное функцией значение равно \УАТТ 'ИМЕОЧТТ, это свидетельствует 
о том, что время ожидания истекло, а объект так и не перешел в сигнальное 
состояние. Значение \АТТ ОВЕСТ_0 свидетельствует о том, что объект сра- 
зу был в сигнальном состоянии или перешел в это состояние во время ожида- 
ния. Возвращенное функцией УаЦЕог5тееОБес*& значение \УМТ_АВАМ- 
РОМЕРО возможно только для мьютексов и свидетельствует о том, что мьютекс 
освободился вследствие окончания выполнения владевшего им потока. Под- 
робнее это будет рассмотрено в разд. 3.3. Значение \УАТТ_ЕАП.ЕО свидетель- 
ствует об ошибке выполнения функции. 

Если параметр 9ВиМИЙ$есоп@4$ задан равным 0, функция тестирует состоя- 
ние объекта и немедленно возвращается, независимо от состояния объекта. 
Если 9“ МПЁ$есоп9$ = ПМЕГМТЕ, функция возвращается только при переходе 
объекта в сигнальное состояние. Такое значение параметра 4“ МИЦ 5$есоп 45$ 
надо задавать с большой осторожностью. При этом надо быть абсолютно уве- 
ренным, что рано или поздно объект перейдет в сигнальное состояние. В про- 
тивном случае приложение «зависнет». 

Перед возвращением функция УайЕогэЭте1еОБес{ изменяет состояние 
объекта, например, захватывает мьютекс, уменьшает число семафора на 1 
ит.д. 

Ожидание нескольких синхронизирующих объектов может быть органи- 
зовано функцией УайРогМи р еОЦес%5: 

РИОКОР Ма1ЕЕГогМи1{1р1е05)]есе$ (ТМ ОМОВО пСоцпЕ, 

ТМ СОМЗТ НАМОТЕ *1рНапа1ез, 


ТМ ВООТ ЮМа1А11, 
ТМ ОМОВО амМ11115есопаз); 


Параметр 1рНап {е5 является указателем на массив дескрипторов объек- 
тов синхронизации. Параметр пСоип& определяет число дескрипторов в этом 
массиве, используемых функцией. Параметр Б\УаНАП определяет логику 
ожидания. При Б\УаЦАП = фгие функция ждет, пока все объекты окажутся 
в сигнальном состоянии. При Б\УаЦ АП = #ай!зе функция возвращается, если 
в сигнальном состоянии находится хотя бы один объект. В этом случае возвра- 
щаемое функцией значение указывает, какой именно объект находится в этом 
состоянии. Параметр 9“ МИП$есоп4$ определяет время ожидания и все, ска- 
занное выше об аналогичном параметре функции УаЦЕогэшвеОБуес+, отно- 
сится и к данной функции. 

Функция работает аналогично функции Уа{ЦЕогЭте]1еОес&, отличаясь 
только возвращаемыми значениями. При Б\УаЦ АП = фгие функция возвраща- 
ет значения \АТ ОВУЕСТ 0, МАТТ ТТМЕОСТ, \МАТГ_ АВАМПООМЕО_0 
или \АТТ_ЕАП.ЕО. Смысл этих значений рассматривался ранее. При 6 \УаЦ- 
АП = Ё15е возможные значения \АТТ_ТТМЕОСЧТ, М\МАТТ_ЕАП.Е, от \МАТТ_ 
ОВУЕСТ_0 до МАТТ_ОВУДЕСТ 0 + пСоипё - 1 иот \АТТ_ _ АВАМРВОМЕО_0 до 
У\АТТГ АВАМПШОМЕР 0 + пСоцпЕ - 1. Разности возвращенного результа- 
та —- \УАТТ ОВТЕСТ_0 или возвращенного результата —- \УАМТ_АВАМПО- 
МЕО_0 дают индекс того объекта в массиве 1рНап]е5$, который вызвал завер- 
шение выполнения функции. 
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Имеются расширенные варианты функций УаЦРог5те]еОЦес{ и \Уац- 
ЕогМа 1 реО ес — УацЕогэшееОесЕх и Уа&ЕРогМиИреОЦес{5$Ех: 
РИОВР Иа1+ЕЕог51п91е053есьЕх (1М НАМОГЕ ПНапа1е, 
ТМ ОМОВКО АмМ11115есопаз, 
ТМ ВООШГ БА1егфаю1е); 
РИОВОР ИМа1ЕЕГогМи1+1р1е0Б]есЕ$Ех (ТМ РМОВО пСочпЕ, 
ТМ СОМЗТ НАМОГЕ *1рНапа1ез, 
ТМ ВООГ ЬМа1+А11, 
ТМ ОМОВО аАмМ11115есопа$, 
ТМ ВОО БА1егкаЮ1е); 


Эти функции используются, когда ожидание связано с функциями расши- 
ренного чтения или записи ВеадЕПеЕх и УгцеЕЦеЕх (эти функции описаны 
в гл. 8), или с асинхронным вызовом процедур (азупспгопоцз$ ргоседиге са] — 
АРС), ставящихся в очередь функцией Ф@цеце0О5егАРС. В функциях 
УацЕог5ше1еО ес Ех и УаЦцЕогМи ИреОБес$Ех имеется дополнитель- 
ный параметр 6 Мена Ше. Если этот параметр равен фгие, то функции возвра- 
щаются не только в случае сигнального состояния синхронизирующих объек- 
тов или по истечении заданного времени ожидания, но и при завершении опе- 
рации ввода/вывода функцией обратного вызова, или при вызове функции 
АРС. Если параметр 6 АЛетаЫе равен #а5$е, то функции ожидания не возвра- 
щаются, пока не наступит сигнальное состояние синхронизирующих объектов 
или пока не истечет заданное времени ожидания. До этого момента не выпол- 
няются также (т.е. задерживаются) функции обратного вызова и функция 
АРС. 

Функции У\УацЕогэтоеОЦечЕх и УаЦЕогМа реОЦес$Ех могут воз- 
вращать те же значения, что и аналогичные не расширенные функции, но до- 
полнительно возможно возвращаемое значение УМТ 10_СОМРЕЕТТЮМ — 
возврат функции вследствие окончания процедуры чтения/записи. 

Еще одна функция выполняет одновременно две операции: она переводит 
в сигнальное состояние один объект, и ожидает перехода в сигнальное состоя- 
ние другого объекта. Это функция ЭпаОЩес Апд\Уац: 

РИОКР $194па1О6)]ескАпаЙа1* (ТМ НАМРЬЕ ПОБЗесеТо$1апа1, 

ТМ НАМОЬЕ ВОр)есеТоЙа1® Оп, 


ТМ ОМОВО АмМ11115зесопа$, 
ТМ ВОО БА1егфа]е); 


‘Функция немедленно переводит в сигнальное состояние объект, заданный 
дескриптором ВОЩес{То1епа1, а затем ожидает объект, заданный дескрипто- 
ром ВОЩесТо\Уа Оп. Параметры 4“ МИЦ$есоп@$ и 6 МенаШе аналогичны 
рассмотренным в предыдущих функциях. Возможные возвращаемые значе- 
ния те же, что в функции У\УаЦЕогэто]еОЩесЕх. Использование этой функ- 
ции позволяет послать через объект ВОЩес То51епа| сигнал другому прило- 
жению или потоку о завершении каких-то операций и переходу в режим ожи- 
‚ дания объекта ВОБдесТо\а[Оп. 


Одним из недостатков всех рассмотренных функций является то, что при- 
ложение или поток, в котором функция вызвана, останавливается, и даже не 
воспринимает приходящие сообщения \У/114о\з$. Так что, например, даже пе- 
рерисовка окна приложения может не произойти. Сообщения поступают в оче- 
редь, но эта очередь не разгружается. Предлагаемое некоторыми разработчи- 
ками решение этой проблемы путем задания малого значения Чи МИ $есоп@$ 
и зацикливания вызова, если вернулось значение \АТТ ТТМЕОСТ, помогает 
слабо, так как все равно сообщения У/т@4о\з не успевают обработаться при 
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циклических передачах управления. Выходом ИЗ этого положения являются 
функции ожидания Мз“УаЦЕогМи Нар! еОШес$ и МзУацЕогМо реОЪ- 
ес Ех: | 
РИОВКО М5ач\а1еГогМи1$1р1е0Б)есе$ (ТМ ОМОВО пСочпф, 
ТМ СОМЗТ НАМОЬЕ *1]рНапа1ез, 
ТМ ВООТ БМа1А11, 
ТМ ОИОВО АмМ11115есопад$, 
ТМ ОИОВР АмМакеМмазК); 
РИОКОР М5ч\Ма1*ЕГогМи1&1р1е0р)]есезЕх (ТМ ОРМОВО пСоцпЕ, 
ТМ СОМ5Т НАМОЬЕ *1рНапа1ез, 
ТМ ОМОВО аЯмМ11115есопа$, 
ТМ ОМОВБО аАмМакКеМмазк, 
ТМ ОМОВКО ЯмЕ1аа$); 


Эти функции возвращаются не только в случае сигнального состояния 
синхронизирующих объектов или по истечении заданного времени ожидания, 
но и при поступлении указанных маской дм\УаКеМазК сообщений У/т94о\в. 
Такие сообщения как бы добавляются к тем синхронизирующим объектам, ко- 
торые перечислены в массиве 1рНапШе$. Параметр 4 \аКеМазК может вклю- 
чать комбинации следующих значений: 


05_АПИМРОТ Любое сообщение 


93_АТЛЕУЕМТ$ | 
93_НОТКЕУ Сообщение УМ_НОТКЕУ 


05_ТМРОТ Сообщение ввода — 
| 95_КЕУ Сообщения \УМ_КЕУОР, \М_КЕУРО\ММ, \М_5У5- 
’ | КЕУ9ОР, ММ_5ЗУЗКЕУОВОММ 
05_МОО$Е Сообщение УМ_МОЧЗЕМОТЕ или сообщения кнопок 
мыши — УМ_ТГВОТТОМОР, \УМ_ВВОТТОМОО\УМ и др. 
©905_МООЗЕВОТТОМ | Сообщения кнопок мыши — \УМ_ГВОТТОМУОР, 
\М_ВВОТТОМОО\М и др. 
0905_МОЧЗЕМОУХЕ Сообщение УМ_МООЗЕМОУЕ 


Сообщение \ММ_РАТЛМТ 


Последние функции ожидания, которые мы рассмотрим, это функции 
ЗЧ]еер и З1еерЕх: 


УоОТр $51еер (ТМ ОИОКО АмМ11115есопа$}); 
РИОВО $1еерЕх (ТМ ОМОВР амМ11115есопа$, ТМ ВООЬ РА1ег®аЬ1е); 


Функция З$1еер просто задерживает выполнение потока на время, задан- 
ное параметром 4мМИП5$есоп@4$. А в функции ЗЧеерЕх параметр 6 ЩенаЫе, 
установленный в фгие, позволяет прервать ожидание, если в этом потоке завер- 
шилась функцией обратного вызова операция ввода/вывода, или вызвана 
функция АРС. Об этих особенностях некоторых функций было сказано выше. 
Следует отметить, что функции Чеер и З]еерЕх более нагружают процессор, 
чем функции, рассмотренные ранее. Так что их имеет смысл использовать 
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только там, где этот недостаток мало существенен: при сравнительно редких 
задержках на небольшие отрезки времени. 

Мы рассмотрели все функции ожидания. Примеры их применения вы уви- 
дите в следующих разделах. 


3.3 Мьютексы 


Начнем рассмотрение синхронизирующих объектов с мьютексов (название 
произошло от взаимоисключающий — ши&аа| ехс]а310оп, или коротко шщех). 
Мьютекс — это объект, который может быть захвачен только одним потоком, 
одним процессом. Таким образом, мьютексы позволяют избежать, например, 
одновременной работы нескольких приложений с какими-то неразделяемыми 
ресурсами. 

Мьютексный объект создается функцией СгежеМщех: 


НАМОЬЕ СгеафеМиафех (ТМ ГРЗЕСОВТТУ АТТВТВОТЕ$ 1рМисехАЕ&г1риеез, 
ТМ ВООЪ Ь1п1Е1а]Омпег, ТМ ГРСЗТВ 1рМапе); 


Функция возвращает дескриптор мьютексного объекта с именем, заданным 
параметром 1рМате. Параметр 1рМшехАИгще$ является указателем на 
структуру типа 'ЗЕСОВТТУ АТТЕТВОТЕ$ или ТЗесог{цуАНгЬшще$, опреде- 
ляющую, будет ли наследоваться возвращенный дескриптор дочерними процес- 
сами, и задающую дескриптор защиты. См. описание этой структуры в гл. 8. 

Значение параметра 1рМшехА вгЬще$ можно задать равным МОТ. Это 
будет означать, что дескриптор не наследуется и используется дескриптор за- 
щиты по умолчанию. 

Параметр БПиЯа|Омпег определяет владельца объекта. При значении 
фгие владельцем становится поток, вызвавший функцию. При значении БПи- 
На]О\мпег = #а]15е мьютекс остается без владельца. 

Имя мьютекса, задаваемое параметром 1рМаше, может содержать любые 
символы, кроме символа `\’. Если задать 1р Маше равным МОТ, то будет соз- 
дан мьютекс без имени. Тогда доступ к нему можно получить только через воз- 
вращаемый дескриптор. Имя мьютекса не должно совпадать с именем уже су- 
ществующего события, семафора и других объектов межпроцессной синхрони- 
зации, которые будут рассмотрены в следующих разделах. Если совпадет, то 
при выполнении функции возникнет ошибка. В этом случае функция провер- 
ки ошибок Се а Еггог (см. разд. 1.1) вернет значение ЕВВОВ_ТМУА- 
МР _НАМРЬЕЕ. 

Несколько процессов могут вызывать функцию СгежеМщех для мьютек- 
са с одним и тем же именем. Тогда первый процесс действительно создает мью- 
текс, а последующие открывают дескриптор существующего мьютекса. Опре- 
делить, существовал ли мьютекс до вызова СгеаёеМщех можно, вызвав функ- 
цию Се Га$&Еггог. Если мьютекс уже существовал, то де Та$Еггог вернет 
значение ЕКВКОК_АТКЕАРУ_ЕХТЗТ$. | 

Рассмотрим использование функции СгежеМщех для решения следующей 
задачи. Нередко при запуске приложения требуется знать, не запущено ли уже 
такое приложение на компьютере. Это необходимо, если приложение спроекти- 
ровано так, что одновременно должен работать только один его экземпляр. 
Один из путей решения этой задачи — использование мьютексов и функции 
СгежеМщех. Ниже приведен пример функции УштМаш головного файла по- 
добного приложения (проект Оп/Опе] в каталоге бупсйтоп на приложенном 
к книге диске). 
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ИТМАРТ ИМ1пМалп (НТМ5ТАМСЕ, НТМУТАМСЕ Н, ГРЗТВ, 110%) 
{ 

Еху 

{ 

СгеафеМитех (МОТГ, Егие, "МумМаеех"); 

106 Вез = СееГазЕЕггог(); 

1 (Вез == ЕКВОВ_АЦВЕАШУ ЕХТЗТ$) 

{ 


ЗромМеззасе ("Уже имеется выполняемое приложение"); 
Арр11са*1оп->Теги1паее(); 


1Е(Вез == ЕВВОВ _ТМУАГТО НАМОГЕ) 

{ 

_ ЗромМеззасде ("Ошибка в имени мосех оБдес®"); 
Арр11сае1оп->Тегт1паее(); 


} 
Арр11са*1оп->1п1&1а112е(); ` 
Арр11са&1оп->СгеафеГогм (__с1а$$14 (ТГогт1), &Еогпм1); 
Арр11са®1оп->Коп (); 

} 


саесВ (ЕхсерЕ1оп &ехсер®1оп) 


{ 


Арр11са®1оп->5ПомЕхсер®топ (б5ехсере1оп); 


} 


гебатп 0; 


} 


`В приведенном коде жирным шрифтом выделены операторы, вставляемые 
в стандартный код \УтМашщш. Функция СгежеМщех пытается создать мью- 
текс с именем "МуМчщфех” (это имя может быть любым). Затем вызывается 
функция Се а$Еггог и ее результат заносится в переменную Ве5. Если мью- 
текс с этим именем уже существовал, то Че Таз Еггог (см. разд. 1.1) возвраща- 
ет значение ЕВКОК_АТКЕАОУ_ЕХТЗТЪФ. Тогда после соответствующего сооб- 
щения пользователю приложение закрывается. Если Се Газ Еггог вернула 
ЕВВОВ ТМУАГТО_НАМОГЕ, значит имя "МуМфех” уже использовано для 
объектов синхронизации иных типов. В этом случае надо сменить это имя 
в данном приложении. 

В данном примере обеспечивается работа только одного экземпляра прило- 
жения. Если имеется несколько разных приложений, из которых в каждый 
момент времени может выполняться только одно, головные файлы каждого из 
них надо записать в таком же виде. Тогда гарантированно приложение из этой 
группы не сможет быть запущено, пока выполняется другое приложение. 

Имеется функция ОрепМщех: 


НАМОЪЕ ОрепМоаеех (ТМ ПМОВР амрез1геЯдАссез$, 
ТМ ВОО БТпВег1ЕНапа1е, ТМ .РСЗТВ 1рМапе); 


которая открывает существующий мьютекс с именем 1рМаше и возвращает его 
дескриптор. Параметр 9мОезге4Ассезз может принимать значение МО- 
ТЕХ_АТТ, АССЕЗ5 — полный доступ к мьютексу, или ЗУМСНВОМТАЕ — ис- 
пользование мьютекса в рассмотренных далее функциях ожидания. Обычно 
используется значение ЗУМСНВОМТАЕ. Параметр ЫМавеги Нап ЩШМе определя- 
ет, будет ли наследоваться возвращенный дескриптор дочерними процессами. 
При значении %&ёгие будет наследоваться. 

Функция ОрепМщех возвращает дескриптор только в случае, если мью- 
текс уже был создан каким-то процессом. В противном случае возвращается 
МОТ. Это можно использовать как еще один вариант решения поставленной 
выше задачи: гарантированного запуска только одного экземпляра приложе- 
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ния. При использовании функции ОрепМщех операторы, выделенные в при- 
веденном выше примере жирным шрифтом, могут быть заменены следующим 
кодом (проект ОшуОпе2 в каталоге Зупсйтоп на приложенном к книге диске): 


1Е (ОрепМифех (5УМСНВОМТРЕ, Егоае, "МуМоеех")) 
{ 


ЗромМе$засве ("Уже имеется выполняемое приложение"); 
Арр]11са®*1оп->Тегм1пафе (); 


} 

СгеафеМафех (МОГ, +хкае, "МуМоавех"); 
106 Вез = Сета Егтгохг (); 

1Е (Вез == ЕВВКОК ТМУАГТО НАМОТЕ) 


{ 


ЗРомМеззаае ("Ошибка в имени 'МуМакех' шиабех оБ)ес®"); 
Арр11са®*1оп->Теги1пафе (); 


} 


Мьютексы могут рептать и более сложные задачи синхронизации несколь- 
ких приложений. Предположим, имеется некоторый неразделяемый ресурс, 
который на некоторое время может захватывать то или иное приложение. На- 
пример, несколько приложений хотят записывать или читать данные, исполь- 
зуя один и тот же порт (см. разд. 2.5). Но одновременно это делать невозмож- 
но. Значит, если одно приложение или один его поток захватил ресурс, осталь- 
ные должны ждать, пока ресурс освободится. 

Если в данный момент мьютекс не имеет владельца, то процесс может 
стать его владельцем, вызвав описанную выше функцию ОрепМщех или одну 
из функций ожидания, которые были описаны в разд. 3.2. Затем в процессе 
могут выполняться операции с неразделяемым ресурсом. Если до вызова 
функции ОрепМщех или функции ожидания процесс уже был владельцем 
мьютекса, то число ссылок на этот мьютекс увеличивается на 1 и процесс про- 
должает им владеть. | 

_ По окончании необходимых операций процесс может освободить мьютекс 
функцией ВаеазеМщех: 


ВООЬ Ве1еазеМиеех (НАМРЬЕ ПМоЕех); 


Точнее, вызов функции В@аеазеМщех уменьшает на 1 число ссылок на мью- 
текс. Если это число стало равно 0, мьютекс освобождается. 

Таким образом, все процессы, которым требуется некоторый неразделяе- 
мый ресурс, должны перед его использованием вызывать одну из функций 
ожидания, передавая в нее дескриптор мьютекса, который ассоциируется 
с этим ресурсом. Если мьютекс свободен, функция немедленно вернется, про- 
цесс завладеет этим мьютексом и может выполнять требуемые операции. Если 
мьютекс занят, функция будет ждать, пока он освободится. 


Давайте рассмотрим тестовое приложение, которое демонстрирует исполь- 
зование мьютексов, и заодно — использование различных функций ожидания, 
описанных в разд. 3.1. Это проект Мих в каталоге Зупсйгоп на приложенном 
к книге диске. Приложение во время выполнения показано на рис. 3.1. В нем 
имитируется работа с двумя неразделяемыми ресурсами. С каждым из них ассо- 
циируется свой мьютекс. Кнопки приложения имитируют некоторые операции, 
выполняемые с использованием соответствующих ресурсов. Перед выполнени- 
ем операций вызываются различные функции ожидания, обеспечивающие син- 
хронизацию работы нескольких экземпляров приложения, выполняющихся од- 
новременно. Так что для тестирования надо запустить на компьютере, по край- 
ней мере, два экземпляра подобного приложения. 
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Рис. 3.1 Синнронизация на основемын о нс В 
Приложение, демонстрирующее работу Не удалось выпоянить операцию 


функций ожидания на примере мьютексов Ресурс 2 захвачен. Операция выполняется 


Операция 1 | Операция 1 и2 


Операция 2_ Операция 1 или 2 | 


Операция 1 Мз9 Операция 1 ‚озере 1 осн 2) 


"Несколько экземпляров этого приложения не 
| могут одновременно выполнять одну и ту же 
| операцию 


Приложение содержит 6 кнопок Эрее4Ви Йоп. Во всех них свойство 
АПомАШОр установлено в фёгие, и заданы различные значения свойства 
СгопрШдех. так что все кнопки независимы друг от друга и могут фиксиро- 
ваться в нажатом и отпущенном состоянии. В верхней части формы располо- 
жены метки Габе]1 и ГаБе]2, в которых отображаются сведения об операциях, 
требующих соответственно первый или второй ресурс. 

Ниже приведен фрагмент кода, связанный с кнопками Операция 1 и Опе- 
рация 2: 


НАМОГЕ МуН1, Мун2; 
НАМОГЕ М[ 2]; 


Уу01А __Еазеса11 ТГогм1: : ГогиСгеа%е (ТОр)есЕ *5епаег) 
{ 

МУуН1 = Сгеа®еМифех (МОТГ, Еа1зе, "МуМиеех1"); 

МуН2 = СгеафеМофех (МОТТ, Еа15е, "МуМитех2"); 

М[ О] = Мун1; 

М[ 1] = МуНн2; 


\01А __Еаз®са11 ТКГогт1 : : бреедаВаеоп1С11сКк (ТОр)]есе *5бепаег) 
{ 
1Е (брееячаВа®®оп1->Вомп) 


{ 
РИОВКО Вези1*; 


Таре11->Сар®&1оп = "Ожидание ресурса 1"; 

Чо 

Вези1& = Ма1®Гог51п91е05)ес® (МуН1, 3000); 
ир11е ((Веза1е == МАТТ ТТМЕОЧТ) && 


(Аррттсактоп- >МеззасвевВох ( 
"Ресурс 1 занят. Продолжать ожидание?", 
"Подтвердите ожидание"., 


МВ_ТСОМОЧЕЗТТОМ | МВ УЕЗМО) == ТОУЕЗ)); 
1 (Вези1Е == МАТТ ОВФЕСТ 0) 
` аъе11->Сарезоп = "Ресурс 1 захвачен. Операция выполняется"; 
зе 1Е (Везо1е == МАТТ_АВАМООМЕО) 
< аье11->Сарелой = "Владелец ресурса 1 закончил работу." 


" Ресурс 1 захвачен. Операция выполняется"; 
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} 


е1зе 
{ 
ЗрееаяаВи*оп1->Помп = ЁЕа15е; 
Таре11->СарЕ1оп = "Не удалось выполнить операцию"; 
} 
} _ ИХ конец 1Е(5рееаВиЕЕоп1->Роип) 
е1зе // кнопка отпускается 
{ 
Ве1еазеМиафех (МуН1); 
Тафе11->СарЕ1оп = "Ресурс 1 освобожден"; 


\01А __Еаз®са11 ТЁГогш]1 : : брееаВа*оп2С11сКк (ТОБ)]ес® *5бепаег) 
{ 
1Е (Зрее4ЯВа*$оп2->ПВоип) 


{ 
РИОВКО Везо1*; 


Таре12->Сар®1оп = "Ожидание ресурса 2"; 

Чо 

ВКези1е = Ма1Гог51п91е05]есЕ (МуН2, 3000); 
ир11е ((Везо1Е == МАТТ ТТМЕООТ) && 


(Арр11са*1оп->МеззачевВох ( 
"Ресурс 2 занят. Продолжать ожидание?", 
"Подтвердите ожидание", 


МВ_ТСОМОЧЕЗТТОМ | МВ УЕЗМО) == ТРУЕЗ)); 
1Е (Вези1% == МАТТ ОВФОЕСТ 0) 
`раье12->Сарелоп = "Ресурс 2 захвачен. Операция выполняется"; 
156 1Е (Вези1е == МАТТ_ АВАМООМЕО) 
`раве12->Сарезол = "Владелец ресурса 2 закончил работу." 


" Ресурс 2 захвачен. Операция выполняется"; 


} 


е]1 зе 


{ 
брееаВи( оп2->Ромп = Еа1$е; | 
Таре12->Саре1оп = "Не удалось выполнить операцию"; 


} 
} // конец 1Е(5рееаВиЕЕоп2->роип) 
е1зе // кнопка отпускается 
[ 
Ке1еазеМи{ех (МуН2); 
Таре12->СарЕ1оп = "Ресурс 2 освобожден"; 
} 
} 


В коде введены глобальные переменные МуН1 и МУН, в которых хранят- 
ся дескрипторы двух мьютексов. Подразумевается, что эти мьютексы соответ- 
ствуют каким-то двум неразделяемым ресурсам. Объявлена также глобальная 
переменная М — массив дескрипторов. В обработчике ЕогтСгеафе события 
формы ОпСгез{е создаются функциями СгежеМщех дескрипторы мьютексов 
"МуМшщех1” и "МуМщех?2”. Второй параметр в вызовах этих функций равен 
Га]5е, так что первоначально мьютексы свободны и не имеют владельца. 

Функция Зрее4ВиНЙоп1СПеК является обработчиком щелчка на кнопке ` 
Операция 1. Подразумевается, что эта операция должна использовать первый 
ресурс. Поэтому, если кнопка нажата, то вызывается функция УаЦЕог- 
51151еОес&, ожидающая освобождения мьютекса МуН1. Время ожидания за- 
дано равным 3 сек. Если мьютекс занят, а время ожидания истекло, пользова- 
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телю задается вопрос, надо ли продолжать ожидание. При положительном от- 
вете пользователя функция УайЕогЭшеОБес{ вызывается повторно. Затем 
следует анализ результата, возвращенного функцией УанНЕогте1еОЦес+. 
Значение \АТТ_ОВ.ЕСТ_0 соответствует тому, что мьютекс освободился, так 
что требуемые операции с ресурсом могут проводиться. Конечно, никаких ре- 
альных операций в данном тесте не проводится. Просто выдается в метку 
ГаБе!1 соответствующее сообщение, и кнопка остается в нажатом состоянии. 
Подразумевается, что пока она нажата, операция продолжается. Если пользо- 
ватель освободит кнопку, операция завершится. 

Если результат вызова функции Уа\Еогэше]еОБесй равен \АТТ_АВАМ- 
РОМЕРО, значит, владелец мьютекса МуНТ завершил работу и больше не суще- 
ствует. Таким образом, подразумевается, что ресурс освободился и может быть 
захвачен. В этом случае, как и в предыдущем, текущее приложение делается 
владельцем мьютекса функцией Уа(цЕогэт]еОес+. Так что никаких допол- 
нительных действий по овладению мьютексом не требуется. 

Если результат вызова функции УаНЕогэтееОБес{ не равен указанным 
значениям, значит захватить мьютекс не удалось, и запланированные опера- 
ции выполнить невозможно. Пользователь извещается об этом, а кнопка 
Зрее4Ви Йоп1 переводится в не нажатое состояние. 
| Если обращение к обработчику ЗреедаВайоп1СИесК было связано с отпус- 
канием кнопки Эрее4ВиНЙоп1, это имитирует окончание работы с первым ре- 
сурсом. В этом случае мьютекс освобождается функцией ВееазеМщех. 

Чтобы на практике увидеть работу функции Уа (Еог1те]еОЦесф, запус- 
тите на компьютере два экземпляра этого приложения. Если вы будете нажи- 
мать и отпускать кнопку Операция | в одном экземпляре приложения, все бу- 
дет работать нормально: ресурс будет захватываться и освобождаться. Но если 
вы нажмете кнопку в первом приложении, а затем нажмете аналогичную 
кнопку во втором приложении, то это приложение перейдет в режим ожида- 
ния. Периодически, каждые 3 секунды вам будет выдаваться запрос о продол- 
жении ожидания. Если вы ответите на него отрицательно, то получите сообще- 
ние, что операцию выполнить невозможно, так как ресурс занят. Если во вре- 
мя ожидания вы отпустите кнопку в первом приложении, то второе приложе- 
ние перехватит ресурс и начнет выполняться. Аналогичный результат будет 
получен, если во время ожидания вы закроете первое приложение. Второе нач- 
нет выполняться, так как прежний владелец ресурса исчез. 

Теперь рассмотрим коды обработчиков щелчков на кнопках Операция Ти 2 
(Зреед4Ви оп3), Операция 1 или 2 (ЗреедВиЙоп4): 


\01А __Еаз®са11 ТГогп1: : 5брееаВиеоп3С11сКк (ТОБ)]ес®е *5епаег) 


{ 
1Е (ЗрееаВае оп3->ПОомп) 


{ 
РИОВО Ве5и1*; 


Тафе11->Саре1оп = "Ожидание ресурса 1"; 
Тафе12->Сар®1оп = "Ожидание ресурса 2"; 

Чо 

Везо1Е = Маз ЕРогМо161р1е06)]есе$ (2, М, Егое, 3000); 
ир11е ((Везоа1% == МАТТ ТТМЕООТ) && 


(Арр11са*1оп->МеззасевВох ( 
"Ресурсы заняты. Продолжать ожидание?", 
"Подтвердите ожидание", 
МВ ТСОМОЧЕЗТТОМ | МВ_УЕЗМО) == ТРУЕ$)); 
1Е((Веза1® == МАТТ ОВОЕСТ_ 0) || 
(Везц18 == МАТТ ОВОЕСТ 0 + 1)) 
{ 
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Таре11->СарЕ1оп "Ресурс 1 захвачен. Операция выполняется"; 
Таре12->Сар®1оп = "Ресурс 2 захвачен. Операция выполняется"; 
} | 

е15е 1Е(Вези1Е == МАТТ АВАМРОМЕРО 0) 

{ 


Таре11->Сар®1оп "Владелец ресурса 1 закончил работу." 

"Ресурс 1 захвачен. Операция выполняется"; 

Таре12->СарЕ1оп = "Ресурс 2 захвачен. Операция выполняется"; 

} 

е1зе 1Е(Вези1е == ИАТТ АВАМРОМЕР 0 + 1) 

{ 

Таре11->Сар®1оп "Ресурс 1 захвачен. Операция выполняется"; 

Таре12->Сар®*1оп = "Владелец ресурса 2. закончил работу." 
"Ресурс 2 захвачен. Операция выполняется"; 


} 


е]1зе 


{ 
брее4Ва оп3->Помп = Еа1$е; 


Таре11->Сар®1оп = "Не удалось выполнить операцию"; 
Таре12->Сар®1оп = "Не удалось выполнить операцию"; 
} 
} // конец 1Е(5рееаВиЕ Еоп3->Роип) 


е1зе // кнопка отпускается 

{ 

Ве1еазеМифех (М[0]); 

Ве1еазеМифех (М[1]); 

Табе11->Сар®1оп = "Ресурс 1 освобожден"; 
Таре12->Сар®1оп = "Ресурс 2 освобожден"; 
брееЯаВа $ оп1->Вомп Еа1зе; 

брееаВи Е оп2->Ромп Га1зе; 


ИЕН —----- 
Уу01А _ ГазЕса11 ТГогм1 ; : ЗреедВаеоп4С11сК (ТОр)есе *Зепаег) 

{ 

1Е (ЗрееЯВа © оп4->Ромп) 


{ 
РИОВО Веза1*; 


Таре11->СарЕ1оп = "Ожидание ресурса 1 или ресурса 2"; 
Чо 

Кези]Е = Ма1ЕЕогМо161р1е0Б]ес®з$ (2, М, Еа1зе, 3000); 
ир11е ((Веза1& == МАТТ ТТМЕООТ) && 


(Арр11са*1оп->МеззачевВох ( 
"Ресурсы заняты. Продолжать ожидание?", 
"Подтвердите ожидание", 
МВ _ТСОМОЧЕЗТТОМ | МВ УЕ$ЗМО) == ТРУЕЗ)); 
1Е (Веза1& == МАТТ ОВОЕСТ 0) 
{ 


ТаБе11->Сар®1оп = "Ресурс 1 захвачен. Операция выполняется"; 
ве 1Е (Везо16 == МАТТ ОВОЕСТ_0 + 1) 

< аье12->Саре1оп = "Ресурс 2 захвачен. Операция выполняется"; 
зе 1Е (Везо1Е == МАТТ АВАМРОМЕР 0) 

< раъе11->Сареоп =‘"Владелец ресурса 1 закончил работу." 


"Ресурс 1 захвачен. Операция выполняется"; 
} 
е1зе 1Ё(Вези1е == МАТТ АВАМРОМЕР 0 + 1) 
{ 
Таре12->Саре1оп = "Владелец ресурса 2 закончил работу." 
"Ресурс 2 захвачен. Операция выполняется"; 
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} 


е1зе 


{ 

бсреейЯВа® оп4->Ромп = Еа1з$е; 

Таре11->Сар®1оп = "Не удалось выполнить операцию"; 
Таре12->Сар®1оп = "Не удалось выполнить операцию"; 


} 
} // конец 1Е(5рееаВиЕоп4->Роип) 
е]1зе // кнопка отпускается 


{ 
Ке1еазеМифех (М[0]); 
ВКе1еазеМифех (М[1]); 
Таре11->Сар®1оп = "Ресурс 1 освобожден"; 
Табе12->Сар®1оп "Ресурс 2 освобожден"; 
} 
} 


В этих обработчиках подразумевается, что для выполнения операций тре- 
буются оба ресурса (ЗрееФВивйоп3 СПеК) или один из них (ЗрееВивйоп4СПсК). 
Последний вариант может быть связан, например, с ситуацией, когда требует- 
ся вывести информацию в любой из двух последовательных портов СОМ. 

Поскольку в данных случаях надо работать одновременно с двумя мьютек- 
сами, в обработчиках используется функция ожидания УацЦЕогМи и фе- 
ОБесё$ и массив М, в который занесены дескрипторы обоих мьютексов. Раз- 
личие в вызовах функций УацЕогМ и Ир!еОес{$ в этих двух обработчиках 
заключается в значении третьего параметра: фгие в ЗрееВивбоп 3 СЦсЕ, и Ёа15е 
в Эрее4Вивйоп4СПеКк. Остальные коды обработчиков вряд ли нуждаются 
в комментариях, поскольку тексты сообщений, заносимых в метки ГаБе]1 
и Габе]!2, поясняют различные ситуации, возникающие при завершении вызо- 
вов функций УацЕРогМоа реОЦес5. 

Опробуйте работу функции УацЕРЕогМиИреОЦес{5, запустив на компью- 
тере два экземпляра приложения. Если вы нажмете в первом экземпляре при- 
ложения кнопку Операция | и 2, то это приложение захватит оба ресурса (за- 
владеет обоими мьютексами). Тогда нажатие любой кнопки во втором прило- 
жении переведет его в режим ожидания. В то же время, в первом приложении 
можно будет с успехом нажимать любые кнопки (кроме кнопки Операция 1 Ос- 
воб. 2), так как данный процесс владеет всеми ресурсами. Как и ранее, отпус- 
кание кнопки Операция | и 2 в первом приложении или завершение этого при- 
ложения позволит выполнять операции второго приложения. 

Вы можете также убедиться, что если второе приложение не захватило ни 
один мьютекс, то нажатие в первом приложении кнопки Операция | или 2 при- 
водит к захвату первого попавшегося мьютекса. А если второе приложение за- 
хватило один мьютекс, то нажатие этой кнопки в первом приложении приво- 
дит к захвату того мьютекса, который еще свободен. 

Кстати, вы можете убедиться, что мьютекс учитывает число ссылок на 
него. Нажмите в первом приложении кнопки Операция | и Операция 1] и 2. Тем 
самым вы дважды связали мьютекс с этим процессом. Так что нажатие кнопки 
Операция | во втором приложении переведет его в режим ожидания. Теперь от- 
пустите в первом приложении кнопку Операция 1. Как видно из приведенного 
ранее кода, при этом будет выполнен вызов функции В@ееазеМ щех. Но второе 
приложение по-прежнему будет находиться в режиме ожидания, поскольку 
в первом приложении было 2 ссылки на мьютекс, и вызов ВаеазеМщех 
уменышил число ссылок на 1. Только когда вы отпустите и кнопку Операция 1 
и 2 в первом приложении, второе приложение сможет захватить мьютекс 
и прервет ожидание. 
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Нажатие кнопки Операция | или 2 приводит к захвату какого-то одного 
мьютекса, если есть хоть один свободный. Поэксперементировав с этой кноп- 
кой в одном приложении в сочетании с различными кнопками другого прило- 
жения вы легко увидите логику их взаимодействия. 

Экспериментируя с приложением, находящимся в режиме ожидания, вы 
увидите, что оно не реагирует ни на какие действия пользователя. Его даже 
нельзя закрыть во время ожидания ни системной кнопкой, ни стандартными 
горячими клавишами А|-ЁЕ4. Нельзя также скопировать его изображение в бу- 
фер обмена горячими клавишами А!-Ритосгееп. Все это связано с тем, что ожи- 
дание, инициируемое функциями УаНЕог5те1еО ес и УацЕогМшЯре- 
ОЪ]есё$, блокирует процесс и не дает ему возможность получать какие-либо со- 
общения \!ш4о\з, в частности, связанные с клавиатурой и мышью. 

Обеспечить прерывание ожидания при поступлении сообщения \У/11949о\5 
позволяет функция ожидания Мз\УацЕогМи р еОЦес&5. В приложении 
она используется при щелчке на кнопке Операция | Мз9. Вот код обработчика 
этого щелчка: 


Уу014 _ Еаз®са11 ТГогш1:; : брееаВи*оп5С11ск (ТОБ]есЕ *5епаег) 
{ 
1Е (брееяаВи оп5->ромп) 
{ 
РИОКО Вези1%; 
ма1{: 
Таре11->СарЕ1оп = "Ожидание ресурса 1"; 
Чо 
ВКези16 = Мз9Ма1ЕРГогМа1&1р1е05]есез$ (1, М, Еа1зе, 3000, 
05 _КЕУ | 05 МООЗЕВОТТОМ); 
имВ11е ((Везу1%е == МАТТ ТТМЕООТ) && 
(Арр11са®1оп->МеззасвевВох ( 
"Ресурс 1 занят. Продолжать ожидание?", 
"Подтвердите ожидание", 


МВ _ТСОМОЧЕЗТТОМ | МВ_УЕЗМО) == ТРУЕЗ)); 
1Е (Вези1Е == МАТТ ОВОЕСТ 0) | 
 аБе11 ->Саре1ол = "Ресурс 1 захвачен. Операция выполняется"; 
е13е 1Е (Вези1& == МАТТ_ АВАМРОМЕО) 
` раье11->Сарезон = "Владелец ресурса 1 закончил работу." 


"Ресурс 1 захвачен. Операция выполняется"; 
} 
е15е 
{ 
брееЯВиа  оп5->рРомп = Еа]1зе; 
Таре11->Сарё1оп = "Не удалось выполнить операцию"; 


} 
} // конец 1Е(5рееаВиЕЕоп5->Роип) 
е1зе // кнопка отпускается 
{ 
Ве1еазеМофех (МуНн1); 
Таре11->Сар®1оп = "Ресурс 1 освобожден"; 
} 
} 


В этом коде используется вызов М$2\аЦЕогМи1реОес{$ с маской 
05$_КЕУ | 9$_МОЧЗЕВОТТОМ. Тем самым ожидание прерывается, если 
пользователь при активном окне приложения нажал клавишу или кнопку 
мыши. Запустите два экземпляра приложения, нажмите в одном кнопку Опе- 
рация 1, а в другом кнопку Операция | Мза. Это приложение перейдет в режим 
ожидания. Но оно будет реагировать на сообщения, поступающие с клавиату- 
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ры и от кнопок мыши. Например, щелчок на системной кнопке или нажатие 
клавиш А!-ЁГ4 закроют приложение. А любые сигналы от клавиш и мыши пре- 
рвут ожидание. 

Кнопка Операция | Освоб. 2 демонстрирует применение функции ожида- 
ния па ОЩес%Апд\Уай. Ниже приведен код обработчика щелчка на этой 
кнопке. 


у01А _ Еаз6са11 ТГогм1:; : бреед4Виеоп6С11сКк (ТОБ]есе *бепаег) 
[ | 

1Е (ЗрееаВи Е оп6->рРомп) 

{ 

ОМОВОР Вези1*; 


Таре11->Сар®1оп = "Ожидание ресурса 1"; 

Чо 

Вези1%е = 51апа1ОБ)]есеАпаИа1& (МуН2, МуНн1, 3000, Еа1зе); 
\111е ((Вези1Е == МАТТ ТТМЕООТ) && 


(Арр11саЕ1оп->МеззааевВох ( 
"Ресурс 1 занят. Продолжать ожидание?", 
"Подтвердите ожидание", 


МВ_ТСОМОЦЕЗТТОМ | МВ_УЕЗМО) == ТРУЕЗ)); 
1Е (Вези1Е == МАТТ ОВОЕСТ 0) 
{ 
Таре11->Сар®1оп = "Ресурс 1 захвачен. Операция выполняется"; 
Таре12->Саре1оп = "Ресурс 2 освобожден"; 


брееЯВаоп2->Ромп = ЁЕа1зе; 


} 
е1зе 1Е(Везц16 == МАТТ АВАМРОМЕО) 


{ 
Таре11->СарЕ1оп = "Владелец ресурса 1 закончил работу." 
"Ресурс 1 захвачен. Операция выполняется"; 
} 
е15е 1ЁЕ(Вези1Е == МАТТ РГАТЬЕО) 
{ 
брееаВи Еоп6->Помп = Еа15е; 
Таре11->Сар®*1оп = "Не удалось выполнить операцию"; 
} 
} // конец 1Ё(5рееаВиЕЕопб->Боип) 
е15е // кнопка отпускается 
{ 
ВКе1еазеМиафех (МуН1); | 
Таре11->Саре1оп = "Ресурс 1 освобожден"; 
} 
} 


Вызов функции $1епаОБес{Ап4\У/ай обеспечивает освобождение мью- 
текса МуН2, если до этого приложение владело им, и ожидание освобождения 
мьютекса МуН1. Ожидание не состоится, если в момент вызова функции мью- 
текс МуН2 не захвачен данным приложением. Если приложение владеет этим 
мьютексом, то он будет освобожден. После этого наступит ожидание, если 
мьютекс МуНТ захвачен другим приложение, или выполнится операция, если 
мьютексом владело данное приложение, или если мьютекс был свободен (тогда 
данное приложение захватит его). Чтобы протестировать работу этой функ- 
ции, надо запустить два экземпляра приложения. Если просто нажимать 
кнопку Операция | Освоб. 2, то операция не будет выполняться, так как мью- 
текс МуН2 свободен. Если нажать кнопку Операция 2, а потом нажать Оперо- 
ция 1 Освоб. 2, то операция начнет выполняться, а Операция 2 прервется, так 
как мьютекс МуН2 освободится. Это вы можете проверить, если нажмете по- 
сле этого кнопку Операция 2 другого приложения. Если же в первом приложе- 
нии нажата кнопка Операция 2, а во втором — кнопка Операция 1, то при нажа- 
тии Операция 1 Освоб. 2 в первом приложении оно перейдет в режим ожида- 
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ния. Но при этом мьютекс МуН2 освободится, что можно проверить, нажав 
кнопку Операция 2 второго приложения. 


3.4 Семафоры 


Семафор (зетарвоге) — объект синхронизации, который, как и описан- 
ный в разд. 3.3 мьютекс, может регулировать доступ к некоторому ресурсу. 
Только мьютекс может охранять неразделяемый ресурс, к которому в каждый 
момент времени допускается только один поток, а семафор может охранять ре- 
сурс, с которым может одновременно работать не более М потоков. Такое огра- 
ничение может быть связано с фиксированным размером памяти, отводимым 
для регистрации потребителей ресурса (например, для регистрации использу- 
ется массив фиксированной длины), с резким затягиванием времени обработ- 
ки при большом числе потребителей ресурса и с рядом других обстоятельств. 

При создании семафора для него задается максимальное число его счетчи- 
ка. Оно увеличивается на заданную величину при каждом выполнении опи- 
санной далее функции В@аеазеЗетарвоге. А при завершении любой функции 
ожидания, обращающейся к семафору, число в счетчике уменьшается на 1. 
Пока это число положительно, семафор находится в сигнальном состоянии. 
Если оно достигает 0, семафор перейдет в несигнальное состояние. Так что лю- 
бая функция ожидания при этом не вернется, пока это число не увеличится 
(точнее вернется только по истечении времени ожидания). 

Семафор создается функцией СгежеЗетарвоге: 


НАМРТЕ Сгеакебетарвоге (ТМ ГРЗЕСОВТТУ АТТВАТВОТЕ$ 1рбетарпогеА с г1рисез, 
ТМ ГОМС 11п161а1СоцпЕ, ТМ ГОМС 1МахлмоамСочпе, 
ТМ ЬРСЗТВ 1рМапе); 


Параметр 1рЗетарвогеА г ще$ является указателем на структуру, оп- 
ределяющую характер наследования и защиты. Эта структура описана в гл. 8. 
Значение параметра 1|рэетарвогеА г Ьще$ можно задать равным МОГГ. Это 
будет означать, что дескриптор не наследуется, и что будет использоваться де- 
скриптор защиты процесса, заданный по умолчанию. Параметр 
1 Махипит(Сопи}{ задает максимальное число счетчика. Это число должно быть 
больше нуля. Параметр Ши@а1Сойп{ указывает начальное значение счетчика. 
Это число может быть больше или равно нулю и не может превышать значение 
]Махппап1Соцпё. Параметр рМащте определяет имя объекта. Если имя соот- 
ветствует уже существующему объекту, то параметры ИюиЯа1Соци% 
и МахппитСоци& игнорируются, так как они уже установлены для семафора. 
Если при этом параметр 1рЗетарвогеА г и%е$ не равен МОТ, то он задает 
только наличие или отсутствие наследования, а дескриптор защиты игнориру- 
ется. Параметр 1рМаше задает имя семафора и может равняться МО, — то- 
гда создается семафор без имени. Такой семафор можно использовать в рамках 
одного процесса. Но его невозможно контролировать в другом процессе. Имя 
семафора не должно совпадать с именем синхронизирующего объекта другого 
типа: мьютекса, события, таймера и т.д. 

В случае успешного выполнения функция СгеабеЗетарВоге возвращает 
дескриптор семафора. Этот дескриптор может использоваться в любых функ- 
циях ожидания. Функции будут возвращаться немедленно, пока семафор на- 
ходится в сигнальном состоянии, т.е. пока число счетчика не равно 0. 
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Если семафор, указанный в функции СгежеЗетарбоге, уже существует, 
то функция вернет его дескриптор. Узнать после вызова СгеафеЗетарвоге, су- 
ществовал ли раньше указанный семафор, можно оператором: 


1Е (СесТазеЕггог () == ЕВВОВК_АТЪВЕАРУ _ЕХТЗТ5$) 


Доступ к существующему семафору дает функция ОрепЭетарвВоге: 


НАМОТЕ Орепбетарпоге (ТМ РИОВКР амрез1геаАссез$, 
ТМ ВООЪ Б1пВег1ЕНапа1е, Т1М№ .РСЗТВ 1рМапе); 


Она возвращает дескриптор существующего семафора с именем 1рМате. 
Параметр 4“Оезге4Ассез$ может принимать значение ЗЕМАРНОВЕ_ АТТ, _ 
АССЕЗ5 — полный доступ к объекту, ЗЕМАРНОКЕ_МОГШТЕУ_$ЗЭТАТЕ — воз- 
можность использования объекта в функции В@еазеЗетарвоге, ЗУМСН- 
ВОМТИЕ — использование объекта в функциях ожидания. Параметр Ыш®е- 
г Нап Ще определяет, будет ли наследоваться возвращенный дескриптор до- 
черними процессами. При значении фгие будет наследоваться. 

Функция ОрепЗетарВоге возвращает дескриптор только в случае, если 
семафор уже был создан каким-то процессом. В противном случае возвращает- 
ся МОШ.. 

Увеличение счетчика семафора осуществляется функцией В@аеазеЗета- 
рвоге: 


ВООЪ Ке1еазебетарпоге (ТМ НАМОЪЕ П5бепаррвоге, 
ТМ ГОМС 1Ве1еазеСочп%, 
ОПТ .РЬОМС 1рРгеу1оц$СотпЕ); 


Параметр 1ВаеазеСоип{ указывает, на сколько должен увеличиться счет- 
чик. Это значение должно быть больше 0. Если при указанном значении 
|ВееазеСоип& счетчик должен превысить максимальное значение, заданное 
при создании семафора, то функция вернет #а[5е, и значение счетчика останет- 
ся прежним. Параметр 1рРгеу1ои$Соцпф является указателем на 32-разрядную 
переменную, в которую возвращается значение счетчика, которое было до вы- 
зова данной функции. В качестве 1рРгеу1ои$Сопп{ можно задать МОТ, если 
предыдущее значение счетчика не требуется. 

Поскольку в вызове функции В@меазеЗетарвоге нельзя указать 1Вее- 
азеСоип& = 0, эту функцию нельзя использовать напрямую для того, чтобы уз- 
нать текущее значение счетчика. Но с ее помощью все-таки можно определить 
это текущее значение, применив следующий код: 

1опа М = 1МахлтитСойп*; // ]Мах1титСоипЕ - максимальное число 


1Е (Ке1еазебетарпоге ($, 1, &№)) // $ - дескриптор семафора 
Ма1ЕГог51п91е0Б]есе ($, 1); 


Если текущее значение счетчика меньше максимально возможного, то вы- 
зов функции ВееазеЗетарвоге заносит в переменную М текущее значение 
счетчика, увеличивает счетчик на 1 и возвращает фгие. Тогда последующий 
вызов функции У\УаЦЕог5 те Оес{ уменьшает счетчик на 1, т.е. возвращает 
его к исходному состоянию. Если текущее значение счетчика уже равно мак- 
симально возможному, то функция В@еазеЗетарЬоге возвращает Ёа]$е, так 
что в переменной М сохраняется значение, заданное при ее объявлении. 

В целом работа с некоторым ресурсом, охраняемым семафором с име- 
нем, например, "Бет1"”, строится следующим образом. Семафор создается 
кодом: 
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1опа МахлтшимСоипе = ...; 
НАМОТЕ 5$ = Сгеафебетарнокге (МОТ, МахлтамСочпЕ, 
МахлиомСоцпе, "беп1"); 


Клиент ресурса, если он находится в другом потоке, соединяется с семафо- 
ром оператором: 


НАМОЬЕ $ = Орепбемтарпоге (ЗЕМАРНОКЕ АГ АССЕЗ55, гие, "5еп1"); 


Обращение к ресурсу оформляется следующим образом: 
РИОВКО Тзмеодце = 2000; 


// запрос ресурса 

ОИОВКО Вези1Е = Ма1ЕРГог51па1е05)]ес®е (5$, ТлиеОице); 
1Е (Вези1Е == МАТТ ОВХЕСТ 0) 

{ 


// операции с ресурсом 


// освобождение ресурса 

ВКе1еазебетарпоге ($, 1, №11); 

} 

е1зе . 
| 


// операции в случае, если не получен доступ к ресурсу 


3.5 Объекты событий 


Событие (еуеп$) — это синхронизирующий объект, который, как и другие, 
может быть в одном из двух состояний: свободен (сигнальное состояние) и за- 
нят (несигнальное состояние). Перевод некоторым процессом события в сво- 
бодное состояние служит сигналом для других процессов, что закончена ка- 
кая-то группа операций. Например, процесс может сообщить другим процес- 
сам, что прочитана некоторая информация из порта и теперь ее можно обраба- 
тывать. Или что результаты некоторого расчета занесены в файл, который мо- 
гут читать и использовать другие процессы. Или что получены сведения из 
удаленного модуля данных и их надо обработать. Словом, имеется много слу- 
чаев, когда требуется, чтобы одно приложение или поток известили об оконча- 
нии каких-то действий. 

Объекты событий бывают двух типов: сбрасываемые вручную или автома- 
тически. Событие, сбрасываемое вручную, остается в сигнальном (свободном) 
состоянии, пока не переводится в несигнальное состояние вызовом описанной 
далее функции Кезе{ЕуепЕ. Событие, сбрасываемое автоматически, переходит 
в несигнальное состояние в момент, когда возвращается одна из использую- 
щих его функций ожидания. 

Событие создается функцией СгеафеЕуепё: 

НАМОТЕ СгеафеЕуеп® (ТМ ГРЗЕСОВТТУ АТТАТВОТЕЗ 1рЕхеп АЕ г1аеез, 


_ ТМ ВОО БМапоа1Везее, ТМ ВООГ ЬТп1Е1а15$+ате, 
ТМ ГРСЗТВ 1рМапе); | 


Параметр 1рЕуе в АЙг лез является указателем на структуру типа ЗЕ- 
СИЩМТУ_АТТЕВОТЕ$ или Т$есигЦуА тг ще, определяющую, будет ли 
наследоваться возвращенный дескриптор дочерними процессами. См. описа- 
ние этой структуры в гл. 8. Значение параметра 1рЕуеп 6 АбгЮщез$ можно за- 
дать равным МОТТ.. Это будет означать, что дескриптор не наследуется, и что 
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будет использоваться дескриптор защиты процесса, заданный по умолчанию. 
Параметр БМапиа[Везеё определяет тип события: фгае — с ручным управле- 
нием, Ёа]5е — с автоматическим. Параметр Би На1$фафе задает начальное со- 
стояние: ёгие — сигнальное, #а]1$е — несигнальное. Параметр 1рМаше опреде- 
ляет имя объекта. Если имя соответствует уже существующему объекту, то па- 
раметры БМапиа|Везеё и Ба] {а{е игнорируются, так как они уже уста- 
новлены для события. Если при этом параметр 1рЕуеп АИ_гЬше$ не равен 
МО, то он задает только наличие или отсутствие наследования, а дескрип- 
тор защиты игнорируется. Параметр 1рМаще задает имя события и может рав- 
няться МОГ — тогда создается событие без имени. Такое событие можно ис- 
пользовать в рамках одного процесса. Но его невозможно контролировать 
в другом процессе. Имя события не должно совпадать с именем синхронизи- 
рующего объекта другого типа: мьютекса, семафора и т.д. 

В случае успешного выполнения функция СгежеЕуепте возвращает деск- 
риптор события. Этот дескриптор может использоваться в любых функциях 
ожидания. Функции будут ожидать, пока событие не перейдет в сигнальное 
состояние. 

Если событие, указанное в функции СгеэафеЕуеп, уже существует, то 
функция вернет его дескриптор. Узнать после вызова СгеавеЕуеп&, существо- 
вало ли раньше указанное событие, можно оператором: 


1Е (бсеертазеЕггог () ‘== ЕКВОВ_АТВЕАОУ _ЕХТЗТ5) 


Функции Зе Еуеп{ и Везе Еуеп{ устанавливают событие в сигнальное 
и несигнальное состояние соответственно: 


ВООТ 5ЗеЕЕуепЕ (НАМОЬЕ ВЕуепе); 
ВООТ ВезееЕхеп* (НАМОЪЕ ПЕуеп®); 


Управлять состоянием события можно также функцией Ри1$еЕуепф: 
ВОО Ра]1зеЕуепЕ (НАМОЬЕ РЕуеп®); 


Функция эквивалентна последовательному выполнению функций 5%6- 
Еуеп{ и ВезеЕуепф. В случае события с ручным сбросом это позволяет всем 
потокам, которые ждут событие и могут немедленно завершить ожидание (на- 
пример, ждут только это событие), выйти из ожидания. Затем функция 
Ри|5еЕуеп{ переводит событие в несигнальное состояние и возвращается. Для 
событий с автоматическим сбросом функция позволит одному из ожидающих 
потоков выйти из ожидания (если это возможно), после чего переведет событие 
в несигнальное состояние и вернется. 


Имеется функция ОрепЕуепеЕ: 


НАМОЬЕ ОрепЕуеп® (РИОВОР амрез1гедАссезз$, ВОО ЮТпбег1&Напа1е, 
ЪРСТСТВ 1рМапе); 


которая открывает существующий объект события с именем шМаще и возвра- 
щает его дескриптор. Параметр амОез1тге4Ассе$5 может принимать значение 
ЕУЕМТ_АТТ. АССЕЗ5З — полный доступ к объекту, ЕУЕМТ_МОШТЕУ_$ЗТА- 
ТЕ — возможность использования объекта в функциях Зе Еуеп{ и Кезе{- 
Еуетф, ЗУМСНКОМТАЕ — использование объекта в функциях ожидания. Па- 
раметр ЫМпвеги Нап Ще определяет, будет ли наследоваться возвращенный де- 
скриптор дочерними процессами. При значении %&ёгие будет наследоваться. 


190 Глава 3. Синхронизация процессов и потоков 


Функция ОрепЕуепф возвращает дескриптор только в случае, если объект 
события уже был создан каким-то процессом. В противном случае возвращает- 
ся МОШ.. 


Простейший вариант использования объекта события — введение задерж- 
ки на заданное число миллисекунд: 


НАМОТЕ Н = СгеафкеЕхухепе (МОГ, Егае, Еа15$е, ""); 
Иа1ЕЕГог51п91е0Б]ес®(Н, 3000); 


Приведенный код можно свернуть в один оператор: 


Иа1Рох$1п91е053ес+ (СгеакеЕ\епе (МОЪЬ, Егое, Еа15зе, ""), 3000); 


Подобное осуществление задержки эквивалентно использованию функции 
З]еер (см. раз. 3.1): 


51еер (3000); 


но несколько меньше нагружает процессор. Правда, сознаюсь, что мне ни разу 
не удалось экспериментально зафиксировать это снижение нагрузки. Так что 
я все-таки предпочитаю использовать Чеер. 

Теперь посмотрим, как можно организовать с помощью объектов событий 
взаимодействие процессов или потоков. Пусть, например, в одном приложе- 
нии (процессе, потоке) в какие-то моменты времени готовятся некоторые дан- 
ные, которые должны быть обработаны какими-то двумя другими независи- 
мыми и параллельно работающими приложениями (процессами, потоками). 
После того как последний из этих вспомогательных процессов закончит обра- 
ботку, можно продолжать выполнение первого приложения. 

Тогда в первом приложении в обработчик щелчка на какой-то кнопке 
можно поместить код: 


НАМОЬЕ Е[ 2]; 
Е[0] = СгеабеБуепф (МОЪТ, $гое, Еа1зе, "МуЕуеп®2"); 
Е[1] = СгеакеЕуеп® (МОГ, $гое, Еа15е, "МуЕуепЕЗ"); 


НАМОЬЕ Н = СгеафеЕуепе (МОТТ, гие, Еа15е, "МуЕуепЕ1"); 
// операции подготовки данных 


// установка события МуЕуепЕ1 

оефсЕхеп® (Н); 

// ожидание событий `МуЕуепЕ2 и МуЕуепЕЗ 

Маз ЕогМи1е1р1е05)]есез (2, Е, Егице, ТМЕТМТТЕ); 
КезеЕЕуептЕ (Е [0]); 

КезееЕхеп® (Е [1]); 

ВезетЕуеп® (Н);. 

// продолжение выполнения 

// после установки событий МуЕуепЕ?2 и МуЕуепЕЗ 


В этом коде создаются дескрипторы трех объектов событий. Дескриптор Н 
относится к событию "МуЕуеп%41", которым приложение будет извещать дру- 
гие заинтересованные приложения об окончании подготовки данных. Деск- 
рипторы событий "МуЕуеп&2” и "МуЕуеп&3”" заносятся в массив Е. Эти собы- 
тия будут использоваться приложением для получения информации от внеш- 
них приложений. Все дескрипторы создаются для объектов с ручным сбросом, 
и начальное состояние всех событий несигнальное. 

После завершения операций, связанных с подготовкой данных, функцией 
Зе{Еуеп{ событие "МуЕуеп{1"” переводится в сигнальное состояние, которое 
будет воспринято другими приложениями. Затем вызывается функция \МаЦ- 
РГогМи И р!е0Оес{$, обеспечивающая ожидание до тех пор, пока оба события 
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"МуЕуеп+%2" и "МуЕуеп&3" не окажутся в сигнальном состоянии. После этого 
работа приложения будет продолжена. Перед продолжением работы все собы- 
тия сбрасываются в несигнальное состояние функцией ВКезе Еуепф. Это не обя- 
зательно делать, если приведенный код выполняется только один раз. Но если 
предусматривается возможность многократного обращения к этому коду, то 
без сброса событий повторное выполнение кода будет ошибочным. Поскольку 
окончание ожидания наступает при сигнальном состоянии событий “Му- 
Еуеп{2" и "МуЕуеп&3", то оно сохранится, и при повторном обращении 
к функции УацЕогМиИр!еО ес ожидание не состоится. 

В другом приложении, которое должно реагировать на событие “Му- 
Еуеп{1" и по окончании каких-то операций известить об этом первое приложе- 
ние через событие "МуЕуеп&2”", можно в обработчик щелчка на какой-то кноп- 
ке поместить код: 

НАМОЬЕ Н = СгеафеЕуеп® (МОТ, &гие, Еа15е, "МуЕуеп® 1"); 


Иа1ЕЕГог51па1е0Б]есе (Н, ТМЕТМТТЕ); 
// начало обработки данных, подготовленных первым приложением 


// сообщение об окончании обработки 
зесЕхуеп® (ОрепЕ\уеп® (ЕУЕМТ_АЬЬ АССЕ$$, гие, "МуЕуепк2")); 


Код начинается с создания дескриптора Н события “`МуЕуеп{1” и ожида- 
ния того, когда это событие будет переведено первым приложением в сигналь- 
ное состояние. Когда это происходит, начинается обработка полученных дан- 
ных. После этого функцией ОрепЕуеп{ открывается дескриптор события "Му- 
Еуепт{2" и функцией Зе Еуеп& событие переводится в сигнальное состояние. 
| В третьем приложении, которое должно реагировать на событие “"Му- 

Еуеп%1 " и по окончании выполнения каких-то операций известить об этом пер- 
вое приложение через событие "МуЕуеп{3", можно поместить аналогичный 
код, изменив в нем только имя события. 

Можете создать описанные приложения, промоделировав выполнение опе- 
раций подготовки и обработки данных просто задержками на разные отрезки 
времени и сообщениями пользователю. Вы сможете убедиться, что обеспечили 
синхронную работу трех приложений. 

Несколько иначе надо организовывать взаимодействие приложений, если 
использовать события с автоматическим сбросом. В этом случае код первого 
приложения может быть изменен следующим образом: 


НАМРЬЕ Е [2]; 
Е[0О] = СгеакеЕуеп® (МОТ, #а]зе, Еа15зе, "МуЕхепе2"); 
Е[ 1] = СкеафеЕуепе (МОТТ, #а]1зе, Еа1зе, "МуЕуепЕЗ"); 


НАМОЬЕ Н = СгеафеЕуеп® (МОТЬ, Ха]1]зе, Еа15е, "МуЕуеп®1"); 
// операции подготовки данных 

ЗВомМеззаде ("операции подготовки данных"); 

// установка события МуЕуепЕ1 

ЗПомМеззаде ("установка события МуЕуеп®1"); 

зесЕуеп® (Н); 

// ожидание событий МуЕуепЕ?2 и МуЕуепЕЗ 

ЗПомМеззасе ("ожидание событий МуЕуеп®2 и МуЕуеп®3"); 
Ма1ЕЕГохгМи11р1е0ю)ес+з (2, Е, %гае, ТМЕТМТТЕ); 
ВезееЕуеп® (Н); 

ЗРомМез5заде ("продолжение выполнения"); 

// продолжение выполнения 

// после установки событий МуЕуепЕ2 и МуЕуепЕЗ 
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Отличие от кода, приведенного ранее, заключается в задании #а]5е в каче- 
стве значений вторых аргументов в вызовах функции Сгеа&еЕуеп& (выделено 
жирным шрифтом), и в отсутствии сброса функцией Везе!Еуепф событий с де- 
скрипторами ©] и Е 1. Эти события автоматически установятся в несигналь- 
ное состояние, как только вернется ожидавшая их функция УайЦЕогМи Шр!е- 
ОБ]есё$. Сброс события Н в коде оставлен по причинам, рассмотренным далее. 

Код второго (и третьего) приложения должен быть изменен следующим об- 
разом: 

НАМОТЕ Н = СгеафеЕхуеп® (МОЪГ, #а1зе, Еа1зе, "МуЕхепЕ 1"); 

Ма1ЕГог51п91е0р)ес® (Н, ТМЕТМТТЕ); 


ЗееЕхеп* (Н); 
// начало обработки данных, подготовленных первым приложением 


// сообщение об окончании обработки 
зесЕуепе (ОрепЕуеп{ (ЕУЕМТ_АТТ АССЕ$55, 6гие, "МуЕуеп%2")); 


Жирным шрифтом выделены изменения по сравнению с приведенным ра- 
нее кодом. Принципиальной является установка функцией Зе Еуепф события 
Н после окончания ожидания. Дело в том, что в нашем примере события Н 
ждут два приложения. То из них, которое раньше другого перешло в режим 
ожидания, получит сообщение о нем, состояние события с автоматическим 
сбросом в этот момент перейдет в несигнальное, и, значит, другое ожидающее 
приложение будет ждать это событие вечно. Чтобы этого не произошло, собы- 
тие после окончания ожидания явно устанавливается в сигнальное состояние 
функцией Зе Еуепф. Но в этом случае после завершения ожидания во всех 
ожидавших его приложениях оно останется в сигнальном состоянии. Поэтому 
в приведенном выше коде первого приложения оно должно сбрасываться 
функцией ВКезе{ Еуепф в несигнальное состояние. 

Приведенные примеры несколько упрощены для большей наглядности. 
В то же время, они не учитывают некоторые ситуации, которые могут забло- 
кировать приложения. Например, в них предполагается, что все задействован- 
ные в примере приложения все время выполняются, и что приложения, вос- 
принимающие сигнал "МуЕуеп+1", вовремя переходят в режим ожидания это- 
го сигнала, или хотя бы перейдут в него когда-нибудь. Нарушение любого из 
этих условий приведет к блокировке приложения, причем такое заблокиро- 
ванное приложение даже нельзя будет закрыть с помощью стандартных опера- 
ций с мышью и клавиатурой. Последнее обстоятельство связано с тем, что при- 
ложение в режиме ожидания не воспринимает никакие направленные ему со- 
общения \У’1п4о\$. Как устранить этот недостаток с помощью функции 
М5 \МУацЕогМо р еОЦесё$ было рассказано в разд. 3.3. Так что остановимся 
только на вариантах предотвращения блокировки в нашем примере. 

Перед тем, как первое приложение переходит в режим ожидания событий 
"МуЕуеп%2” и "МуЕуеп{3", полезно было бы убедиться, что приложения, от 
которых должны поступить эти сообщения, в данный момент выполняются 
и перешли в режим ожидания события "МуЕуеп{1”. А перед завершением пер- 
вого приложения полезно было бы известить два других приложения, что ра- 
бота окончена, и им уже нечего ждать. Кроме того, эти два другие приложения 
прежде, чем переходить в режим ожидания события "МуЕуеп{1", должны бы 
убедиться, что первое приложение выполняется. В противном случае им не 
надо переходить в режим ожидания, который заблокирует их. 

Думаю, что вы сами сможете продумать логику подобной синхронизации 
работы приложений, используя для открытия событий функцию ОрепЕуепф, 
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которая возвращает #а]5е в случае, если событие отсутствует. Тем самым 
функция может определить, работает ли приложение, которое должно созда- 
вать то или иное событие, и создало ли оно это событие. 

В С++Ви!аег имеется класс ТЕуепф, который инкапсулирует объект собы- 
тия. Он имеет свойства Нап е, Газ Еггог и методы Зе Еуепф, Кезе\ Еуецф, Ве- 
]еазе, \УаЦЕог. Нетрудно понять назначение этих свойств и методов. Но, чест- 
но говоря, я не очень понимаю, чем упрощает этот класс работу с событиями. 


3.6 Таймеры ожидания 


Таймер ожидания (\ма{цае &$1тег) — это объект синхронизации, переходя- 
щий в сигнальное состояние в указанное время, или регулярно с заданным пе- 
риодом. 

Объекты таймеров, как и рассмотренные в разд. 3.5 объекты событий, бы- 
вают двух типов: сбрасываемые вручную. и сбрасываемые автоматически или 
синхронизируемые таймеры. Таймер, сбрасываемый вручную, остается в сиг- 
нальном (свободном) состоянии, пока не переводится в несигнальное состояние 
вызовом описанной далее функции Зеё \УаЦаеТ!1 тег. Таймер, сбрасываемый 
автоматически, переходит в несигнальное состояние в момент, когда возвра- 
щается одна из использующих его функций ожидания. 

Таймер создается функцией Сгеэж{е\аЦаМ]еТ!итег: 

НАМОТЕ Сгеабейа1фаю1еТ1тег ( 


ТМ ГРЗЕСОВТТУ АТТВТВОТЕ$ 1рТ1мегА Е г1рисез, 
ТМ ВООЪ ЮМапоа1Везе*, ТМ ТГРСЗТВ 1рТ1мегМапе); 


Параметр 1рТипегА г Ьще$ является указателем на структуру типа ЗЕ- 
СОВТТУ_АТТВТВОТЕ$ или ТЗесогцНуА г ще$, определяющую, будет ли 
наследоваться возвращенный дескриптор дочерними процессами. См. описа- 
ние этой структуры в гл. 8. Значение параметра 1рТипегА г Ьве$ можно за- 
дать равным МОТЕГ. Это будет означать, что дескриптор не наследуется, и что 
будет использоваться дескриптор защиты процесса, заданный по умолчанию. 
Параметр БМапиа1Везе{ определяет тип события: фгиае — с ручным управле- 
нием, #Ёа]5е — с автоматическим. Параметр 1рТипег Мате определяет имя тай- 
мера. Если имя соответствует уже существующему объекту, то параметр 
ЪМапиа!Везеё игнорируется, так как он уже установлен для таймера. Если 
при этом параметр рТипегА  вг1Ьиве$ не равен МОД, то он задает только на- 
личие или отсутствие наследования, а дескриптор защиты игнорируется. Па- 
раметр 1рТипегМате задает имя таймера и может равняться МОТТ, — тогда 
создается таймер без имени. Такой таймер можно использовать в рамках одно- 
го процесса. Но его невозможно вызывать в другом процессе. Имя таймера не 
должно совпадать с именем синхронизирующего объекта другого типа: мью- 
текса, семафора, события и т.д. 

В случае успешного выполнения функция Сгезе\УаЦаМеТитег возвра- 
щает дескриптор таймера. Этот дескриптор может использоваться в любых 
функциях ожидания. Функции будут ожидать, пока событие не перейдет 
в сигнальное состояние. Обратите внимание на то, что таймер, создаваемый 
функцией Сгеже\УаЦаМеТипег, первоначально всегда находится в несиг- 
нальном состоянии. 

Если таймер, указанный в функции Сгеаёе\УацаМеТ!тег, уже существу- 
ет, то функция вернет его дескриптор. Узнать после вызова Сгез&е\а{- 
а еТ1тег, существовал ли раньше указанный таймер, можно оператором: 
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1Е (СесТаз®Егхгог() == ЕВКОК _АТКЕАРУ_ЕХТЗТ5) 


Доступ к существующему таймеру дает функция Ореп\'ацаМеТ!тег: 


НАМОЪТЕ ОрепМа1каЪ1еТ1пет (ТМ ОРИОВР амрез1хгеаАссез$, 
ТМ ВООГ БТрБег1Нара1е, 
ТМ БРСЗТВ 1рТзмегМапе); 


Она возвращает дескриптор существующего таймера с именем рТипегМате. Па- 
раметр 4мОезгеЧАссе5з$ может принимать значения ТТМЕВ_АТШ, АССЕ$З$ — 
полный доступ к объекту, ТТМЕВК_МОШТЕУ_$ЗТАТЕ — возможность использова- 
ния объекта в функциях Зе \МаЦаеТитег и Сапсе@ \УаЦаеТ! тег, ЗУМСНКО- 
МТАЕ — использование объекта в функциях ожидания. Параметр Бшпег Нап Ме 
определяет, будет ли наследоваться возвращенный дескриптор дочерними про- 
цессами. При значении %&ёгие будет наследоваться. 

Функция Ореп\УацаШеТипе возвращает дескриптор только в случае, 
если таймер уже был создан каким-то процессом. В противном случае возвра- 
щается МОГ. 

Функция Зе \УаЦаеТипег активирует таймер: 

ВООГ Зе Ма1кар1еТ1тех (ТМ НАМОТЕ ВТ1мек, 

ТМ№ сопзЕ ТАВСЕ ТМТЕСЕВ *1рраеТапе, 
ТМ ТОМС 1Рег1оа, 
ТМ РТТМЕВАРСКООТТМЕ рЕПСошр1ее1опВоче1те, 


ТМ ГРУОТР 1рАгчТоСоптр1е1опКоце1пе, 
ТМ ВООЬ ЕБезипме); 


Параметр 1рбиеТиие является указателем на структуру типа _ГАВ- 
СЕ ТМТЕСЕВ: 
суреаеЕ ип1оп _ТАВСЕ ТМТЕСЕВ { 
5ЕкасЕ { | 
РИОВКО ГомРаг*; 
ТОМС Н1арРаг*; 
}; 
.ОМСЬОМС ОцааРаг%; 
} ТАВСЕ ТМТЕСЕВ; 


Эта структура, хранящая время в сотнях наносекунд, является объедине- 
нием, которое хранит данные или в 64-разрядном поле ЯцааРагё, или, если 
компилятор не поддерживает 64 бита, то в полях Г0о\мРагё и НИ Рагф. Подроб- 
нее об этой структуре см. в разд. 1.15.1. 

Если при вызове Зе \“аЦаеТ!тег в структуре заданы положительные 
значения, это указывает на момент времени, в который таймер должен перейти 
в сигнальное состояние. Отрицательные значения задают относительное вре- 
мя — через какой отрезок времени таймер перейдет в сигнальное состояние. 

Параметр П1Рего@4 определяет период срабатывания таймера. Если ПРеш- 
о4 = 0, таймер сработает (перейдет в сигнальное состояние) только один раз. 
Если задано положительное значение Г!Рего@, то таймер будет срабатывать 
многократно, вплоть до его сброса функцией Сапсе \ацаЛеТ!тег или до его 
переустановки новым вызовом функции Зе \МаЦаШеТ1тег. Периодически ра- 
ботающий таймер переключается в сигнальное состояние в конце каждого пе- 
риода, а затем переходит в несигнальное состояние и ждет наступления сле- 
дующего периода. При отрицательном значении параметра 1Рег1о4 функция 
Зе \УаЦаШеТ!итег возвращает #а[$е. 

Параметр рРпСотшр]ейопКоиИпе указывает функцию завершения, кото- 
рая вызывается при переходе таймера в сигнальное состояние. Если указать 
параметр р7пСошрейопВои пе равным МОГГ, никакая завершающая функ- 
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ции не задается. Но можно в качестве параметра р7пСотр!еНйопКоп@ ше ука- 
зать функцию завершения, тип которой объявлен так: 
суредеЕ Уотр (АРТЕМТВУ *РТТМЕБАРСВООТТМЕ) ( 
ТРУОТО 1рАгаТоСотр1ее1опВКоце1пе, 


РИОКОр аАмТ1мегГомУа1ае, 
ОИОВР аАмТ1мегН1апУа11е); 


Ее параметр 1рАг=ТоСотр]ейопКоцИпе учазызвает произвольную струк- 
туру или иной тип данных. Этот указатель передается параметром 1рАг#То- 
СошрейопВоцИпе функции Зеё \УаЦаШеТ!тег в момент активизации тайме- 
ра. Через этот параметр можно передать в функцию завершения какую-то ин- 
формацию. Например, текст, сообщающий о событии, связанном с таймером. 
Параметры амТипегГ.омУаШше и 4\“Т1пегН1ВУаше соответствуют полям 
структуры типа ЕЕ ИТ МЕ (см. разд. 1.15.1), содержащим информацию о вре- 
мени, когда таймер перешел в сигнальное состояние. 

Параметр ЁВезиште имеет смысл при работе на компьютерах, поддержи- 
вающих спящий режим. Если этот параметр равен фгае, то при срабатывании 
таймера компьютер выйдет из спящего режима, и ожидавшие его потоки нач- 
нут выполняться. Таким образом, компьютер, даже находящийся в спящем 
режиме, напомнит вам о какой-то важной встрече или о телефонном звонке, 
который вы обязательно должны сделать. Если вы задали ЁВезите = фгие, 
а компьютер не поддерживает спящий режим, вызов функции Зе \УаЦае- 
Типег завершится нормально, но последующий вызов функции Се Таз Еггог 
вернет значение ЕККОВ_ МОТ 5ЗОРРОВТЕО — режим не поддерживается. 


Мы рассмотрели множество параметров функции Ореп\ацаШеТите, ко- 
торые, конечно, трудно сразу усвоить. Но прежде, чем переходить к приме- 
рам, надо упомянуть еще об одной функции — Сапе@ \УаЦцЦаеТ1тех: 


ВОО Сапсе1Ма1каб1еТзтех (НАМОЬЕ БТ1пех); 


которая устанавливает таймер в неактивное состояние. 

Вот теперь можно переходить к примерам. Пусть мы хотим для начала ре- 
шить тривиальную задачу: задержать выполнение на заданный отрезок време- 
ни, например, на 10 секунд. Это можно сделать кодом: 

НАМОЬЕ Т = Схгеакема1кар1еТ1мег (МОТ, гие, "Т1мет1"); 

ТАВСЕ ТМТЕСЕВ ЕТ; 

ЕТ.ОцаЧРак® = -50000000; 

ЗеЕМа1Еаб1еТ1мет (Т, &ЕТ, 0, МОГ, МОЬЬ, Еа]15е); 


Иа1ЕРГог51па1е0Ь)]есе (Т, ТМЕТМТТЕ); 
Сапсе1Ма1Еаф1еТ1мехг (Т); 


Первый оператор кода создает таймер и передает его дескриптор в пере- 
менную Т. Далее объявляется переменна ЕТ типа ГАВКСЕ ПМТЕСЕК. В ее 
поле ОдпаЧ4Рагё заносится значение —50000000. Число 50000000 — это’ 5 се- 
кунд, выраженные в сотнях наносекунд. Отрицательная величина указывает 
на то, что это относительное время, т.е. задержка относительно текущего вре- 
мени. Функцией Зе \аЦаеТ!1тег производится активация таймера, и с это- 
го момента начинает отсчитываться задержка. Функция УаЦЕог5тбеОес+ 
ожидает переход таймера в сигнальное состояние. После этого функцией 
Сапсей\У\аЦаеТ1тег таймер деактивируется. Так что если далее будут встре- 
чаться функции ожидания, они будут немедленно возвращаться. 

Если вы в процессе дальнейшего выполнения потока захотите опять вы- 
полнить какую-то задержку, вам не надо будет повторять создание таймера. 
Достаточно будет выполнить опять его установку функцией Зе \УаЦаЫе- 
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Типег, указав в структуре ЕТ новое значение задержки, или не изменяя поле 
этой структуры, если требуется задержка той же величины. Кстати, для пере- 
настройки таймера не обязательно перед этим деактивировать его функцией 
Сапсе\У\аЦаМеТ1 тег. Так что этот вызов можно удалить из показанного 
выше кода. А когда таймер вам больше не потребуется, его надо удалить, вы- 
звав функцию С1о5еНап4е. 

Теперь нопробуем решить ту же задачу, но напишем функцию завершения 
и передадим в нее строку текста. Функция завершения может выглядеть, на- 
пример, так: 

УОТР АРТЕМТКУ МуЕопс (ЪРУОТР 1рАгаТоСопр1е1опВой&1пе, 


РИОВО АмТ1мегЬомУа1ае, — 
РИОВР АмТ1мегН1арУа1ще) 


{ | 
ЗВомМеззаце ( (спаг *) 1рАгаТоСотр1ее 1опВКоцЕ1пе); 


} 


Подразумевается, что через параметр 1рАгеТоСотрейопВоцйпе в функ- 
цию передается строка текста. | 

Установка таймера и вызов нашей функции в момент его срабатывания 
осуществляется следующим кодом: 

срак * $ = "Это таймер 1"; 

ЗесИа1фар1еТ1тег (Т, &ЕТ, 0, МуРГипс, 5, Еа]1зе); 

$]еерЕх (ТМЕТМТТЕ, ТВОЕ); 


Через отрезок времени, установленный в структуре ЕТ (см. приведенный 
ранее пример), ожидание, организованное функцией ЗЧеерЕх, завершится, бу- 
дет выполнена функция МуЕипс, которая прочтет переданную в нее строку 5, 
после чего функция ЗЧ]еерЕх вернется. 

В предыдущих примерах таймер использовался для установки задержек. 
Теперь рассмотрим пример, когда таймер устанавливается на определенный 
момент времени. Тут надо решать две задачи. Во-первых, устанавливать дату 
и время непосредственно в структуре типа ГАВКСЕ 1МТЕСЕК неудобно. Про- 
ще использовать для этого или структуру типа ЗУЗТЕМ'ИМЕ, или формиро- 
вать различными методами данные в формате Т)афеТ!ите. Во-вторых, задавать 
удобнее, конечно, локальное время, а при установке таймера в структуре 
ГАВСЕ_ ТМТЕСЕВ должно лежать универсальное время ОТС. Так что задан- 
ное время надо преобразовать в универсальное. Функции и приемы, исполь- 
зуемые при всех этих преобразованиях, подробно рассмотрены в разд. 1.15.1. 
и 1.15.2. Так что если в приведенных далее кодах будет что-то не понятно, по- 
смотрите эти разделы. 

Рассмотрим сначала пример с использованием структуры ЗУЗТЕМТТМЕ. 
Пусть мы хотим, чтобы таймер сработал в первый раз 1 мая 2004 года в 10 ча- 
сов 30 минут, а потом срабатывал бы в это время каждый день. Ниже приведен 
код, решающий эту задачу: 

ЕТЬЕТТМЕ Госа1, ОТС; 

ЗУЗТЕМТТМЕ 3%; 

ТАВСЕ ТМТЕСЕВ 11; 

// создание таймера | 

НАМОГЕ ВТ1иег = Сгеакема1+аю1еТ1мег (МОТ, ЕКАТЪЗЕ, №11); 

// задание даты и времени 

5е.мУеаг = 2004; 

56.мМопЕеП = 5; 

5Е.мрау = 1; 

5Е.мНочцхг = 10 


$. мМатпа се 30; 
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// перевод в формат ЕТТЕТЛМЕ 

ЗузсешТ1теТъоЕ11еТ1те (&$6, &Госа1);// перевод во время ИТС 
Тоса1Е11еТ1теТоЕ1]еТ1пе (&Госа1, &0ТС); 

// занесение данных в ГАВКСЕ ТМТЕСЕК 

11.БомРаг® = ОТС. амомрафеТ1ме; 

11.НзарРаг® = ОТС.амН1апра®еТ1те; 

// установка таймера 

беЕейа1Еаю1еТ1мег (ПТ1мег, &11, 24 * 60 * 60 * 1000, МОТГЬ, МОТЬ, РАЪЗЕ); 


В коде прокомментирован каждый оператор, так что вряд-ли требуются 
дополнительные пояснения. Обратите внимание только на задание периода 
в вызове функции Зе \УаЦаеТ!тег. Период задается как коэффициент 
1000, умноженный на число секунд в минуте (60), на число минут в часе (60) 
и на число часов в сутках (24). | 

В приведенном примере дата и время формировались в структуре 5У5$- 
ТЕМТТМЕ. Не менее удобно формировать их в переменной типа ТРафеТ!ите 
функцией Епсодера4еТ!те: 

бузеем: :ТРафеТ1ме __Еаз®са11 Епсо4ера®еТ1ме (сопзЕ Мога Ауеак, 

соп5е ИМога АМопфр, соп5Ее Мога Арау, 


соп$Е МогА АНоцг, сопзЕ Мога АМлпаке, 
сопзЕ Мога Абесопа, сопзЕ Мога АМ11115есопа); 


Функция возвращает дату и время, сформированные из заданных в каче- 
стве аргументов года, месяца, дня, часа, минуты, секунды и миллисекунды. 
Так что в приведенном выше примере можно было бы заменить задание значе- 
ний полей структуры $# операторами: 


Зузсем: :ТРабеТ1те Т = ЕпсодерафеТ1ме (2004, 5, 1, 10, З0, 0, 0); 
ПРафеТтТ1теТобузсемТаме (Т, $36); 


Остальные операторы примера можно оставить прежними. Только в модуль 
надо включить директиву 


#1пс1аАе <Ра®е0е11$.Прр> 


Без подключения файла Даёе0115.Прр компилятор не сможет работать с функ- 
цией Епсодера{еТ!те. 
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Порождение дочерних процессов, т.е. запуск из одного приложения дру- 
гих приложений, может осуществляться многими способами: функциями се- 
мейств ехес... и зрамт..., функцией У\УтшЕхее, функцией СгезжеРгосе$$. Все 
эти возможности подробно рассмотрены в книгах [1], [2], [5], [6], а я обещал 
себе не повторять то, что изложено в них. К теме синхронизации, в частности, 
относятся функции семейства 5рамт..., позволяющие организовать ожидание 
завершения порожденного процесса. Так что если функции этого семейства 
вам не очень знакомы, посмотрите их в перечисленной литературе, или в [4]. 
Но в отношении функции СгеафеРгосе$$ я отступлю от обязательства не повто- 
ряться и опишу ее несколько более подробно, так как иначе картина объектов 
ожидания будет не полной. Еще более полное описание вы найдете в гл. 8. 

Функция СгезеРгосе$$ объявлена следующим образом: 

6оо1 __ЁЕаз®са11 Сгеа®еРгосез$ ( 

сопзЕ сраг * 1рАрр]11сае1опМапте, 
спаг * 1рСоммапаГлпе, 


_ЗЕСОВТТУ АТТВТВОТЕ$ * 1рРгосеззА&к1Юикез, 
_ЗЕСОВТТУ АТТВТВОТЕ$ * 1рТЬгеааАЕЕх16оеез, 
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Боо1 БТпВех1ЕНапа1ез, 

ип51апеЯ 1опд АмСгеа®1опЕ1ааз, 

Ууо1а * 1рЕпу1копмепе, 

соп$Е срагк * 1рСаггеп®О1гесфкоку, . 
ЗТАВКТОРТМЕО * ]1р5ваг®арТпЕо, 

РВОСЕ55 ТМЕОВМАТТОМ * 1рРгосезз1пЕогма&1оп); 


Функция порождает новый дочерний процесс и его первый поток (нить). 
В рамках этого процесса выполняется указанный файл 1рАррНсайопМаше 
с командной строкой 1рСоттапа Г те. Впрочем, параметр 1рАррПеаНопМате 
может быть равен МОТ, а имя выполняемого модуля в этом случае должно 
быть первым элементом командной строки, задаваемой параметром 1рСот- 
тапаГС те. Сам выполняемый модуль может быть любого вида: 32-разрядным 
приложением \УтЧомз, приложением МБ-0ОБ, ОБ/2 и т.п. Однако если из 
приложения \У/14Ч0\5$ создается процесс М$-ООБ, то параметр 1рАррИса- 
НопМате должен быть равен МО, а имя файла и его командная строка 
включаются в рСотштап@Гте. Так что, как правило, чтобы не ошибиться, 
проще всегда задавать 1рАррИсайЙопМаше = МОТТ, и помещать всю информа- 
цию в рСоттапа! те. 

_ Если имя файла не содержит расширения, то предполагается расширение 
‚ехе. Но если имя кончается символом точки или если файл задан вместе с пу- 
тем, то расширение .ехе к имени не добавляется. Если имя файла указано без 
пути, то \У/ш4о\з будет искать выполняемый файл в определенной последова- 
тельности, описанной в гл. 8. 

Параметры рРгосез5А_Нг ще и 1рТЬгеад А г! ще$ являются указате- 
лями на структуры типа ЗЕСОВКТУ_АТТЕТВОТЕ$ (см. описание этой струк- 
туры в гл. 8), определяющие соответственно для процесса и потока, будет ли 
наследоваться возвращенный функцией дескриптор дочерними процессами. 
Эти структуры задают также дескригтор защиты. Значения параметров 
1рРгосез5 АН Юще5 и 1рТИгеадаАНгЮше$ можно задать равными МО. Это 
будет означать, что дескриптор не наследуется и используется дескриптор за- 
щиты по умолчанию. 

Параметр Бшпег Нап М4]е$ определяет наследование порождаемым про- 
цессом дескриптора родительского процесса. | 

Параметр 4мСгеаНопЕ1а55 определяет флаги, задающие характеристики 
создаваемого процесса. Ряд флагов определяет наследование порождаемым 
процессом ряда характеристик родительского процесса. Перечень этих флагов 
приведен в описании функции СгежеРгосе$$ в гл. 8. 

В большинстве случаев можно не устанавливать ни один из перечислен- 
ных флагов. Тогда характеристики порожденного процесса и его взаимодейст- 
вие с родительским процессом будут установлены по умолчанию. 

Флаги, включаемые в параметр 4мСгеаНоп Е 1а5$, задают также приоритет 
выполнения порожденного процесса. Приоритет задается одним из этих фла- 
гов: 
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`ВЕАГТМЕ_1 РЕТОВТТУ _ [Высокий пр приоритет, превышающий приоритеты дру- 
| СГА$5 гих процессов, включая приоритеты процессов опе- 

| рационной системы. Назначать подобный приоритет 
| ‚можно только в особых случаях, например, при не- 

‚ обходимости немедленно реагировать на какое-то ап- 


‚ паратное средство. Процесс с таким приоритетом мо- 


| _| жет нарушить работу системы. 


НТСН_РЕЛТОВТТУ _ _ | Указывает на процесс как на критическую задачу, 
СГАУ ‘которая должна выполняться немедленно. Подобный 


‚процесс может, например, прервать другие прокес- 


`сы, зависшие в бесконечном цикле, чтобы закрыть 
их. Для обычных процессов такой приоритет исполь- 
зовать нежелательно. — 
АВОУЕ _ МОВМАТ, Приоритет, промежуточный между Веа! и Могта|. 
| РЕТОВТТУ_ СТА$$. еле начиная с Утао\мз 2000. 
МОКМАГ РЕОЕВТУ _ Нормальный приоритет процесса. 


СГА _ о о 
ВЕГОУ” _ МОБВМАГ,_ Приоритет, промежуточный между Могта| и 14е. | 
РЕТОЕ!ТУ _ С.А$$_ Введен, начиная с \М/Уш4о\з 2000. __ 
ГОГЕ_РЕВТОВТТУ _ Все потоки процесса выполняются только во время 

| СГАЗ5 простоя системы. Примеры — хранители экрана 


и средства мониторинга, собирающие информацию 
о системе. Все наследники такого процесса будут | 
‚иметь тот же класс приоритета. 


Приоритет, установленный для процесса, является базовым классом при-. 
оритетов всех его потоков. Подробнее о приоритетах см. в разд. 3.8. 


Параметр 1рЕпу1гоптеп& определяет назледование дочерним процессом 
переменных окружения родительского процесса. Если этот параметр равен 
МОЕ, то порождаемый процесс наследует блок переменных окружения, ис- 
пользуемый в родительском процессе. Так что через переменные окружения 
можно передать в дочерний процесс какую-то дополнительную информацию 
(см. разд. 1.13). Но в параметре 1рЕпу1гоптеп& можно задать указатель на 
другой блок, отличный от используемого родительским процессом. 

Параметр 1рСиаггеп Олгесогу указывает на строку, определяющую текущий 
каталог и диск дочернего процесса. Это используется в приложениях-оболочках, 
выполняющих различные приложения с различными рабочими каталогами. 
Если параметр равен МОЩШ,, текущий каталог совпадает с родительским. 

Параметр 1р$фагеар Шо указывает на структуру типа ЗТАВТОРТМЕО 
(ГЭфагеар То), определяющую основное окно дочернего процесса. Единствен- 
ное поле, которое обязательно должно быть заполнено в этой структуре — 
поле сЪ. Оно указывает размер в байтах данной структуры. Остальные поля 
можно не заполнять, что обеспечит вид окна по. умолчанию. Так что не будем 
отвлекаться на их описание. Эта структура подробно рассмотрена в описании 
функции СгежеРгосе$$ в гл. 8. 

Параметр 1рРгосез$ш{огтаЙоп указывает на структуру ТРгосезпогта- 
Йоп, из которой родительское приложение может получать информацию о вы- 
полнении нового процесса. Ее поля обозначают следующее: 
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ВРгосе$$5 Возвращает дескриптор созданного процесса. Используется во’ 
всех функциях, осуществляющих операции с объектом процесса. 


ВТЬгеаа Возвращает дескриптор первого потока созданного процесса. Ис- 
пользуется во всех функциях, осуществляющих операции с объ- 
ектом потока. 


4\/Ргосез$1Т4 | Возвращает глобальный идентификатор процесса. Значение до- 
ступно с момента создания процесса и до момента его завершения. 


4\ТЬгеа ТА |Возвращает глобальный идентификатор потока. Значение доступ- 
но с момента создания потока и до момента его завершения. 


Если функция СгеаёеРгосе$$ успешно выполнена, она возвращает ненуле- 
вое значение (гие). Если произошла ошибка — возвращается 0 (#а15е). Тогда 
информацию об ошибке можно получить, вызвав функцию Се Га Еггог. 

Порожденный процесс остается в памяти системы, пока не завершатся все 
его потоки и пока все его дескрипторы не закроются вызовом С1озеНапШе. 
Если эти дескрипторы не нужны, лучше всего закрыть их сразу после инициа- 
лизации процесса. Чтобы досрочно прекратить выполнение дочернего процес- 
са лучше всего использовать функцию Ех Ргосез$: 


УОТО Ех1ЕРгосез$$ (ОТМТ чЕх1ЕСоае); 


Параметр иЕх Софе задает код завершения приложения. Этот код можно 
затем определить, вызвав функцию бе Ех Со4еРгосез$: 


ВООТ СеЕЕх1ЕСоаеРгосез$ (ТМ НАМОЪЕ БЮРгосез5$, 
ОПТ ГРРИОВР 1рЕх1%Соае); 


Параметр 1рЕхСофде является указателем на переменную, в которую будет за- 
несен код, с которым завершился процесс ВРгосез$$. Если процесс еще не за- 
вершился, в эту переменную будет записано значение ЭТП.Т, АСТТУЕ. Так 
что вызов функции Се Ех НСо4еРгосез$ может использоваться для проверки 
того, завершился ли процесс, и если завершился, то с каким кодом: 

РИОВКО Соае; 


СекЕх1+Содергосезз (РеосТпЕо.НРгосезз, &Соае); 
1Е (Соае == ЗТТЬЬ АСТТУЕ) 


е1 зе 


Код завершения, получаемый функцией де Ех СодеРгосе$$, может быть 
задан в процессе функцией Ех Ргосе$$, описанной далее функцией Тегпи- 
паёеРгосе$$, или возвращаться функцией \УтМаш. 


Функция Сгез&еРгосе$$ возвращается, не ожидая окончания инициализа- 
ции порождаемого процесса. Если родительский процесс должен ждать окон- 
чания инициализации, чтобы взаимодействовать с порожденным, то ожида- 
ние его инициализации можно организовать с помощью функции УаЦЕог- 
ШшШро Ще. Эта функция объявлена следующим образом: 


РИОВР __ Еаз®са11 Ма1®ЕогТпраета1е (ТМ НАМОГЕ ПРгосез$, 
ТМ РИОВР 4мМ11115есопа5$); 


Параметр ВРгосез$ — дескриптор дочернего процесса, тот самый дескрип- 
тор, который в родительском процессе хранится в поле ВРгосез$ структуры 
1рРгосез$ТпЁогта оп. Параметр 4 МИ 5ееоп45$ — время ожидания в милли- 
секундах. 
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Функция возвращается, если истекло время ожидания, или когда порож- 
денный процесс инициирован и ждет ввода со стороны пользователя. Возвра- 
щаемое функцией значение может быть следующим: 


Порожденный процесс инициирован и ждет ввода со сторо- 
ны пользователя. 


У\АТТ ТТМЕОСТ |Заданный интервал ожидания истек. 


ОхРЕРЕГЕЕЕ Произошла ошибка. Информацию о ней можно получить 
с помощью функции Се Газ Еггог (см. разд 1.1). 


В ряде случаев выполнение родительского процесса должно быть приоста- 
новлено до завершения порожденного процесса. Это необходимо, например, 
если родительский процесс должен использовать какие-то результаты, получен- 
ные порожденным процессом. Для ожидания завершения порожденного про- 
цесса можно использовать любые из рассмотренных ранее функций ожидания. 

Ниже приведен тестовый пример порождения процесса и ожидания его за- 
вершения. 

_ЗТАВТОРТМЕОА 5фагеТпЕо = { $12е0Е (Т5багеарТптЕо) }; 

_РВОСЕ$5$ ТМЕОВМАТТОМ Ргос1ТтЕо; 

СЕагЕТпРо.сЬ = $1276е0Е (ЗкбахгЕТрЕо); 


ЗРомМез$засче ("За 5 секунд умножьте на Калькуляторе 2х 2" 
"и закройте Калькулятор "); 


1Е (! СгеаееРгосезз (МОТ, "Са1с", МОТЬ, МОЬЬ, Еа1зе, 
НТСН_РЕТОКТТУ СЪА$5, МОЬЬ, МОБ, &5баг®ТпЕо, 
&РгосТпЕо)) 


ЗпомМеззаае ("Ошибка " + ТпЕТобег (СееТаз®Еггог ())); 
е15е 
{ 
1Е (Маз КГог51па1е0ю)ес® (РхосТтЕо.ВРгосез$з, 5000) 
== МАТТ_ТТМЕООТ) 
бРПомМеззаде ("За 5 секунд Вы не успели завершить работу"); 
е15е 5ЗПомМеззасде ("Прекрасно"); 
С1озеНапаТ1е (РгосТпЕо.ВРгосез$$); 


} 


В этом примере порождается процесс, запускающий стандартную про- 
грамму Калькулятор и ожидающий его завершение. Пример иллюстрирует 
простейшее согласование работы родительского и порожденного процесса — 
ожидание окончания дочернего процесса. Но, конечно, согласование может 
быть и более сложным. С помощью описанных в предыдущих разделах мью- 
тексов, событий, семафоров, таймеров дочерний процесс может извещать ро- 
дительский об отдельных стадиях своего выполнения. Тогда, используя в ро- 
дительском процессе функцию ожидания УаЦЕогМиреОБес{$, можно 
дифференцированно реагировать на результаты выполнения отдельных этапов 
дочернего процесса. 

Знание дескриптора процесса позволяет определить многие его характери-. 
стики, а также в некоторой степени управлять процессом. 

Например, функция Се Ртог{цу(а$$ позволяет определить приоритет вы- 
полнения процесса: 


РИОВР СеьРг1ог1ЕуС1аз$$ (НАМОЬЕ ВРгосез$$); 
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А функция Зе Риогцу( аз$ позволяет изменить приоритет выполнения: 


ВООЪ бееРг1ог1ЕУуС1а$$ (НАМОЬЕ НРгосезз, ПОИОВР ЧмРг1ог1®уС1аз$$); 


Возвращаемое функцией Се РтогкуС1а$$ значение и параметр 4мРмо- 
г{уС1аз$ в вызове функции Зе РиногНу(С]аз5 могут принимать значения 
Н!СН_РЕВТОВТТУ СГА$$, ШОГЕ_ РЕТОВТУ _СТА$$, МОВМАГТ, РВЛОЕЛТУ _ 
СГА$5, ВЕАГИМЕ_РЕОВТТУ_СГА$5. Смысл этих значений был рассмот- 
рен ранее в описании функции СгезжфеРгосез$. 

Функция Се Ргосез$Тите$ позволяет получить сведения о времени выпол- 
нения процесса: 


ВОО СееРгосеззТ1иез (НАМОЬЕ ЮРгосез$$, 
РЕТЬЕТТМЕ 1рСгеа&1опТ1пе, 
ТРЕТЬЕТТМЕ 1рЕх1&Тате, 
ГРЕТЬЕТТМЕ 1рКегпе1Т1пе, 
ТРЕТЬЕТТМЕ 1рОзегТ1те); 


Все параметры, кроме, конечно, дескриптора ВРгосе5$, имеют тип ГРЕ[- 
ГЕТТМЕ — указатель на структуру типа ЕШЕИМЕ (см. разд. 1.15.1 и разд. 
3.6), хранящую значение времени. Значения хранятся как число сотен наносе- 
‘кунд. Параметр 1рСгеайопТипе указывает момент создания процесса. Пара- 
метр 1рЕхцТиипе указывает момент завершения выполнения процесса. Если 
процесс еще выполняется, то значение, возвращающееся в этот параметр, не 
определено. Значения обоих параметров 1рСгеайопТ!те и 1рЕхИТите — это 
число интервалов по 100 нс., отсчитанных с полуночи 1 января 1601 года по 
Гринвичу до соответствующего момента времени. Параметр рКегпе! ТГ! те ука- 
зывает время, затраченное процессом на работу с системой. А параметр 
1рО5егТ!пе указывает время, затраченное процессом на выполнение кода при- 
ложения. 

Приостановить выполнения процесса явным образом невозможно. Но 
можно приостановить выполнение всех потоков приложения. Работа с потока- 
ми будет рассмотрена в разд. 3.8. 

Завершить выполнение процесса можно функцией ТегпипафеРгосез$: 


ВООГ Теги1паееРгосез$ (НАМОЬЕ ЮРгосез$, ОТМТ оЕх1®Соае); 


Параметр иЕх ЦСо4е задает код завершения. 

Завершение процесса функцией ТегпипафеРгосе$$ имеет смысл прово- 
дить только в экстренных ситуациях. Это очень грубое завершение, которое 
не посылает соответствующее сообщение присоединенным к процессу ОШ, 
не дает возможности приложению провести какие-то заключительные опера- 
ции и т.п. 


Ниже приведен пример применения функций Се РгосезТипе$, Тегипа- 
феРгосе$$ и Се Ех СодеРгосе$$. Этот код является изменением части рассмот- 
ренного ранее примера, начинающейся с оператора {(\УаИЕог51т1еОБес+... . 
Жирным шрифтом выделены добавленные операторы. 


1Е (Ма1Гог51п91е0Ъ}ес® (РгостТпЕо.ПРгосез$, 5000) == МАТТ ТТМЕООТ) 
{ 
Тегм1паееРгосе$$ (РгосТпЕо.ПРгосез$, 5); 
ЗБомМеззаче ("За 5 секунд Вы не успели завершить работу"); 
} 
е]1зе 5$ПомМеззасще ("Прекрасно"); 
// получение временных параметров 
ЕТТГЕТТМЕ ]1рСгеа&1опТ1ме, 1рЕх1ЕТ1те, 1рКегпе1Т1те, 1рОзегТ1ие; 
ЗУЗТЕМТТМЕ Т, ТО; 
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СесРгосеззТ1тез (РгосТпЕо.ПРгосезз, &1рСгеае1опТ1те, 
&1рЕх1ЕТ1ме, &1рКегпе1Т1те, &1рОзегТ1те); 

Е11еТ1теТтобузветТапе (&1рСгеа*1опТ1ме, &Т); 

Е11еТ1меТтобузветмТ1те (&1рЕх1ЕТ1ме, &Т0); 

Ап$15Ег1па 5; 

РафеТт1теТо$Ег1иа ($, "ВВ:пп:$$:2272", бузбетТ1теТоравеТ1те (Т) - 
ЗузветТ1теТораееТ1те (Т0)); 

Еа11->Техе = 5; 

Е11еТ1теТобузветТапе (&1рКегпе1Т1те, &Т); 

РафеТт1теТо5$Ег1па ($, "ВЬ:пп:$$:222", бузбемТт1теТораееТ1те (Т)); 

ЕЗ12->Техе = 5; 

Е11еТ1теТобузсетшТапе (&1рОзегТ1ие, &Т); 

РафеТ1теТто$ Е х1па ($, "ВР:пп:$8:222", бузвбетТ1теТоракеТ1те (Т)); 

ЕЗ1&3->Техе = 35; 

// получение кода возврата 

РИОКО Соае; 

СеЕЕх1 ЕСоаеРгосез$ (РгосТпЕо.ВРгосез$, &Соае); 

Еа14->ТехЕ = Соае; 

С1озеНапа1е (Ргос1ТтЕо.ИРгосе$$); 


В приведенном примере добавлен оператор, вызывающий функцию Тегпи- 
пафеРгосе$$ в случае, если пользователь не успел закрыть Калькулятор за 5 
секунд. Затем следуют операторы, определяющие временные характеристики 
завершившегося процесса. Функция Се Ргосез$Типе$ заносит в переменные 
1рСгеайопТ!те, 1рЕхЦТ!те, рКегпе!'ТГ1те и 1рО5егТ1те значения соответст- 
вующих характеристик. Эти значения хранятся в формате структуры ЕПЕ- 
ТТМЕ (см. разд. 1.15.1), довольно неудобном для дальнейших преобразований. 
Например, для вычисления суммарного времени выполнения процесса надо из 
времени окончания процесса 1р©Ех'Тите вычесть время его создания 1рСгеа | - 
опТипе. С форматом ЕП.ЕТМЕ арифметические операции производить нель- 
зя. Поэтому в приведенном коде моменты времени сначала функцией Ее- 
ТипеТоЗузет'Тите переводятся в формат ЗУЭТЕМТТМЕ (см. разд. 1.15.1), за- 
тем функциями ЗузетТипеТора%4еТ!те переводятся в тип Т)афеТипе, и уже 
к этому типу применяется операция вычитания. Результат заносится в строку 
$ функцией ОаёеТипеТто$ итя. В данном случае используется именно эта 
функция, а не более простая ТипеТо5г, поскольку результат хочется полу- 
чить с точностью до миллисекунд. Для этого во втором аргументе функции 
ОжеТипеТо5{гше указывается формат, включающий отображение миллисе- 
кунд. А функция ТипеТо$%:` дает результат только с точностью до секунды. 
Учет миллисекунд особенно важен для значений 1рКегпе! Ге и 1рО5егТ те, 
которые могут быть меньше одной секунды. 

После получения и вывода в соответствующие окна редактирования вре- 
менных характеристик функцией Се Ех(иСо4еРгосе$$ определяется код воз- 
врата процесса. 


Доступ к процессу можно обеспечить с помощью двух разных описателей: 
дескриптора и идентификатора. При создании процесса его дескриптор возвра- 
щается функцией СгеафеРгосез$. Та же функция заносит в структуру ТРго- 
сез5шогтайоп, на которую указывает параметр 1рРгосез$ш{огтайоп, деск- 
риптор первого потока и идентификаторы процесса и первого потока. Кроме 
того, процесс в любой момент может получить свой идентификатор функцией 
Се Сиггеп Ргосе$$ТА: 


ОИОВКО СеЕСаггхепЕРгкосез Та (УОтТ,) 


Иногда для процесса известен только его идентификатор. Соответствую- 
щий пример вы можете увидеть в разд. 3.10. Тогда встает задача определить 
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по идентификатору дескриптор процесса. Этот дескриптор возвращает функ- 
ция ОрепРгосез$: 


НАМОГЕ ОрепРгосез$$ (ОИОВР амрез1гедАссезз, ВООЪ БТпрег1&Напа1е, 
РИОВКР ЧмРгосеззТа); 


Параметр 4мРгосе$$1@ указывает идентификатор процесса. Параметр Бт- 
Бег Нап е определяет наследование дескриптора дочерними процессами. 
А параметр 4м)езге4Ассе$$ задает флаги доступа. Этот параметр может со- 
держать любую комбинацию следующих значений: 


РВОСЕ$$ _АТТ, АССЕ$ЗЗ `Устанавливает все возможные флаги до- 
ступа к объекту процесса. 
РВОСЕЗ5 _СКЕАТЕ_РВКОСЕЗ5 Только для внутреннего использования 
системой. | 
РКОСЕ$5_СКЕАТЕ_ _ТНВКЕАО ‚Позволяет использовать дескриптор в вы- 
_ ____  Зове функции СгежеВвето{еТЬгеа4. 
РКОСЕЗ5_ООР_НАМОГЕ Позволяет использовать дескриптор в вы- 


зове функции ФирПежеНап Ще для дуб- 


 лирования дескрипторов. 
р дескр р 


РВКОСЕ$$ _О@ОЕВКУ ТМЕОВМАТТОМ | Позволяет использовать дескриптор в вы- 
зовах функций Се Ех СодеРгосе$$ 
и СеРиогКу(Ла$$ для получения инфор- 


мации о процессе. 
РКОСЕЗ5_5ЗЕТ ТМЕОКМАТТОМ ' Позволяет использовать дескриптор в вы- 


зове функции Зе РиогКу(а$$. для зада- 
‘ния уровня приоритета процессу. 


РКОСЕ$З5_ТЕКМИТМАТЕ ' Позволяет использовать дескриптор в вы- 
зове функции ТегпиипафеРгосе$$ для пре- 
| рывания процесса. 


РКОСЕ$5_УМ_ОРЕКАТТОМ Позволяет использовать дескриптор в вы- 
` зовах функций УшиаРгоес(Ех и \У!т- 

‚ феРгосеззМетогу для изменения виртуа- 
‘льной памяти процесса. 


РКОСЕ$5_УМ_ВЕАО ' Позволяет использовать дескриптор в вы- 


_зове функции Веа4Ргосез5Метогу для 


‘чтения из виртуальной памяти процесса. 


РКОСЕ$5_УМ_\МЕЮТЕ Позволяет использовать дескриптор в вы- 
зове функции УтгцеРгосезМетогу для 
записи в виртуальную память процесса. 


ЗУМСНКОМТАЕ Только для У/шао\мз МТ: разрешает ис- 
пользовать дескриптор в любых функци- 
ях ожидания. 


Получить дескриптор текущего процесса, код которого выполняется, мож- 
но функцией Се СиггепРгосез$: 


НАМОЬЕ СееСаггеп®Ргосез$ (УОТр); 
Правда, дескриптор, возвращаемый этой функцией, не совсем настоящий. 


Это псевдо-дескриптор, который можно использовать в вызовах различных функ- 
ций АР! \У/11140\$, но который, например, не наследуется дочерними процессами. 
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Имеется еще функция ОрепРгосезТоКеп, которая обеспечивает доступ 
к привилегиям процесса. Описание этой функции см. в разд. 2.2.1. 


3.8 Потоки 


Каждый процесс имеет, по крайней мере, один поток. Он создается в мо- 
мент порождения процесса функцией СгезфеРгосе$$. Дескриптор этого потока 
содержится в поле ВТВгеа4, а его идентификатор — в поле амТЬгеа9 1 струк- 
туры ЭТАВТОРУЕГЕО (см. разд. 3.7). Но помимо этого основного потока можно 
создавать другие, которые будут выполняться параллельно. В частности, в та- 
кие порождаемые потоки имеет смысл заносить все функции ожидания, кото- 
рые рассматривались в предыдущих разделах. Тогда ожидание не будет блоки-_ 
ровать приложение, пользователь сможет нормально работать с ним, а в мо- 
менты срабатывания функций ожидания будут выполняться необходимые 
действия по обработке событий, таймеров и т.п. 

Потоки выполняются в контексте породившего их процесса. Поэтому по- 
токи одного и того же процесса могут без проблем взаимодействовать друг 
с другом. | 

«Одновременно» на компьютере может выполняться множество потоков. 
Я взял в кавычки слово «одновременно», поскольку, конечно, в каждый мо- 
мент времени процессор может заниматься только одним потоком. На работу 
с каждым потоком отводится некоторый квант времени — примерно 20 мс. За- 
‘тем система сохраняет текущее состояние потока в его контексте, и смотрит, 
какой другой поток должен выполняться. При этом система просматривает 
только активные потоки. Дело в том, что некоторые потоки могут быть приос- 
тановлены. Далее мы рассмотрим, как это можно сделать. Таким приостанов- 
ленным потокам время не выделяется. Не выделяется время также потокам, 
которые ждут какие-то события. 

Когда выбран очередной кандидат на выполнение, система грузит из его 
контекста его текущее состояние, и поток начинает выполняться на протяже- 
нии очередного кванта времени. Подобная организация выполнения потоков 
в \тао\мз$ называется системой с вытесняющейся многозадачностью. Она реа- 
лизована в У шШдо\мз, начиная с У т9омз 98. 

При планировании системой работы с потоками учитываются их при- 
оритеты. Поток может иметь приоритет в диапазоне от 0 — самый низкий, 
до 31 — самый высокий. При выборе очередного кандидата на выделение 
ему кванта времени система, прежде всего, смотрит, нет ли готового к вы- 
полнению потока с приоритетом 31. Если такой поток обнаруживается, он 
получает квант времени. Только если такого потока нет, система ищет по- 
ток с приоритетом 30, если и такого не нашлось, спускается еще на 1 в ие- 
рархии потоков и т.д. Так что поток с низким приоритетом получит квант 
времени только в том случае, если не нашлось ни одного готового к выпол- 
нению потока с более высоким приоритетом. Иначе говоря, поток с низким 
приоритетом работает только во время простоя потоков с более высоким 
приоритетом. Но на этом обиды, учиняемые потокам с низким приорите- 
том, не кончаются. Если потоку выделен квант времени, и, пока он работа- 
ет, система выяснила, что готов к выполнению поток с более высоким при- 
оритетом, ему немедленно будет предоставлено время. А потоку с низким 
приоритетом система не даст даже доработать его законный квант времени. 
Этот поток будет немедленно остановлен. Это и есть вытесняющаяся много- 
задачность. 
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Поток создается функцией СгеэфеТЬгеаа: 


НАМОТЕ СгеафеТЬгеаа (ТМ .РЗЕСОВКТТУ АТТВАТВОТЕ$ 1рТ,геадА&г1рифез, 
ТМ $12Е Т Ам аск$12е, 
ТМ ГРТНВЕАР 5ТАВТ ВОЧТТМЕ 1р5саг%Ааагезз, 
ТМ ТРУОТР 1]рРагацефек, 
ТМ ОРМОВО амСгеа®1опЕ1ааз, 
ОЧТ ТРЬОМОВО 1рТигкеаата); 


При успешном выполнении функция создает новый поток, возвращает его 
дескриптор, а в переменную, на которую указывает параметр 1рТвгеа 1, за- 
носит идентификатор потока. Начиная с Уш4омз 2000 в качестве значения 
1рТЬгеа914 можно задавать МОТ.Т,, если идентификатор потока вас не интере- 
сует. Но в У! 49омз 98 параметр 1рТЬгеа 4 должен указывать на некоторую 
переменную, даже если ее значение вам не нужно. 

Выполнение потока начинается с выполнения функции, адрес (имя) кото- 
рой указывает параметр 1рЭ$агё Адагез5$. Это любая написанная вами функ- 
ция, в которую передается один аргумент, являющийся указателем на любую 
величину, и которая возвращает 32-разрядное значение: 


РИОВр ИТМАРТ имя функции (ГРУОТО); 


Параметр 1рРагатефег задает значение аргумента, передаваемого в функ- 
цию, на которую указывает 1р5фагё Аа@ге5$. Если в функцию не требуется ни- 
чего передавать, можно задать 1рРагашфёег = МО. 

Остальные параметры функции СгежеТигеа4 можно во многих случаях 
задавать нулевыми. Параметр рТЬгеадА ге является указателем на. 
структуру типа ЗЕСОВТТУ_ _АТТЕАТВОТЕЗ (см. описание этой структуры 
в гл. 8), определяющую для потока, будет ли наследоваться возвращенный 
функцией дескриптор дочерними процессами. Эта структура задает также де- 
скриптор защиты. Значение параметра 1рТигеадА г е$ можно задать рав- 
ным МОГЕ. Это будет означать, что дескриптор потока не наследуется и ис- 
пользуется дескриптор защиты по умолчанию. 

Параметр 4масК$12е указывает размер в байтах стека, который будет ис- 
пользоваться в новом потоке. Если в качестве значения д\уЗфасК517е задан 0, то 
размер стека будет таким же, как в первом потоке данного процесса. Стек распо- 
ложится в памяти процесса и освободит ее, когда завершится. Впрочем, если по- 
требуется, то размер стека автоматически увеличится. Так что в большинстве 
случаев вас вполне устроит значение параметра Чу фасК812е, равное 0. Если же 
вы задаете отличный от нуля размер, надо быть уверенным, что он не превысит 
размер доступной памяти. Иначе функция СгежеТЬгеа@ завершится с ошибкой. 

Параметр 4мСгеаЙопЕ 1а5$ предназначен для флагов, которые определяют 
условия создания потоков. Но цока определено только одно значение флага — 
СВЕАТЕ_$ОЗРЕМПЕЮО. Если этот флаг не задан, то поток начинает выпол- 
няться немедленно после создания. А если задан флаг СВЕАТЕ_ЗОЗРЕМОЕО, 
то поток создается в остановленном, «замороженном» состоянии. Это можно 
использовать для настройки каких-то характеристик потока. Он начнет вы- 
полняться только после того, как к нему будет применена описанная далее 
функция ВКезитеТЬгеад. 

Ниже приведен простейший пример, поясняющий возможную схему соз- 
дания, выполнения и завершения потока: 


РИОВР ИТМАРТ ТрьгеааЕГипс (ЪРУОТО) 
| 


Еоги1->Таре11->СарЕ1оп = "Поток выполняется"; 
тебагп 0; 
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} | 
\01А __Еаз®са11 ТКоги1: :Вае6оп1С11сК (ТОР)]есе *5бепаег) 


{ 
РИОВР 1рТпгеаата; 


НАМОГЕ РТ = СгеахеТЬгеаа (МОТЬ, 0, ТпгеааРиапс, МОЪЬ, 0, &1рТЬгеаата); 
С1озеНапа]1е (ВТ); 
} 


В данном примере функция, которая выполняет поток, названа 
'ГЬгеааЕипс. Она не использует передаваемый в нее параметр, так что в заго- 
ловке функции оставлено только указание типа принимаемого параметра. 
Функция имеет доступ ко всем глобальным данным первого потока процесса. 
Например, в данном примере использован вывод: сообщения в метку Гафе!1 
формы РГогт1, указатель на которую является глобальной переменной. 

Функция ВиЙоп1СПеК является обработчиком щелчка на кнопке Вщ- 
$011. Все подобные обработчики относятся к первому потоку приложения. 
В этой функции создается поток с дескриптором ПТ. В качестве адреса начала 
потока задается функция ТЮгеааЕипе. Идентификатор потока, который в дан- 
ном примере заносится в переменную 1рТЬгеа д Та, нам не нужен. Так что, на- 
чиная с \114о\з 2000, последний аргумент в вызове функции можно было бы 
задать равным МОГ, и не выделять переменную для хранения идентификато- 
ра. Приведенный вариант более универсален и годится для любых версий сис- 
темы, начиная с Утао\з 98. | 

В примере предполагается, что дескриптор потока нам далее не потребует- 
ся. Поэтому он сразу закрывается функцией С1юзеНапШе. 

Если бы нам надо было передать в поток какой-то параметр, это можно 
было бы сделать следующим образом: 


РИОВО МТМАРТ ТргеааЕГопс (ЪРУОТО Р) 
{ 


Гоги1->ГаБе11->СарЕ1оп = "Поток выполняется с параметром " + 
ТоЕТоЗ%г (Р); 
гебогп 0; 


} 
Уу01А __Газ®са11 ТЕогш1:; ;: Ва оп1С11сК (ТОБ]есЕ *5епаек) 


{ 
РИОВОР 1рТргеаатТа; 


1п6 1рРагамееег = 1; 

НАМОЪЕ БТ `= СгеакеТЬгеаа (МОТ, 0, ТЬгеааГипс, &1рРагамефег, 0, 
&1рТргеаатТа); 

С1озеНапла1е (ПТ); 

} 


В приведенном коде выделены жирным шрифтом отличия от предыдуще- 
го примера. В данном случае в функцию передается в качестве параметра ука- 
затель на целую переменную. Но точно так же можно передать указатель на 
любой тип данных. 

Начиная с вызова функции СгеавеТЬгеа4@, созданный поток начинает вы- 
полняться параллельно с основным, первым потоком. В приведенном примере 
работа созданного потока завершается при выполнении оператора гефигп. Пе- 
редаваемое этим оператором значение является кодом завершения потока. 
Возможно и иное завершение потока — функцией ЕхИТЬгеаа: 


УОТО Ех1ЕТВЬгеаа (ТМ ОМОВО амЕх1&Соае); 
Параметр 4мЕхСо4е задает код завершения. Этот код, переданный 


в функцию ЕхЦТЬгеа@ или возвращенный оператором геёфиги, можно затем 
определить, вызвав функцию де Ех {Со4деТЬгеаа: 
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ВОО сбесЕх1ЕСоаеТЬгеаа (ТМ НАМОЪЕ ВТрЬгеаа, ООТ ТРОМОВО 1рЕх1&Соае); 


Параметр 1рЕхИСоде является указателем на переменную, в которую бу- 
дет занесен код завершения потока ВТЬгеа4. Если поток еще не завершился, 
в эту переменную будет записано значение ЭТПЛ, АСТУЕ. Так что вызов 
функции Се Ех{Со4деТЬгеа4 может использоваться для проверки того, завер- 
шился ли поток с дескриптором ВТВгеа4, и если завершился, то с каким ко- 
дом: 


ОМОВО Соае; 

СсеЕЕх1ЕСоаеТЬгеаа (ПТЬгеаа, &Соае); 
1Е (Соае == ЗТТЬГ АСТТУЕ) 

е1зе 


Завершить выполнение потока можно также функцией ТегтшаёеТВгеад: 


ВООТ Тегп1пафеТгеаа (ТМ ОЧТ НАМОЬЕ ВБТЬгеаа, ТМ ПОМОВКО амЕхлЕСоае); 


Параметр 4мЕхНСо4е задает код завершения. Завершение потока функцией 
ТегиипаёеТЬгеа4 более грубое, чем завершение функцией ЕхИТЬгеа4. Его 
можно использовать только в тех случаях, когда известно, что поток успел за- 
вершить все необходимые операции. 


Выполняющийся поток можно приостановить с помощью функции $%и$- 
реп4ТЬгеаа: 


РИОВКР 5изрепаТпгеаа (ТМ НАМРЬЕ БТЬгеаа); 


Применять эту функцию надо с некоторой осторожностью. В момент ее 
вызова поток может выполнять операции с каким-то ресурсом, заблокировав 
его. Например, может динамически выделять память, заблокировав Веар. То- 
гда другие процессы смогут воспользоваться этим ресурсом только после того, 
как поток возобновит работу, т.е. когда для него будет вызвана функция 
ВезитеТЬгеаа: 


РИОВО ВезомеТвгеаа (ТМ НАМОЬЕ ВТЬтгеаа); 


Эту же функцию следует вызвать, чтобы начал выполняться поток, для 
которого при его создании функцией СгежеТЬгеа4 был задан флаг СВЕА- 
ТЕ_ЗОЗРЕМОЕО. 

Система ведет счетчик вызовов функций ЗизрепаТИгеа4 и ВезитеТЬгеа4 
для потока. Каждый вызов ЭазрепаТЬгеа4 увеличивает этот счетчик на 1 (но 
результат не более величины, задаваемой константой МАХТМОМ_$505РЕМО _ 
СООМТ), а каждый вызов ВезитеТЬгеаЯ уменьшает его на 1 (но результат не 
менее 0). Обе функции возвращают предыдущее значение этого счетчика. Функ- 
ция ВезитеТЬгеа4 возобновит выполнение потока только в том случае, если 
счетчик стал равен 0. Иначе говоря, если для потока несколько раз была вызва- 
на функция ЭизрепаТЬгеаЯ, то выполнение возобновится только после того, 
как столько же раз будет вызвана функция ВезитеТЬгеа4. Так что если вы хо- 
тите наверняка освободить поток, независимо от числа предварительных вызо- 
вов 5изрепаТЬгеа@4, следует выполнить оператор: 


\р11е (ВезипеТргеаа (ВТ) > 0); 
В случае ошибки при выполнении функций ЗазрепаТЬгеа4 и Везите- 


'ТЬгеа4 они возвращают значение ОхЕРГЕЕЕЕЕЕ. Тогда причину ошибки можно 
установить, вызвав функцию Сей Га$%Еггог.(см. разд. 1.1) 


3.8 Потоки | 209 


Теперь рассмотрим вопросы, связанные с приоритетами потоков. Поток, 
созданный функцией СгежфеТЬгеа4, имеет приоритет, совпадающий с классом 
приоритета породившего его процесса. В дальнейшем этот приоритет можно 
изменить, задав отклонение от этого базового приоритета в ту или иную сторо- 
ну. Это делается функцией Зе ТЬгеаЯРг1огЦу: 


ВООЪ 5ееТьгеааРг1ог1® у (ТМ НАМОЬЕ ПТА№геаа, ТМ 1пе пРг1ог1®у); 


Параметр пР-1огЙу указывает требуемое соотношение между классом при- 
оритета процесса и приоритетом потока. Это параметр может принимать сле- 


дующие значения. 


ТНКЕАО РКОЩГТУ_ |Задает значение 1 для классов приоритета ТОЕЕ_РЕ- 

ГШГЕ ОМТУ_СГА$5, МОКВМАГ РЕТОЕТТУ _СГА5$5, 
НТСН_РЕТОВТТУ_СТГА5$5, и значение 16 для класса 
приоритета ВЕАГТТМЕ РЕТОВТТУ_СТА$5$5. 


ТНВЕЕАО_РЕТОВТТУ_ |Задает значение на 2 ниже нормального класса прио- 
ГО\ЕЗТ ритета. 


ТНКЕАР_РЕТОВТТУ_ |Задает значение на 1 ниже нормального класса прио- 


ВЕГО\У/_МОВМАГ, ритета. 
ТНВКЕАО_РЕТОВТТУ_ |Задает значение нормального класса приоритета. 


МОВМАГ, | 


ТНКЕАО_РЮКОЕВТТУ_ |Задает значение на 1 выше нормального класса прио- 
АВОУЕ_МОВКМАГ 


НИЕ 
ТНВЕАО_ РЕОЕТУ_ |Задает значение на 2 выше нормального класса прио- 
НТСНЕЗТ 


ритета. 
ТНВКЕАО_РЕОЕТУ_ Задает значение 15 для классов приоритета 
ТТМЕ_СВИТСАГ ШОГЕ_Р®ЕТОВТТУ_СГА$$, МОКМАТ, РЕТОВ!ТУ _ 
 СГА$5, НШСН_РВТОВТУ_СГАЗ$$, и значение 31 для 
класса ВЕАГТТМЕ _РЕТОВТТУ_СТА$5$5. 


п М 


Численные значения приведенных в таблице констант соответствуют от- 
клонению от нормального класса приоритета: 1, 2, 0, -1, —2 ит.д. 

Поскольку в момент создания поток имеет класс приоритета, заданный 
для процесса, возникает вопрос создания потока, сразу выполняющегося 
с другим приоритетом. Это можно сделать, создавая приостановленный поток, 
т.е. задавая флаг СВЕАТЕ ЗОЗРЕМОЕО в функции СгеафеТВгеа4. К, этому 
приостановленному потоку можно применить функцию Зе ТЬгеа9РгогКу, 
а потом освободить поток функцией ВезитеТЬгеаа. Например: 

РИОВО амТьгеаатр; 

НАМОТЕ РТЬгеаа = СгеаееТЬгеаа (МОТТ, 0, ТвгеааЕРопс, МОП, 

СВЕАТЕ ЗОЗРЕМОЕО, & 1рТЬгеааТа); 
бееТргеааРк1ог16у (ПТргеаа, ТНВЕАР РВТОВТТУ НТСНЕЗТ); 


ВезипеТргеаа (1рТргеааТа); 
С1озеНапаТе (1рТпгеаатТа); 


Узнать текущий приоритет потока можно функцией Се ТЬгеааРглогЦу: 
116 СбееТЬгеааРг1ог1$у (ТМ НАМОЪЕ РТргеаа); 


Она возвращает численное значение приоритета потока ВТВгеа4. Эти зна- 
чения обсуждались выше для функции Зе ТЬгеааРгог(Цу. 
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3.9 Сообщения об изменениях в каталогах 


В качестве объектов синхронизации может использоваться дескриптор, 
возвращаемый функцией ЕтаЕРи'$СБапееМоййсайЙоп. Эта функция совмест- 
но с функциями ЕшаМех СВапоеМонЙЯсаЙоп, ЕшаСюозеСвВапоеМонЙЯсаИоп 
и функциями ожидания позволяет осуществлять мониторинг заданного ката- 
лога или дерева каталогов, имеющего заданный корень. Такой мониторинг не- 
обходим, например, если в приложении имеется отображение списка файлов 
некоторого типа, содержащихся в каталоге, и требуется знать моменты, когда 
надо обновлять этот список, так как какие-то файлы удаляются, добавляются, 
изменяются. 

Начнем рассмотрение вопросов мониторинга с описания функции Ето- 
Е1'5СВапоеМойнйЙсайоп: 

НАМОТЪЕ РЕ1лпаг1е$ЕСВапаемо*1Е1са®етоп (ТМ ГРСЗТВК 1рРаеЮМапе, 


ТМ ВООГ Б\ЙаесЬбарегее, 
ТМ РИОВО ЗмМоЕ1ЕуЕ11{ег); 


Параметр 1рРа{ Маше указывает путь к каталогу, который будет контро- 
лироваться. Параметр 6\Уаё еси Зи Шгее определяет, должен ли контролиро- 
ваться только данный каталог, или начинающееся с этого каталога дерево, т.е. 
все вложенные каталоги. При значении #а15е контролируется только один ка- 
талог, а при значении &ёгие — дерево, для которого указанный каталог являет- 
ся корневым. 

Параметр 4мМойГуЕ1Тег задает фильтр, который определяет, какие имен- 
но изменения в каталоге должны контролироваться. Этот параметр может 
включать в любой комбинации следующие флаги: 


ЕПЕ_ МОТТЕУ СНАМСЕ_ | Любые изменения имен файлов — переименование, 
ЕП.Е_МАМЕ _ удаление, создание новых файлов. 


ЕП.Е_МОТТЕУ СНАМСЕ_ 
Г1В_МАМЕ 


| ЕТЪЕ_МОТТЕУ_ СНАМСЕ_ 


Любые изменения имен каталогов — переименова- 
ние, удаление, создание новых каталогов. 


Изменение любых атрибутов файлов. 


АО 
ЕПЕ МОТТРУ СНАМСЕ_ | Изменение размеров файлов. Изменение происхо- 
ЗТИЕ_ дит при записи на диск в момент очистки буфера 


кэширования. 


ЕПЕ_ МОТТЕУ _СНАМСЕ_ Изменение последнего времени записи в файл. Из- 
ГАЗТ_ М\МВТТЕ менение происходит при записи на диск в момент 
очистки буфера кэширования. _ 


|. 
| 
| 


ЕПЕ. _МОТТЕУ_ СНАМСЕ_ Любые изменения дескриптора безопасности. 
ЗЕСОВТТУ _ 


| 
|— 
|. 


При ошибке функция возвращает значение 1МУАЕГТО НАМОГЕ_УАГОЕ. 
‚ При успешном завершении возвращается дескриптор объекта синхронизации, 
который далее может использоваться в любых функциях ожидания. Они сра- 
ботают, когда произойдет событие, указанное флагами амМо й{РуЕ1Щег. 

После того как результаты события обработаны, можно вызвать функцию 
ЕтаМ№ех{СБапоеМойЯса оп, которая продолжит мониторинг: 


ВООТ Е1паМ№ехеСРрапдемо®1Е1сае1оп (ТМ НАМОЬЕ БСВапаеНапа1е); 
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Параметр ВСВапоеНап М/е — это дескриптор, возвращенный функцией 
ЕтаЕ$СВапоеМоййсайоп. При успешном выполнении функция возвраща- 
ет ненулевое значение. После вызова функции ЕшМех(СВапоеМойЙсаНоп 
можно опять вызывать функцию ожидания. Если событие успело произойти 
после вызова ЕшаЕР1г$СВапоеМо сай оп, но до вызова ЕтЧМех СвВапреМ№о- 
Иса оп, система запоминает это событие, и тогда функция ожидания среаги- 
рует на него. 

После того как функция ожидания сработает, можно повторно вызывать 
функцию Еш9МехСВапоеМоййсайоп. Вызовы ЕшаМех СвапхеМоййсайНоп 
и функции ожидания должны чередоваться. Повторный вызов Еш@аМ№ехж{- 
СВапгеМойЙсаНоп без промежуточного вызова функции ожидания приведет 
к ошибке. 

Когда мониторинг больше не требуется, для его завершения надо вызвать 
функцию Еш9 озеСвапхеМоййсайоп: 


ВООЪ Е1паСТозеСвапаемо&1ЁЕ1са®*1оп (ТМ НАМОЪЕ РСВапаеНапа1е); 


Развернутый пример использования мониторинга вы найдете в разд. 6.6.4. 
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В модуле Нйер32.№ объявлен ряд функций, которые позволяют получить 
информацию о процессах и потоках, исполняемых на компьютере, а также 
о динамической памяти и модулях, связанных с указанным процессом. Чтобы 
использовать все, о чем рассказывается в данном разделе, надо вручную ввести 
в проект директиву: 


#10с1аае <&1ре]1р32.6> 
Функция СгеаеТооФе!р3 25 парзВо& позволяет получить дескриптор спи- 


ска процессов и потоков, исполняемых на компьютере, а также информацию 
об указанным процессе. Функция объявлена следующим образом: 


НАМОТЕ ИМТМАРТ СгеафеТоо1Ве1р325парзво%* (рИОКО амЕ1ааз, 
РИОВр +В32Ргосез$Тр); 


Параметр ЧмЕ1ай$ указывает, что именно должно быть включено в спи- 
сок. Этот параметр может иметь следующие значения: 


с 
тн Н32С$_ПМНЕВТТ Указывает, что возвращаемый дескриптор должен 
быть наследуемым. 


о 
'ГНЗ2С$_ ЗМАРАТЛ, 
| 


Эквивалентен одновременному включению следую- 
щих четырех флагов. 


Включает информацию о динамически распределя- 
емой памяти указанного процесса. 


—— 
ТНЗ2С5_ эЭМАРНЕАРЫЗТ 


| ТН32С8_ЗМАРМОРОГЕ 


Включает информацию о списке модулей указан- 
ного процесса. 


Е дд 
’ТНЗ2С ТН3З2С5_ _$МАРРЕОСЕ$ 5 _ Включает список процессов, исполняемых в У\У/т32. 


'ТН32С5_5МАРТНВЕАР Включает список потоков, исполняемых в \/1132 
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Параметр {832Ргосез $ Ш указывает идентификатор процесса. Этот параметр 
используется только для флагов ТН32С$_$МАРНЕАРЫ$ЗТ и ТН32С5_$МАР- 
МОРОГЕ. В остальных случаях он игнорируется. 

Функция Сгез4еТооНе]р3 2$ пар$Во{ возвращает дескриптор списка затре- 
бованной информации. В случае ошибки возвращается —1. Тогда вызов функ- 
ции Се Та Еггог может детализировать возникшую ошибку. 

После того как дескриптор списка использован описанными далее функ- 
циями, он должен быть уничтожен вызовом функции С1озеНап е. 

Получив дескриптор списка, далее можно перебрать все элементы этого 
списка. Если в вызове функции СгежеТооШе!р3 2$ парзВо& был указан флаг 
ТН32С5_5МАРРВОСЕЗ5 или ТН3З2С5$_5МАРАТЛТ,, можно получить доступ 
к информации о всех процессах, исполняемым на компьютере. Для этого слу- 
жат функции Ргосе5$32Е1'$ и Ргосе5$32Мехё: 


ВОО Ргосез$32Е1г5$% (НАМОЪЕ Ю5парзбо®е, ГРРВКОСЕЗЗЕМТКУЗ2 1рре}; 
ВООТ Ргосез$32М№ехЕ (НАМРЬЕ Пбпарзпое, ГРРКОСЕЗЗЕМТВУЗ2 1рре); 


Функция Ргосе5$32Е!:г5% дает доступ к информации о первом процессе 
в списке, на который указывает дескриптор ВЗпар$В оф. Если процесс имеется, 
функция возвращает фгие и заносит информацию о процессе в структуру типа 
РКОСЕЗЗЕМТКУЗ2, на которую указывает параметр рре. Тип структуры 
объявлен следующим образом: 


суреаеЕ зегосе таадРКОСЕЗЗЕМТВУЗ2 
{ 
РИОВО Ям$17е; 
РМОВр спе05ачае; 
РИОВО Ер32Ргосез$$Т,; 
ОТОМС_РТВК &6320еЁач1&Неартр; 
РМОВО ЕЬ32Моао1етр; 
РИОВО спЕТЬгеаа$; 
ОМОКО ЕВ32Рагеп&Ргосез$$ТО; 


ОМС рсРг1С1а$$Вазе; 

РИОВО ЧмЕ1ад$; 

СНАВ 32ЕхеЕ11е [МАХ _РАТН]; 
} РВОСЕЗЗЕМТКУЗ2; 


ЕуреаеЕ РВОСЕЗЗЕМТВУЗ2 * РРВОСЕЗЗЕМТВУЗ2; 
ЕуреаеЕ РВОСЕЗЗЕМТВУЗ2 * ТГРРВОСЕЗЗЕМТВУЗ2; 


Поле 4м5$12е содержит размер структуры. Это единственное поле, которое 
должно быть заполнено до вызова функции Ргосез532Е1:г$$. Заполнить его 
можно, используя выражение $12ео (РКОСЕЗЗЕМТКВУЗ2). 

Поле $2ЕхеЕПе содержит имя файла, соответствующего процессу. Поле 
сп Озаге содержит число ссылок на данный процесс. Если на процесс имеются 
ссылки из других процессов, например, это процесс сервера, то система будет 
сохранять этот процесс в памяти, пока число ссылок на него не станет равно 0. 

Поле сшёТЬгеа4$ указывает число исполняемых потоков процесса. Поле 
реРЕа$$Вазе определяет приоритет, который имеет каждый поток, созда- 
ваемый данным процессом. Следует учесть, что этот приоритет отличен от 
того, который задается при создании процесса функцией СгезфеРгосез$. Систе- 
ма сама регулирует приоритеты выполнения процессов, отталкиваясь, правда, 
от того приоритета, который был установлен в момент создания процесса. Чис- 
ленное значение нормального класса приоритета обычно равно 8. 

Поле 1№32Ргосе$$ Ш содержит идентифиактор процесса (см. разд. 3.8). 
А поле +13 2Рагеп(Ргосе $ содержит идентификатор процесса, родительско- 
го по отношению к данному, если имеется родительский процесс. Оба эти 
идентификатора можно использовать в вызовах функций АРТ У/1ш4о\з. 
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Поля 320еЁ ао &Неар и {132МодщеФ идентифицируют динамически 
распределяемую память и модуль процесса. Оба поля имеют чисто служебное 
значение и не могут использоваться в вызовах функций АРТ \У/ш4о\мз. Поле 
Ч4\Е1а55 зарезервировано для будущего применения и в настоящий момент не 
используется. | 

Если функция Ргосез$32Е1т56 вернула фгие, можно вызывать функцию 
Ргосез532Мех&, передавая в нее те же аргументы, которые передавались 
в Ргосез$32Е1:г$%. Функция Ргосез532Мех& запишет в структуру информацию 
о следующем процессе. Если функция вернет #а]5е, значит, перебор процессов 
закончен. 

Мы рассмотрели получение информации о процессах функциями Рго- 
се5$32Е!1'5$6 и Ргосез$32Мехф. Имеются аналогичные функции ТЬгеа932Е1: $ 
и ТЬгеа932Мехф, позволяющие получить информацию о всех потоках, испол- 
няемых на компьютере: 


ВООЬ ТЬгеаа32Е1тг5% (НАМОЬЕ ЮбпарзвоЕ, ГРТНВЕАРЕМТКУЗ2 1рёе); 
ВОО Тргеаа32Мехе (НАМОЬЕ И5бпарзвое, ГРТНВЕАРЕМТКУЗ2 1реёе); 


В эти функции передается дескриптор списка ВЗпар$во%ф, полученный 
предварительным вызовом функции СгежеТооШе!р3 2$ парзВо& с флагом 
ТН32С5_$МАРТНКЕАО или ТН32С5_5МАРАТГ.. Параметр ре является 
указателем на структуру типа ТНВЕА,ШЕМТКУЗ2, в которую заносится ин- 
формация о потоке. Тип структуры объявлен следующим образом: 


суреаеЕ зЕгисе фадТНВЕАРЕМТВУЗ2 
{ 

РИОВО Ям$17е; 

1919) >39 спёе0заае; 

ИОВ +032ТЬгеаатро; 

ОИОВО +{132ОмпегРгосез$ $10; 


ОМС срВазеРгт1; 
ГОМС срре1+аРг:; 
РИОВО ЧмЕ1аа$; 

} ТНВЕАБЕМТКВУЗ2; 


суреаеЕ ТНВЕАРЕМТКУЗ2 * РТНВЕАРЕМТКВУЗ2; 
суреаеЕ ТНКЕАРЕМТВУЗ2 *  ГРТНВЕАРЕМТВУЗ2; 


Поле 4м$12е содержит размер структуры. Это единственное поле, которое 
должно быть заполнено до вызова функции ТЮгеа932Е1:г$%. Заполнить его 
можно, используя выражение $17ео{(ТНВЕАРЕМТКУЗ2). 

Поле сп Озахе содержит число ссылок на данный поток. Если на поток 
имеется несколько ссылок, то система будет сохранять этот поток в памяти, 
пока число ссылок на него не станет равно 0. 

Поле {№32ТЬгеааТО содержит идентифиактор потока, а поле {132Омтег- 
Ргосез$ Ш содержит идентификатор процесса, который создал данный поток. 
Оба эти идентификатора можно использовать в вызовах функций АРТ \У/1т4о\з. 

Поле &ёрВазеРг! указывает класс приоритета — начальное значение при- 
оритета данного потока. Это поле может принимать значения, указанные 
в разд. 3.8 как значения параметра пРиогЦу функции Зе ТЬгеаЧРтогиву. Для 
нормального приоритета значение обычно равно 8. 

Поле &фр0е{ваРг! показывает отклонение со знаком реального приоритета 
потока от класса приоритета. Учтите, что заданный класс приоритета и задан- 
ное для потока отклонение от него — это только ориентир для системы. Систе- 
ма ориентируется на него, но задает приоритеты, исходя из собственных сооб- 
ражений. Подробнее о приоритетах и их влиянии на выполнение потока 
см. в разд. 3.8. 
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Поле 4мЕ1а5$ зарезервировано для будущего применения и в настоящий 
момент не используется. 

Методика работы с функциями ТВгеа932Е1т$4 и ТЬгеа932Мех& не отлича- 
ется от рассмотренной ранее методики работы с функциями Ргосе5$32Е!1т5% 
и Ргосез$32Мех{. Упомяну, что имеются еще аналогичные пары функций 
Неар32Е!`$% и Неар32Мехё, Неар3211$Е1`5 и Неар3211$5Мехё, позволяю- 
щие получить информацию о динамически распределяемой памяти процесса, 
а также функции МодщШе3 2Е!:' $4 и Моде 2Мехё, дающие информацию о мо- 
дулях, используемых процессом. Не будем на них останавливаться, так как 
они требуются очень редко. 

Теперь рассмотрим пример использования описанных выше функций. 
Этот пример содержится в проекте [/15{Ргосезз в каталоге Итаоиз на прило- 
женном к книге диске. Окно приложения во время выполнения показано 
на рис. 3.2. Компонент списка [1$Вох1 содержит упорядоченный по алфавиту 
список всех процессов, выполняющихся на компьютере. Кнопка Обновить по- 
зволяет обновить список, внеся в него процессы, выполняющиеся в данный 
момент. Окна редактирования в правой части формы показывают информа- 
цию, относящуюся к процессу, выделенному в списке 11$ Вох1. Окно Создан 
показывает дату и время создания процесса. Окно Длительность работы показы- 
вает, сколько времени прошло с начала создания процесса, в формате 
"чч:мм:сс”. Окна Время работы системы и Время работы кода отображают затраты 
времени на работу системы с данным процессом и на работу непосредственно 
с кодом процесса. Так что разница между суммой этих времен и длительно- 
стью работы отображает простой процесса. Остальные окна приложения ото- 
бражают такие характеристики процесса, как число потоков, число ссылок 
на процесс, приоритет процесса, версия. Вероятно, такая информация избы- 
точна. Цель заключалась в том, чтобы показать способы получения подобной 
информации. 

Кнопка Завершить позволяет закрыть ‘процесс, выделенный в окне 
11${Вох1. Будьте осторожнее, работая с ней. Не стоит пытаться закрывать ка- 
кие-нибудь системные процессы. Это может привести к непредсказуемым ре- 
зультатам. Кнопка Остановить позволяет остановить выполнение всех потоков 
процесса. При этом кнопка, которая реализована компонентом Зрее4ЯВиИов, 
остается нажатой, и надпись на ней меняется на текст "Освободить". Если 
в дальнейшем, выделив тот же процесс, щелкнуть на этой кнопке, то процесс 
будет освобожден. 


Рис. 3.2 ‚” Список процессов 
Пример приложения, | о. 
Создан 


работающего со списком | _  Ж® сть работы ^ 
процессов [27.03.2004 8:48:30 — Е 22: С 


ССРеск еке Время работы системы Время работы кода й 


сЧаетоп.ехе Го: 06:18 : 0: 06:00 


Чисяо потоков Чисяо ссылок 


ЕХРЕОНЕВ.ЕХЕ 
БоКеу1 .ехе й [о 

1ВУМ4.ЕХЕ 

1131 Ргосезз .ехе Приоритет _ Версмя` 


лаем ею 21 [ео 
_Обоототь | бои Зверь] | 


3.10 Информация о всех процессах и потоках и управление ими 


Ниже приведен код этого приложения. 
Описание класса в заголовочном файле: 


с]аз5 РТпЕЁЕ: ТОБ]есе 
| 


риЬ11с: 

РИОВО Озасе, // число ссылок 
ТЬгеааз, — // число потоков 
Рг1С1аззВазе, // базовый приоритет 
ТО; // идентификатор 

НАМОГЕ Н; // дескриптор 

Боо1 5изрепаеа; // остановлен, или нет 

ИОВО \1, \2; // версия 


}; 
Файл. реализации: 
#1пс1иае <&16е1р32.86> 


РТпЕЁ *ТПЕЁ; 


Уу01А _ Еаз®са11 ТГогм1: : РогшСгеа*е (ТОБ)есе *Зепаег) 
{ . 
// удаление дескрипторов и объектов списка Г[15ЕВох]1 

Бог (1106 1=0; 1 < 11$5ЕВох1->СочпЕ; 1++) 

{ 

С1озеНапа1е ( ((РТпЕЁ *) (11$ЕВох1->Т%ет$->0Ор)]есе$ [1]))->Н); 
Че1ефе 11.5&Вох1->Т6ем5->Ор]есе$ [1]; 

| 

.1$6Вох1->С1еаг(); 

ЗрееаВи*Еоп1->Помп = Ёа15е; 

// получение дескриптора списка процессов 


НАМРЬЕ Н5 = СгеахеТоо1пйе1р32$парзпо® (ТН3З2С$ _5МАРРВОСЕ$5, 0); 


РВОСЕЗЗЕМТВУЗ2 Р; 
Р.Ам$1те = з1хеоЕЁ (РВОСЕЗЗЕМТВУЗ2); 
РИОВО У; 
// просмотр списка процессов 
1Е (Ргосез$32Е1г5 (Н$, &Р)) 
{. 
о 
{ 
ТпЕ = пеи РТШЕ; | 
ТрЕ->0заде = Р.спЕОзаде; 
ТпЕ->ТЬгеаа$ = Р.спеТЬгеааз$; 
‚ ТрЕ->РгЕ1С1а$$Вазе = Р.рсРг1С1аз$Вазе; 
ТпЕ->ТО = Р.ЕР3З2Ркосез$Т0; 
ТрЕ->базрепаеЯ = Еа15е; 
У = СееРгосеззУегзтоп (Р.ЕПЗ32Ргосезз$Тр); 
Тр Е->УТ = НТМОВО (У); 
ТрЕ->\У2 = ТОМОВ (МУ); 
ТпЁ->Н = ОрепРгосез$ (РВОСЕЗ$ АШЬ АССЕЗ$, гие, 
Р.ЕИЗ2Ргосез$То); 
15ЕВох1->АЧаТеем (Р.52ЕхеЕ11е, (ТОБздес®е *)ТпЕ); 
} 
мИ11е (Ргосез$32Мехе (Н5, &Р)); 
} 
С1озеНапа]1е (Н5); 
Т1$ЕВох1->Т6епш1Тпаех = 0; 
.1$©Вох1С11скК ($епаег); 


У01А __Ёаз®са11 ТЕГогм] : :11$5ЕВох1С11сК (ТОБ]ес® *5епаег) 
{ 
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// получение информации о. процессе 
Еа11->С1еаг(); 
Еа1*2->С1еаг(); 
Еа13->С1еаг(); 
Еа14->С1еаг(); 
Еа1е5->С1еаг(); 
Еа1е6->С1еаг(); 
ЕЯ 7->С1еаг(); 
ТпЕ = (РТЛЕ *) (115ЕВох1->Т$етз->Ор]есё$ [115ЕВох1->ТфепТпаех]); 
Еа165->Техе = Т1пЕ->0Озаде; 
Еа164->Техё ТпЕ->ТЬгеаа$; 
Еа1 Е 6->ТехЕе ТрЕ->Рг1С1а$$Вазе; 
Еа1$8->ТехЕ ТпЕТобЕг (1пЕ->\1) + '.'.+ ТлЕТобекг (ТпЕ->У2); 
ТЕ (ТрЕ->Н) 
{ 
ЕТЬЕТТМЕ 1рСгеа®б1опТаиме, 1рёх4ЕТ4пе, ]1рКегпе1Т1те, 
1р9зегТ1ие; 
ЗУСТЕМТТМЕ Т, Т90; 
// информация о временных характеристиках 
СееРгосеззТ1те$ (ТпЕ->Н, &1рСгеа&1опТ1ме, &1рЕх1Таше, 
&1рКегпе1Т1ме, &1рОзегТ1пе); 
// пересчет на локальное время 
Е11еТ1пеТобузеемТаме (&1рСгеа&1опТ1те, &Т); 
ТТ1пеопетпЕогма®*1оп 1рТ1мебопеТпЕогта*1оп; 
бузеем: :ТРабеТ1ме Т1ос = бузЕетшТ1теТора$еТ1ме (Т); 


1Е (бестпе?опетпЕогтаетот (&1рт1теёопетиогмае1оп) 
== ТТМЕ ДОМЕ ТР ЗТАМПРАВЬ) 


Т]1ос = Т]1ос + (сопзЕ аочЬ1е;) (- рт1мейбпетпРогмаеф оп. В1аз - 
1рТ1мебопе1пЕогма*1оп.5$апаагаВ1аз) / (60 * 24); 
е1 зе 
Т1ос = Т1ос + (сопзЕ аоцЬ1е) (-1рТ1мейопеТпЕогкма*1оп.В1таз - 


1рТ1мебопеТпЕогта*1оп.Рау11а1В1аз) / (60 * 24); 
// занесение информации в окна редактирования 
Еа1&1->ТехЕ = РафсеТ1пеТоЗ*кг (Т1ос); 
Еа17->ТехЕ = Т1меТоЗег (М№ом() - Т10ос); 


Е1]еТ1щеТтобузетТ1ме (&1рКегпе1Т1те, &тТ); 
ЕаЯ1Е2->ТехЕ = ТлиеТобег (ЗузбемТ1теТораееТ1те (Т)); 
Р11еТ1теТобузкетТтме (&1рОзегТ1те, &Т); 
Еа1тЕ3->ТехЕ = ТлмеТобег (бузбемТ1теТораееТ1те (Т)); 
брееЯаВа Е оп1->Ромп = ТпЕ->базрепаеа; 

1Е (ЗрееЯ9Ваеоп1->Ромп) 

брееЯВоЕоп1->СарЕ1оп = "Освободить"; 
е1з5е Зрее4Ви*оп1->Сар®1оп = "Остановить"; 


у01Я _ Еаз®са11 ТЕоги1: :Еогтрезегоу (ТОБ]есЕ *5епдекг) 
{ 
// удаление дескрипторов и объектов списка Г15ЕВох1 
Еог (1106 1=0; 1 < 11$ЕВох1->Сойп®; 1++) 
{ 
С1озеНапа1е ( ((РТпЕЁ *) (113ЕВох1->ТЕем5->0р)есез[1]))->Н); 
Че1ефе 11$ЕВох1->Т$епз$->0ОБ)есез$ [1]; 
} 
Т.1$ЕВох1->С1еаг(); 


уо1А __ЁЕаз®са11 ТЕогм1 : :ВиЕ$оп1С11сК (ТОБ]есЕ *5епаег) 
| 

// обновление списка 

РогиСгеафе (5епаег); 

т1$ЕВох1->беЕГоса$ (); 
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\01А __Еаз®са11 ТКГогм1: :Ви6оп2С11сКк (ТОБ)]ес® *5епаег) 
{ 

// завершение процесса 

Теги1паЕеРгосез$$ (ТпЕ->Н, 5); 

Иа1ЕГог51па1е0Б)ес® (ТпЕ->Н, 1000); 

Ва Еоп1С11сК (бепаег); 


\01А __ Еаз®са11 ТЕГогп1 : : брееаВи*оп1С11сК (ТОБ]есе *5епаег) 
{ 
// остановка или отпускание всех потоков процесса 
ОМОВО ТО = ТпЕ->ТЬ; 
ТпЕ->5азрепаеа = 5реедВа*оп1->Бомп; 
НАМОТЕ Н5$ = СгеафеТоо1ве1р325парзро* (ТН3З2С5 _ЗМАРТНВЕАР, 0); 
ТНВЕАОЕМТВУЗ2 Р; 
Р.Амб12е = 512е90Е (ТНВЕАОРЕМТВУЗ2); 
НАМОЪЕ ЮТЬгеад; 
1Е (ТАРгеааз2Е1т5Е (Н$, &Р)) 
{ 
Чо 
1Е (Р.П32ОмпегРгосез$$Тр == Тр) 


{ 
1Е (РТЬгеаа = ОрепТргеаа(ТНВЕАР 50$5РЕМР ВЕЗОМЕ, ГАТЗЕ, 


Р.ЕПЗ2ТЬкеаатр) ) 
ТЕ (Зреея9Ви* © оп1->Ромп) 
{ 
Зи5репаТргеаа (ПТргеаа); 
брееЯяВи оп1->Саре1оп = "Освободить"; 
С1озеНапа1е (ПТргеаа); 


} 


е1 зе 

{ 

ВезитеТ,геаа (ПТИгеаа); 
брееаВиеоп1->Сар®1оп = "Остановить"; 
С1озеНапа1Те (ПТ! геаа).; 

} 


} 
мЬ11е (ТЬхеаа32Мехе (Н$, &Р)); 


}. 
С]1озеНапа1е (Н$); 


} 


Рассмотрим приведенный код. В заголовочном файле объявлен класс РШЁ 
объектов, в которых будет храниться информация о характеристиках процес- 
сов. Эти объекты будут храниться в списке 1,15&Вох1 наряду с именами процес- 
сов. Создание подобных объектов в момент формирования списка избавит нас 
потом от необходимости искать процесс, соответствующий выделенному поль- 
_ зователем в окне 1,1$4Вох{. Назначение элементов класса поясняется коммен- 
тариями, приведенными в листинге. 

Теперь рассмотрим файл реализации. В этом файле содержится директи- 
ва, подключающая заголовочный файл Нйер32.В, в котором объявлены неко- 
торые из используемых функций. Объявлена также глобальная переменная 
{, являющаяся указателем на объект класса РЁ, соответствующий процес- 
су, выделенному в списке 11$ Вох1. 

Функция РЕогтСтеа&е — это обработчик события ОпСгезжфе формы. Эта же 
функция вызывается при щелчке пользователя на кнопке Обновить. Назначе- 
ние функции — заполнить список 11$ Вох1 перечнем процессов. Но сначала 
надо очистить список от информации о процессах, занесенных в него ранее. 
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Просто очистить список методом  еаг недостаточно. Надо еще удалить объек- 
ты, связанные с каждой строкой. А перед их удалением надо закрыть дескрип- 
торы процессов, хранящиеся в них в поле Н. Эти операции осуществляет 
цикл, с которого начинается код функции РЕогтСгежфе. Затем функцией 
СгежеТооШе!р3 25 парзВо{ с параметром ТН3З2С5_$МАРРКОСЕЗ5$ создается 
дескриптор НЗ списка процессов. Объявляется также структура Р типа РКВО- 
СЕЗЗЕМТКУЗ2, в которую будет заноситься информация о процессах. 

Затем следует цикл, в котором функциями Ргосез532Е 1$ и Ргосе$$32- 
№ х{ в эту структуру заносится поочередно информация о процессах. Для ка- 
ждого процесса операцией пем создается объект ШЁ класса РШЁ, и в его поля 
заносятся характеристики процесса. Занесение значений полей Озасе, ТЬге- 
аз, Раа$$Вазе, ТО комментариев не требует — соответствующие значения 
просто переносятся из полей структуры Р. Вызов функции де Ргосез$ Уег$10п 
возвращает версию процесса, записанную в соответствующем файле ехе. 
В старших байтах возвращенного результата содержится основной номер вер- 
сии, а в младших — номер варианта. Эти данные извлекаются из возвращен- 
ного значения макросами НТУУОКО и ГОМОВО и заносятся в соответствую- 
щие поля объекта Тп#. Честно говоря, эта информация вряд ли имеет особый 
смысл. Она введена в приложении просто для того, чтобы показать примене- 
ние функции Се РгосеззУегз1оп. 

Далее функцией ОрепРгосез$ возвращается дескриптор процесса. Он нам 
понадобится для некоторых операций с процессом. Дескриптор сохраняется 
в поле Н объекта Ш. В заключение объект Ш вместе со строкой, содержащей 
имя процесса, добавляется в список 11$ Вох1{. Когда список заполнен, деск- 
риптор Н$ закрывается и следует вызов функции 11${Вох1СПсЕЁ, являющейся 
обработчиком события ОпСПеК списка 1.15Вох1. В этой функции в окна при- 
ложения заносится информация о процессе, выделенном в списке. 

Функция начинается с очистки окон, так как не для любого процесса мо- 
жет быть получена вся информация. Затем в глобальную переменную П\ зано- 
сится указатель на объект класса РЁ, связанный с выделенной в списке стро- 
кой. Из этого объекта в окна приложения переносятся значения числа ссылок, 
числа потоков, приоритета, версии. После этого следует код, обеспечивающий 
доступ к временным характеристикам процесса через его дескриптор Н. Вызы- 
вается функция Се Ргосез$Типез, заносящая эти характеристики в перемен- 
ные !рСгеаЙопТ1 те, 1рЕх Тише, рКегпе!Г!1те и 1рО5егТипе. Эти характери- 
стики хранятся в неудобном для отображения формате ЕП. ЕТТМЕ. Так что пе- 
‚ред отображением они сначала преобразуются функцией ЕПеТитеТобу$ет- 
ТГипе в системное время формата ЗУЗТЕМТ1МЕ, затем преобразуются функ- 
цией ЗузетТипеТодаеТ!те в формат ТОэфеТите, и только после этого зано- 
сятся в окна редактирования функциями ТипеТто$ г и ОеТ!пеТо5 4х. Но со 
временем создания процесса, заносимым в переменную !рСгеаИопТ!пе, возни- 
кают дополнительные сложности, связанные с тем, что это время по Гринви- 
чу, а перед отображением его надо перевести в локальное время с учетом сезон- 
ного сдвига. Все операции, связанные с подобным преобразованием, как и во- 
обще вопросы преобразования временных форматов, подробно описаны 
в разд. 1.15.1 и 1.15.2. , 

В заключение функции 11$ВохСПеЁ проверяется значение поля Зи$- 
репде4 объекта шф, указывающее, было ли приостановлено данным прило- 
жением выполнение процесса. В соответствии со значением этого поля уста- 
навливается состояние кнопки ЭЗрее4ВиНоп1 и изменяется текст надписи 
на ней. 
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Функция ЕогтОе$ {гоу является обработчиком события ОпОе$ гоу формы. 
В нем очищается память от объектов, на которые ссылается список 11$ Вох1, 
и закрываются дескрипторы процессов. 

Функция Вивйоп1СЦсК является обработчиком щелчка на кнопке Обно- 
вить. В ней просто вызывается описанная ранее функция ЕогтСгеафе, и фокус 
передается списку [1$&Вох1. 

Функция ВиНоп2СПесЕ является обработчиком щелчка на кнопке Зовер- 
шить. В ней процесс, дескриптор которого в функции 11$ Вох1СПеК занесен 
в поле Н объекта 1, завершается функцией ТегпипафеРгосез$ (см. разд. 3.8). 
После завершения процесса надо обновить список в 11$ Вох1. Для этого вызы- 
вается описанная ранее функция Ви_Йоп1СПекК. Но завершение процесса тре- 
бует некоторого времени. Так что если сразу вызвать ВаиЙоп1СПеК после 
ТегпипавеРгосе$$, закрывающийся процесс может отобразиться в списке, 
и только потом закрыться. Чтобы этого не произошло, используется функция 
ожидания УаЦЕогто1еОБес{ (см. разд. 3.1). Она вернется только после 
того, как процесс завершится. 

Функция ЭреедЯВиНоп1СЙеК является обработчиком щелчка на кнопке 
Остановить /Освободить. В зависимости от состояния кнопки приложение долж- 
но приостановить выполнение процесса, выделенного в списке 115&Вох1, или 
освободить остановленный процесс, чтобы его выполнение продолжалось. 
В АРТ \!114о\з отсутствует функция, позволяющая останавливать процесс. 
Но имеется возможность остановить все потоки процесса, применив к ним 
функцию ЗизрепаТЬгеа4. В результате выполнение процесса остановится, оно 
не будет тратить процессорное время, его окно станет недоступным и не будет 
реагировать на действия пользователя. Впрочем, щелчки мыши и иные дейст- 
вия будут запоминаться в очереди сообщений и после того, как приложение 
будет освобождено, оно обработает эти сообщения. 

Чтобы остановить или освободить все потоки процесса, надо найти эти по- 
токи. Для их поиска сначала вызывается функция Сгеж&еТооШе!р3 25 пар$В оф 
с параметром ТН32С$_$5МАРТНВЕАО, которая возвращает дескриптор спи- 
ска всех потоков, выполняющихся на компьютере. Затем функциями 
ТВгеа932Е!т$4 и ТЬгеа93 2Мехё организуется просмотр этого'списка. Характе- 
ристики каждого потока заносятся этими функциями в структуру Р. Для каж- 
дого потока проверяется, не равен ли идентификатор его родительского про- 
цесса, который записывается в поле 32О\мтегРгосе$$ О структуры Р, иден- 
тификатору Г процесса, выделенного в списке 111$ Вох1. Если равен, то с по- 
мощью функции ОрепТЬгеаЯ с параметром ТНКЕАО_ЗОЗРЕМО_ВЕЗОМЕ 
получается дескриптор потока. Затем в зависимости от состояния кнопки 
ЗрееЯВивоп1 поток останавливается функцией ЗизрепаТЬгеа4, или освобож- 
дается функцией ВезитеТЬгеаЯ. Затем дескриптор потока освобождается 
функцией С1озеНап е. Той же функцией по окончании просмотра всего спи- 
ска освобождается дескриптор списка потоков НЪ. 


3.1 Перехват событий буфера обмена 


Получить доступ к буферу обмена можно через функцию СИрфоаг@, не 
имеющую параметров. Чтобы ею воспользоваться, надо включить в модуль ди- 
рективу: 


#1пс10иае <ус1\С11рьга.Врр> 


220 Глава 3. Синхронизация процессов и потоков 


Функция СИрБоаг@ возвращает объект класса ТСИрБоаг@а, имеющий ряд 
методов и свойств. Информация в буфере обмена может быть записана в раз- 
личных форматах. Функция НазРогтав: 


Боо1 __Еаз®са11 НазГогмае (Йога Гогмаф); 


возвращает фгие, если формат, указанный параметром Еогтаф, зарегистриро- 
ван в системе. Значения параметра Еогтаф могут быть следующие: 


СЕ ТЕХТ Текст, каждая строка которого заканчивается символами 
СВ-ЦЕ, а весь текст заканчивается нулевым символом. 


СЕ_ВИТМАР Изображение типа битовой матрицы. __ 
СЕ_МЕТАЕП.ЕРТСТ | Изображение типа метафайла. 
СЕ_РУСТОВЕ Объект типа ТРасшиге. 


`СЕ_СОМРОМЕМТ Любой объект, наследующий ТРегз$4еп. 


Возможны и другие значения формата, зарегистрированные пользовате- 
лем с помощью метода Вег1$егСИрБоагаЕогта& класса ТР1ефаге. 

Все доступные форматы можно получить с помощью свойства Еогтаф$ 
объекта типа ТСИрЬоаг4. Это свойство представляет собой индексированный 
список значений зарегистрированных форматов. Свойство Еогта Соип& опре- 
деляет число таких форматов. Так что, например следующий код, занесет 
в список СошБоВох] все доступные форматы: 


#1пс1иае <ус1\С11рЬга.Врр> 


Рог (108 1=0; 1 < С11рьЬоака () ->Рогта&Соипе; 1++) 
СотроВох1->Т$етз->Ааа (ТпЕТобеЕг (СЪ1рЬоака () ->Гогта®$[1])); 


Правда, форматы, конечно, занесутся в виде чисел, а не в виде мнемонических 
констант. Так что пользоваться подобным списком неудобно. 

Свойство АзТехё объекта ТСИрЬоаг4 позволяет читать содержимое буфера 
обмена в виде строки типа Апз15 шо, а также заносить информацию в буфер 
обмена в текстовом виде. Например, чтение текста из буфера обмена в компо- 
нент В1еВЕЯЦ1 может быть организовано следующим образом: 


#1п0с11ае <ус1\С11рЬга.Врр> 


1Е (С11рьоака () ->НазЕогта* (СЕ_ТЕХТ)) 
В1свЕа1{1->ТехЕ = С11рроага () ->А$Техе; 


Следующий пример обеспечивает чтение изображения из буфера обмена 
в Ппаёе1: 


1Е (С11рроака () ->НазРогма® (СЕ_ВТТМАР)) 
{ 

ку 

{ 

Тпадче1->Р1сбаге->ГоааЕгомС11рбоагЯРогма* ( 

СЕ_ВТТМАР, С11рроага () ->бееАзНапа1е (СЕ _ВТТМАР), 0); 

} 
сафсп (...) ‚ 
{ 
5ПомМеззасде ("Загрузка изображения невозможна"); 
} 
} 


е1зе 
ЗПомМеззасве ("В буфере не точечное изображение"); 
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Иногда может требоваться отслеживать события, связанные с изменением 
содержимого буфера обмена. При занесении любой программой в буфер обмена 
каких-то данных генерируется сообщение У/п4омз ММ_ОКА\СЫРВОАВЮ, 
не имеющее параметров. Это сообщение поступает только в те окна, которые 
включены в цепочку окон просмотра буфера обмена. Включить свое окно в эту 
цепочку можно функцией Зе СИрбоага\У1е\мег: 


НИМ 5ееС11рЬоагаУ1еиег (ТМ НИМО Р\памемУтемег); 


Параметр В\УпЯМем У1ле\мег является дескриптором окна, включаемого 
в цепочку. Функция возвращает дескриптор следующего окна в цепочке. 

Если вы включили свою форму в цепочку окон просмотра буфера обмена, 
вы должны обеспечить обработку сообщений \УМ_ОКАМСИРВОАВО 
и \М_СНАМСЕСВСНАТУ. Сообщение \ММ_СНАМСЕСВСН ММ генерируется 
при изменениях в цепочке окон просмотра буфера. В конце обработчиков этих 
сообщений надо функцией Зеп@Мез5айе передать то же сообщение следующему 
окну цепочки, дескриптор которого вам вернула функция Зе СИрБоагаУ1ежег. 

Перед завершением приложения надо исключить свое окно из цепочки. 
Это делается функцией СвВапееСИрЬоагаСВап: 


ВОО СРапдесС11рБоагАСВазп (ТМ НИМР БИ\ИпавВемоуе, ТМ НИМР БИпаМемМехе); 


Параметр В\У/п4Ветоуе — дескриптор удаляемого окна, а параметр 
В \паМемМехё — дескриптор следующего окна в цепочке. 

В заключение рассмотрим пример приложения, постоянно отслеживаю- 
щего содержимое буфера обмена. Приложение имеет окно Вас ВЕЗИТ, в кото- 
рое заносится текст, и компонент Ппабе1, в который заносится изображение. 
Оба компонента в исходном состоянии невидимы. В зависимости от вида ин- 
формации в буфере обмена делается видимым тот или иной компонент. 


| = Буфер обмена 


В заключение рассмотрим пример приложения, 
постоянно отслеживающего содержимое буфера 
обмена. Этот проект РС!рБоаг4 имеется в каталоге 
С/рБоагд на приложенном к книге диске. Приложение 
имеет окно НисРЕ 1 ‚ в которое заносится текст, и 
компонент [таде1, в который заносится изображение. 
Оба компонента в исходном состоянии невидимы. В 
зависимости от вида информации в буфере обмена 
делается видимым тот или иной компонент. 

Ниже приведен код этого примера. 


Рис. 3.3. Приложение, перехватывающее события буфера обмена, связанные 
с занесением в буфер текста (а) или изображения (6) 


Ниже приведен код этого примера. 


Фрагмент заголовочного файла: 


с1аз$ ТЕогм1 : риб11с ТРогм 


{ 


рг1уаке: 
У01А __Еаз®са11 ОпрВАМСЬТРВОАВР (ТИММоРагапз& Меззаде); 
у014 _ Еазса11 ОпСНАМСЕСВСНАТМ (ТИММоРагамз& Меззаде); 
руБ11с: 
__Еаз®са11 ТРГогм1 (ТСомропепе* Омпег); 
ВЕСТМ_ МЕЗЗАСЕ МАР 
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МЕЗЗАСЕ НАМОГЕВ (ИМ ОВАМСЬТРВОАВО, ТИММоРагамз, ОпрвАМСЬТРВОАВО) 
МЕЗЗАСЕ НАМОГЕВ (ИМ СНАМСЕСВСНАТМ, ТИММоРагамз, ОПСНАМСЕСВСНАТМ) 
ЕМР МЕЗЗАСЕ МАР (ТСопропеп®) 
}; 


Файл реализации: 
#10с104е <ус1\С11рьга.Нрр> 


НИМО Нс1Ъ; 


У01А _ Еаз®са11 ТГогп1 : : ГогиСгеа%е (ТОБ)]есе *Збепаег) 


{ | | 
‚ Нс1Ь = 5е*С11рБоагаУ1емег (Напа1е); 


у01А __Еаз®са11 ТЕогм1: : Гогирезегоу (ТОБ]есЕ *бепаег) 


{ 
СРапаеС11рроагЯСва1пт (Напа1е, Нс1Ъ); 


} 


Уу01А _ Еаз®са11 ТГогм1 : : ОПОВАМСЬТРВОАВР (ТИММоРагамз& а) 


{ 

В1свЕа11->\У1$16]1е = Еа15е; 
Тпаче1->\У1$161е = Еа15е; 
ху 

{ | 
1Е (С11рроага() ->НазРогта% (СЕ _ВТТМАР)) 


Тмаде1->Р1сёаге->ГоааЕгопС11рроагаГогта® (СЕ_ВТТМАР, 
С11рроахга () ->бееАзНапа1е (СЕ _ВТТМАР), 0); 
Тмадче1->\1$161е = +кие; 
} 
е15е 
1Е (С11рроага () ->НазГогма® (СЕ_ТЕХТ)) 


{ 
В1срЕЯ1*1->Техе = С11рроага() ->АзТехь; 
В1срЕа11->У13151е = %&гае; 
} 
} 
саеср (...) 


{ 
ЗепаМез5ачде (Нс1р, ММ РВАМСЬТРВОАВО, О0, 0); 


\01А __Еаз®са11 ТРГогм]1 : : ОПСНАМСЕСВСНАТМ (ТИММоРагамз& а) 


{ 
ЗепаМеззаде (Нс1Ю, ИМ СНАМСЕСВСНАТМ, 0, 0); 


} 


Оператор в обработчике РЕогтСгеажфе события формы ОпСгезе включает 
функцией Зе СПрбоага УМе\чтег в цепочку окон просмотра буфера данное окно, 
заданное его дескриптором Нап Ще, и возвращает в глобальную переменную 
Не дескриптор следующего окна в цепочке. Оператор в обработчике Еогт- 
Оезёгоу события формы Оп ез{гоу удаляет функцией СвпапгеСИрБоагаСвВат 
данное окно из цепочки. 

Обработчик ОпПОВАМУСЫРВОАВО сообщения \ММ_ОВКВАМСИЫРВОАКО 
определяет методом НазЕогта формат содержащихся в буфере данных. Гра- 
фические данные заносятся в Ппабе1, текстовые — в Вае ВЕЯИ1. В любом случае 
в конце этого обработчика и`в обработчике сообщения \УМ_СНАМСЕСВСН АТМ 
вызывается функция ЗепЯМеззаре для передачи сообщения далее по цепочке. 


Ресурсы и ОЕ 


4.1 Ресурсы 
4.1.1 Общие сведения 


Приложение может использовать в своей работе самые различные ресур- 
сы — файлы пиктограмм и изображений, звуковые файлы, мультимедийные 
и т.п. Можно, конечно, хранить все это в отдельных файлах и загружать их во 
время выполнения методами гоа4ЕготЕПе. Но часто это не лучший вариант. 
Например, изображения или звуки нередко предпочтительнее хранить внутри 
исполняемых файлов. Во-первых, удобнее передавать пользователю один файл 
приложения, не добавляя к нему еще отдельные файлы изображений. Во-вто- 
рых, эти отдельные файлы какой-нибудь злоумышленник может легко подме- 
нить другими, и ваше приложение будет демонстрировать вовсе не те картин- 
ки или издавать не те звуки, которые были задуманы вами. В-третьих, ресур- 
сы, включенные в исполняемый файл, могут загружаться в оперативную па- 
мять только в те моменты, когда они затребованы программой. Это позволяет 
в ряде случаев существенно экономить затраты памяти. 

Но есть и определенные недостатки хранения ресурсов внутри исполняе- 
мого файла. Например, изображения, особенно битовые матрицы, могут недо- 
пустимо увеличить размер исполняемого модуля. Кроме того, использование 
отдельных файлов позволяет изменять отображаемые в приложении данные, 
не проводя повторной компиляции проекта. Это повышает гибкость приложе- 
ния, предоставляя возможность оперативно настраивать его, изменять в нем 
тексты и изображения без компиляции исполняемого файла и даже в отсутст- 
вии его исходных текстов. Так что в каждом конкретном случае надо рептать, 
какой вариант хранения тех или иных данных вам выгоднее: в ресурсах, или 
в отдельных файлах. | 

Ресурсы, включаемые в исполняемый файл, оформляются в виде двоичных 
файлов с расширениями .гез. Во время компиляции и компоновки эти файлы 
объединяются с результирующим исполняемым файлом. В приложениях 
С-+--+Ви!аег всегда автоматически создается файл .гез с именем, совпадающим 
с именем проекта и исполняемого файла. По умолчанию в нем хранится пикто- 
грамма приложения. Во время разработки вы можете включить в этот файл до- 
полнительные пиктограммы, битовые матрицы, курсоры. Делается это с помо- 
щью Редактора Изображений Ппабе ЕаЦКог, интегрированного в среду С++Вча- 
Паег 6. А можно создать отдельный файл и подключить его к проекту. Если вам 
не требуются какие-то ресурсы, кроме пиктограмм, битовых матриц, курсоров, 
то такой дополнительный файл ресурсов можно создать с помощью ПГптаве 
ЕаЦог. Но если вам нужны ресурсы иного вида, то создается текстовый файл 
описания ресурсов с расптирением .гс, который затем компилируется в файл 
.гез. В этом случае вы можете включить в файл ресурсов таблицу строк, файлы 
звуков и музыки, файлы изображений различных форматов, мультимедийные 
файлы, меню, таблицу горячих клавиш и любые другие виды ресурсов. 

Различные варианты создания и использования файлов ресурсов рассмот- 
рены в последующих разделах. 
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4.1.2 Создание ресурсов пиктограмм, битовых матриц 
и курсоров с помощью 1таде ЕЧКог 


В С++Ви!аег 6 имеется встроенный Редактор Изображений — Гпабе 
Е4Цог, который вызывается командой Тоо[ | |таде ЕаНог (в С++Ви!аег 2006 
его, почему-то, нет). Окно Редактора Изображений представлено на рис. 4.1. 
Это сравнительно простой редактор с не очень богатыми возможностями. Он 
позволяет создавать изображения в виде битовых матриц, пиктограмм, изо- 
бражений курсоров и не только сохранять созданные изображения в виде фай- 
лов, но и сразу включать их в файл ресурсов приложения. В этом и заключает- 
ся его основное отличие от других, более мощных графических редакторов. 

°’Команда Не | Меми открывает выпадающее меню, позволяющее создать но- 
вый файл ресурса приложения .гез, ресурса компонента .4сг, битовой матрицы 
тр, пиктограммы 4с0, курсора .сиг. Команда Ее | Ореп позволяет открыть 
файл соответствующего типа и что-то изменить в нем. Команды Не | Зауе и Не | 
5ауе Аз позволяют сохранить объект в файле. 

Работа с Редактором Изображений подробно описана в [1]. Так что остано- 
вимся только на вопросах работы с ресурсами. Если вы открываете командой 
Не | Ореп имеющийся файл ресурса приложения .гез, перед вами открывается 
окно, содержащее структуру файла в виде дерева (слева вверху на рис. 4.1). 
Сначала в нем может быть, кроме корневого узла Сотет$, только один узел — 
|соп, содержащий вершину МАШМСОМ, соответствующую стандартной пикто- 
грамме приложения. Если же вы создаете новый файл ресурса, то дерево в пер- 
вый момент будет иметь только корневой узел. Добавить новые узлы вы може- 
те с помощью команды Юезоигсе | Меми (ее вы можете найти и во всплывающем 
меню Редактора Изображений), выполняя которую вам предоставляется воз- 
можность выбрать один из типов элементов: Вйтар, Сугзог или |соп. 


Рис. 4.1 (И 1таде НОЕ 
Загрузка изображений в ресурсы | 
приложения лем 
3 Сузо 
`.. МУСУА$ОА 
|; 1соп 
-. АЕЗСОМ 
` МАМСОМ 


=} Витар 
` МАБЕТ 


Если вы включаете в ресурс новую битовую матрицу, перед вами откроет- 
ся небольшое диалоговое окно, в котором вы должны задать количество цветов 
изображения (2, 16 или 256) и размер изображения. Можно согласиться с раз- 
мером по умолчанию. Потом вы сможете его изменить. 
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После закрытия диалогового окна в дереве ресурсов появится узел, в кото- 
ром вы должны задать произвольное имя изображения (“ВЕЗСОМ” 
на рис. 4.1). Сделав двойной щелчок на этой вершине, вы откроете окно, в ко- 
торое надо будет ввести изображение. Если это изображение хранится в ка- 
ком-то файле, то проще всего открыть этот файл из редактора |таде ЕЧйог ко- 
мандой Не | Ореп с включенным фильтром Внтарз (*.Б тр). В окне открытия 
файла вы можете увидеть во всплывающем ярлычке размер изображения. 
Файл загрузится в отдельное окно. Если вы не запомнили размер изображе- 
ния, можете выполнить команду Вйтар | |паде Ргоре\ез или команду Ргоре\е$ 
контекстного меню. В открывшемся окне вы увидите размер изображения 
и количество цветов в нем. Далее выполните команду Ед! | беес! А! (горячие 
клавиши СН-А), чтобы выделить все изображение, и команду Е@! | Сору (горя- 
чие клавиши Сн|-С), чтобы скопировать изображение в буфер обмена. Перей- 
дите в окно, соответствующее формируемому изображению, установите коман- 
дой Витар | |таде Ргоре\ез или командой Ргорейез контекстного меню требуе- 
мый размер изображения и число цветов, а затем командой Ес! | Раз (горячие 
клавиши С!|-\/) введите изображение из буфера обмена. 

Аналогичным образом вы можете ввести в файл ресурсов все требуемые 
графические изображения из файлов .6бтр или 4с0. Только для ввода новой 
пиктограммы надо выполнить команду Юезоигсе | Мем | соп Ее или команду 
Ме\м | [соп контекстного меню. В заключение выделите в дереве вершину 
Сотепт и выполните команду Ее | 5ауе, сохраняющую файл ресурсов. 

Мы рассмотрели включение изображений в файл ресурсов проекта. Но, 
выполнив в редакторе изображений команду Кезоогсе | Мем | Кезоигсе Ее, вы мо- 
жете создать отдельны файл ресурсов, загрузить в него изображения и сохра- 
нить под любым именем. Позднее будет показано, как подключать подобный 
файл к вашему проекту. 

Теперь рассмотрим включение в ресурс нестандартного курсора. Пусть, 
например, вы хотите использовать в своем приложении курсор в виде человеч- 
ка с указкой. Вы выполняете Везоигсе | Мем | Сигзог, и в дереве структуры файла 
ресурсов приложения появляется новый узел. Вы должны задать его имя. За- 
тем вы щелкаете на созданной вершине и вам открывается заготовка изобра- 
жения курсора, в которой вы рисуете нужную картинку. 

При рисовании курсора в главном меню Редактора Изображений появляет- 
ся раздел Сигзог (см. рис. 4.1) с двумя подразделами: 5е! Но! Сро! — указание го- 
рячей точки, и [ез5! — тестирование. Горячая точка — это та точка изображения 
курсора, координатами которой являются параметры Х и У, передающиеся 
в обработчики событий мыши. При выборе раздела меню $е! Но! Сро! открывает- 
ся диалоговое окно, в котором вы должны задать горизонтальную и вертикаль- 
ную координаты горячей точки. Координаты задаются в пикселах, т.е. чтобы 
правильно указать координату надо посчитать, на сколько клеточек требуемая 
точка отстоит от левого верхнего угла рисунка. Например, для курсора на 
рис. 4.1 в качестве горячей точки, очевидно, надо задать точку конца указки. 

После задания горячей точки вы можете выбрать раздел меню Сигзог | Тез. 
Перед вами откроется окно, в котором курсор приобретет нарисованный вами 
вид. Нажав кнопку мыши и передвинув курсор, вы увидите, что за курсором 
тянется нарисованная линия. Вы можете видеть, из правильной ли точки кур- 
сора выходит эта линия, и при необходимости можете подкорректировать ко- 
ординаты горячей точки или само изображение курсора. 

После того как вы ввели в ресурс все, что требуется, надо перейти в окно 
структуры файла и выполнить команду Не | бауе или НЕ | бауе Аз. 
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4.1.3 Создание и компиляция файла описания ресурса ВС 


Если вам нужны ресурсы таких видов, которые не могут быть созданы 
в Редакторе Изображений, то вам надо сначала создать файл описания ресур- 
сов ВС. Этот файл вы можете создать в любом текстовом редакторе, включая 
использование пиктограммы Тех! в Депозитарии среды разработки С++Ви!аег. 
Сохранять его можно под любым именем с расширением .гс. 

Начнем рассмотрение синтаксиса файла В.С с описания таблицы строк, ко- 
торые далее можно использовать в приложении в качестве строковых кон- 
стант. Форма представления таблицы в файле ВС следующая: | 

ЗТВТМСТАВЬЕ тип_загрузки тип_памяти 


ВЕСТМ 
идентификатор строка 


ЕМО 

Тип загрузки и тип памяти могут не указываться. В качестве типа загруз- 
ки можно указать РВЕГОАЪ или ГОАБОМСА!Г. Если указан тип РВЕГОАР 
(предварительная загрузка), то строки загружаются в память сразу после за- 
пуска приложения. А если указать тип ГОАБОМСАЛТ, (загрузка при вызо- 
ве — этот тип принят по умолчанию), то строки будут загружаться в память 
в момент вызова их из приложения. Это экономит затраты памяти, но требует 
некоторых дополнительных затрат времени. 

В качестве типа памяти можно указать ЕТХЕО или МОУАВГЕ. Если ука- 
зан тип НТХЕРО (фиксированный), строки будут находиться в памяти по посто- 
янному адресу. Если указан тип МОУАВГЕ (перемещаемый), то У/ш4о\з мо- 
жет перемещать их при необходимости уплотнения памяти. Для типа 
МОУАВГЕ можно указать ключевое слово П1ЗСАВОАВЕЕ. Это означает, что 
У/1пао\з может забрать у приложения память, выделенную для ресурса. Если 
этот ресурс потребуется приложению, \Уш@о\мз загрузит его повторно из 
ехе-файла приложения. 

Между операторами ВЕСЛМ и ЕМО записываются включаемые в ресурс 
строки. Для каждой строки указывается ее идентификатор — целое число, по- 
сле которого пишется текст строки, отделенный от идентификатора пробелом 
‚или запятой. Ниже приведен пример таблицы строк: 

ЗТВТМСТАВЬЕ 
ВЕСТМ 
1000 "Использование ресурсов" 


1001, "Текст ВТЕ" 
ЕМО 


Задаваемые идентификаторы строк используются в дальнейшем в прило- 
жении для доступа к строке. Правда, помнить эти численные идентификаторы 
в процессе разработки приложения достаточно сложно, да и код получается 
недостаточно наглядным. Этого можно избежать, если создать заголовочный 
файл, в котором директивами #4ейште задать осмысленные идентификаторы, 
эквивалентные числовым. Такой файл можно директивой #щтещАе подклю- 
чить и к приложению, и к файлу описания ресурсов. В этом случае и в прило- 
жении, и в файле ВС можно использовать введенные осмысленные идентифи- 
каторы. Например, можно создать файл тиузНтя.Й с текстом: 


#АеЕ1лпе $Т1Е1е 1000 
#АеЕзпе $ЗВТЕ 1001 
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Тогда файл КС мо.жет иметь вид: 


#1пс10ае "пузег1па. р" 

// таблица строк 

оТКАТМСТАВТЬЕ 

ВЕС1М 

$Т1Е1е "Использование ресурсов" 
5ВТЕ "Текст ВТЕ" 

ЕМО 


В приведенном примере вы можете видеть также комментарий, который вво- 
дится в текст файла ВС обычным образом. 

Теперь рассмотрим включение в файл ВС других видов ресурсов, первона- 
чально расположенных в отдельных файлах. Все они включаются строками вида: 


идентификатор вид ресурса тип загрузки тип памяти имя файла 


Указание типа загрузки и типа памяти является необязательным. Смысл 
этих элементов описания не отличается от рассмотренного выше для строк. Иден- 
тификатор может быть или символьным идентификатором, или целым числом. 

Имя файла пишется или без указания пути, если файл расположен в том же 
каталоге, где находится файл ВС, или с полным путем. Если в имени или пути 
файла отсутствуют пробелы, имя может быть записано без кавычек. Но если 
имеются пробелы, то имя файла должно быть заключено в двойные кавычки. 

Для обозначения вида ресурса существуют некоторые предопределенные 
константы. Например: ВТТМАР — битовая матрица, 1СОМ — пиктограмма, 
СОВКЗОВ — курсор, ВСРАТА — определенный пользователем вид ресурса. 
Но, вообще говоря, в качестве вида ресурса, отличного от битовых матриц, 
пиктограмм и курсоров, можно задавать любой идентификатор, а не обяза- 
тельно константу ВСОАТА. 

Ниже приведен пример строк файла ВС, объявляющих ресурсы различ- 
ных видов: 

ТМАСЕ ВТТМАР "а:\Ргоадгам Е11ез\Соштоп Е11ез\Вог1апа Зракеа\Рафа\са$1.Б5тр" 

МУТСОМ ТСОМ МуВез.1со 

МУСУВ$ОВ СОВ$ОВ МуСагкзог. сие 

ЗЕАВСН ВКСРАТА зеагсй.ау\у1 

ВТЕ ВСРАТА МуВвТЕ. ГЕ 

$00Мр $00МО И1паомзХР.мау 


МУЕОМТ МЕОМТ муЕопе. ЕЕ 
МУОРЕС ОРЕС МУФРЕС.)ра 


Для битовой матрицы сиз1.6тр, пиктограммы МуВезл4со, курсора Му- 
Ситзог.сиг виды ресурсов обозначены предопределенными константами. Для 
мультимедийного файла зеатсй.ау и текстового файла в формате ВТЕ 
МуЕТЕ.ГЕ{ вид ресурса задан предопределенной константой ВСРАТА. Для 
звукового файла ИтаошзХР.шаи, файла шрифта ту/{оп. и файла изображе- 
ния Му/РЕС.р в формате УРЕС вид ресурса обзначен произвольными иден- 
тификаторами ЗООМО, МЕОМТ и 4РЕС. Вместо этих идентификаторов и вме- 
сто константы ВСРАТА можно было бы задать что угодно, например, 955. 
Все равно расшифровка того, что скрывается за определенным пользователем 
видом ресурса, возлагается на приложение, использующее ресурс. | 

Имя файла битовой матрицы заключено в кавычки, поскольку в пути 
к файлу встречаются пробелы. Остальные имена файлов даются без указания 
пути, поскольку предполагается, что они лежат в том же каталоге, в котором 
расположен файл ВС. — | 

Рассмотрим тепеэь компиляцию файла КВС, в результате которой создает- 
ся двоичный файл с расширением .гез. Для этого может использоваться ком- 


228 | Глава 4. Ресурсы и ОЕ 


пилятор ВВССЗ32, запускаемый в режиме ООБ: из окна 0ОБЗ, из У/ш9аомз 
Соттапаег, из Мо{4юп Соштапаег и т.п. Компилятор прилагается к С++Вч- 
Паег. Синтаксис командной строки при запуске компилятора следующий: 


ВКССЗ2 опции имя_файла.ВС 


Среди возможных опций отметим следующие: 


— 


—ю<имя_файла>.  Переименовывает ВЫХОДНОЙ файл .7ез. Если эта опция не 
| включена, имя выходного файла совпадает с именем входного. 


-- —— Ш 


Добавляет один или несколько путей, разделенных точкой 
с запятой, в в которых компилятор будет искать файлы. 
ный СЕ КОСК СУТ ПОС СР 

| Осуществляет вывод на экран сообщений компилятора. 


Выводит на экран справку. 


Рассмотрим примеры. Если вы сохранили свой файл ВС по именем Вез1.гс, 
то следующая командная строка обеспечит создание файла ресурсов Вез1.гез: 


Бгсс32 -У Вез1.гс 


- Следующая команда обеспечит создание файла ресурсов с именем Вез2.гез 
на основании файла описания Вез1.гс: 


Ьусс32 -у -ЕоВез2.ВЕЗ Вез1.ВС 


4.1.4 Использование файлов ресурсов в приложении | 


Подключить файл ресурса к исполняемому файлу можно несколькими 
способами. Один из них — добавление в головной файл приложения оператора 
ОЗЕВЕБЗ и указание в нем файла ресурса. Для рассмотренного в разд. 4.1.3 
примера это выглядит так: | 


ОЗЕВЕС ("Вез1.гез"); 


Только учтите, что если вы в процессе проектирования изменили содержи- 
мое файла ресурсов, то надо перекомпилировать проект командой Рго{ес! | Вийд. 
При обычной компиляции новый файл ресурсов не будет воспринят. 

Другой вариант — включить в свой модуль директиву ‘препроцессора 
ргагта ге5оигсе: 


#ргачта гезоцгсе "Вез1.гез" 


Если вы в описании файла ресурсов использовали какой-то заголовочный 
файл с объявлениями 4дейпе, дающими числовым идентификаторам осмыс- 
ленные символьные эквиваленты, то тот же заголовочный файл надо подклю- 
чить и к модулю приложения. Иначе вы не сможете в коде приложения ис- 
пользовать введенные вами обозначения идентификаторов. 

Рассмотрим применение файла ресурсов на тестовом примере, показанном 
во время выполнения на рис. 4.2. Этот пример имеется на приложенном к кни- 
ге диске в каталоге Везоигсе в проекте Вез. Он демонстрирует использование 
ресурсов различных видов: строк, текстов в формате ВТЕ, файлов изображе- 
ний в форматах ВМР, 1СО0О, ЗРЕС, мультимедийных файлов АУГ, звуковых 
файлов, курсоров, шрифтов. 


4.1 Ресурсы 


Рис. 4.2 

Приложение, 
тестирующее ресурсы (а), 
и его форма (6) 


это текст 
в формате КАТЕР 
АТ ре Уре. 


АсрЕ 91 


’ Вибоп4 


Викоиб 


ЗЫ 


Видоиб- = 


бреве ФВицои1 


[| 


Вишоп? 


| 


229 


Для этого приложения подготовлен следующий файл Вез1.гс описания ре- 


сурсов: 


#10с1аае "музег1па. В" 

// таблица строк | 
ЗТВТМСТАВЬЕ МОУЕАВЪЕ РТ5САВБРАВЬЕ 
ВЕСТМ , 

$Т161е "Использование ресурсов" 
1001 "Текст ВТЕ" 

$ВМР "Изображение ВМР" 

$МАУ "Звук МАУ" 

ЗАУТ "Мультимедиа АУТ" 

$1ТСО "Пиктограмма ТСО" 

$9РС "Изображение ФРЕС" 

$СОВ "Курсор" 

$РОМТ "Шрифт" 

ЕМО 

ЗЕАВСН КСРАТА зеагсИ.ау\у1 

ВТЕ ВСРАТА МУВТЕ. ЕЕ 

ТМАСЕ ВТТМАР "си51.Бипр" 
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МУ$ЗО0МО $500МБ М1паомзХР.мам 

МУТСОМ ТСОМ МувВе$.1со 

МУОРЕС ОРЕС МудРЕС.)ра 

МУСУВЗОК СУВЗОВ МуСигз5ог. сих 

МУРОМТ МРОМТ "а: \м1паои$ \Еопе5\АВТВЬК.ТТЕ" 


Подобный файл описания был рассмотрен в разд. 4.1.3. В его тексте пред- 
полагается, что все включаемые в ресурс файлы, кроме файла шрифта, распо- 
ложены в текущем каталоге. В качестве файла шрифта берется файл шрифта 
Ата! ВаскК. К, файлу описания подключается заголовочный файл тузтпа.й, 
в котором задаются строковые константы, обозначающие идентификаторы 
строк: 

#аеЁ1пе $Т1%1е 1000 

#аеЁ1пе зВтТЕ 1001 

#Аеё1пе $зВМР 1002 

#аеЁ1пе $зИАУ 1003 

#АаеЁ1пе зАУТ 1004 

+аеЕ1пе $зтТСо 1005 

$аеЁ1пе $з49РС 1006 

#аеЁЕ1пе зС08В 1007 

#$аеЁ1пе зРОМТ 1008 


Файл описания оттранслирован в файл ресурса Вез1.гез. В головной файл 
проекта введен оператор 


ОЗЕВЕЗ ("Вез1.гез"); 


подключающий ресурсы к проекту. В файл модуля введена инструкция 


#10с10оае "музек1па. В" 


подключающая описанный выше заголовочный файл тузётпа.й. Введена так- 
же инструкции 


#1пс1иАе <)реа.Врр> 


подключающая библиотечный файл реё.йрр, необходимый для работы с фай-_ 
лами формата УРЕС. 
Кроме того, в модуле объявлена глобальная константа сгМуСиогзог: 


соп5еЕ сгМуСигзог = 1; 


Она используется при регистрации курсора, хранящегося в ресурсах. 

Форма приложения показана на рис. 4.2 6, и, вероятно, не требует допол- 
нительных пояснений. 

Теперь рассмотрим отдельные процедуры модуля. В обработчик события 
ОпСгезж{е формы включен код: 


Апз15Ег1па 9; 

Коги1->Саре1оп = $.ГоаЯ5%к ($Т1%1е); ° 
сраг ЮаЕ[100]; 

Тоаа5Ег1па (НТпзбапсе, 1001, БоЕ, 100); 
Ваебоп1->Саре1оп = БоЕ; 

Ву оп2->Сар®1оп = Гоаа5ег );. 
Ваебоп3->Саре1оп = Тоаа5ек (5МАУ); 
) 
) 


(5ВМР 
( 
Ви боп4->Сар®1оп = Тоаабек (1004 
( . 
( 


у 


Ва боп5->СарЕ1оп = Гоаабекг ($1С0); 
Вчекоп6б->Сар®1оп = Гоаа5%г ($9РС); 

Ви боп7->Сар®1оп = Гоаа5ег ($РОМТ); 
ЗрееЯВи $ оп1->Саре1оп = Гоаа5ег ($С0В); 
Рапе11->Веуе1Оцеег = БуМопе; 
Рапе11->Саре1оп = ""; 
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Операторы этого кода, кроме трех последних, демонстрируют разные тех- 
нологии использования строк из ресурсов. Первый вариант — использование 
метода Гоа4З#` класса Апз15фгше. В этот метода в качестве аргумента переда- 
ется идентификатор строки ресурса. Метод возвращает эту строку типа Апз1- 
Эгшх, или пустую строку, если указанный идентификатор отсутствует в ре- 
сурсах. В приведенном коде использован идентификатор $ТЩе, объявленный 
в заголовочном файле туз "7т5.й и использованный в файле описания Вез1.гс. 
Эта строка заносится в заголовок окна — в свойство Еогт1—>СарНоп. Пере- 
менная %, объявленная в коде, честно говоря, не нужна. Она введена только 
для того, чтобы продемонстрировать использования метода Гоа@$%%г класса 
Ап; што. 

Второй способ извлечения строки ресурсов — функция АРТ У/1т94о\з 
ГоаЧ5{гшя, объявленной в файле штизег.Й следующим образом: 


106 Гоаа5®г1па (ТМ НТМУТАМСЕ ЮТпзвапсе, ТМ ОТМ\МТ оа10Ю, 
ОЧТ ЪТРЗТВ 1рВоЕЁЕег, ТМ 1пЕ пВаЕЕетМах}; 


Параметр Вшзапсе указывает дескриптор модуля, содержащего ресурс. 
В приведенном примере в качестве дескриптора задана переменная Н;азап- 
се — дескриптор приложения. Параметр и определяет идентификатор строки 
ресурса. В приведенном примере использован идентификатор 1001. С таким же 
успехом мог бы использоваться идентификатор $3ВТЕ. Параметры рВиЁег 
и пВоЁЙегМах определяют буфер, в который переносится строка, и размер этого 
буфера. Функция возвращает число символов, перенесенных в буфер, или 0, 
если строка не найдена. В приведенном примере в качестве буфера используется 
массив БаЁ. Записанная в него строка далее заносится в надпись на кнопке 
ВиНоп1 (см. рис. 4.2 6, и рис. 4.2 а с измененной надписью на кнопке). 

Все остальные надписи в примере задаются функцией Гоа9$%т, аналогич- 
ной рассмотренному ранее одноименному методу. Это, очевидно, самый про- 
стой способ извлечения строк из ресурсов. Если бы не желание показать пре- 
дыдущие варианты, в код не пришлось бы вводить ни строку 5, ни массив Би. 

Два предпоследних оператора приведенного кода задают параметры пане- 
ли Рапа1, которая используется в приложении для отображения движущихся 
изображений. 

В обработчик щелчка на кнопке ВиЙвоп3 (Звук \//А\ на рис. 4.2 а), демонст- 
рирующей использование звукового файла ресурса, включен оператор: 


Р1аубочпа ("МУ$О0МР", 0, $МР ВЕЗОЧВСЕ); 


Первым параметром в функцию Р]ауЗоип4 передается идентификатор ре- 
сурса МУЗОЧМО, объявленный в файле Вез1.гс. Последним параметром переда- 
ется флаг 5МО_ ВЕЗООВСЕ, указывающий на то, что звук берется из ресурса. 

В обработчике щелчка на кнопке ВиЙоп2 (Изображение ВМР на рис. 4.2 а), 
демонстрирующей использование битовой матрицы из ресурса, включен опе- 
ратор: 


Тпааез->Р1сфаге->В16мар->ГоаЯЕкхомВезонгсеМапте (0, "ТМАСЕ"); 


Здесь использован метод Гоа4ЕготВезоигсеМате объекта класса ТВЦ- 
тар — в нашем случае объекта Ттахе3 —>Р1еиге->ВИтар. Вторым парамет- 
ром в метод передается имя ресурса ТМАСЕ, объявленное в файле Вез1.гс. 

Столь. же несложно использовать пиктограмму из ресурса. В обработчик 
щелчка на кнопке ВиЙоп5 (Пиктограмма |СО на рис. 4.2 а) достаточно вклю- 
чить оператор: 


Тпаче1->Р1сбоге->Тсоп->Напа1е = ГоааТсоп (НТпзвапсе, "МУТСОМ"); 
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Этот оператор задает дескриптору объекта Ппахе1—>Р1ефаге-—>ЁГсоп значение, 
возвращаемое функцией Гоа4Тсоп. Вторым параметром в функцию передается 
имя ресурса МУТСОМ, объявленное в файле Кез31.гс. 

Демонстрация использования в приложении курсора из ресурса реализо- 
вана в рассматриваемом примере с помощью кнопки Зрее4ВиИоп1 (Курсор на 
рис. 4.2 а). В этой кнопке заданы свойства СгоирШдех = 1 и АПомАПОр = 
фгие, что обеспечивает фиксацию кнопки в нажатом и отпущенном состояни- 
ях. В обработчике щелчка на кнопке записан код: 


1Е (ЗрееаВиееоп1->)омп) 
{ 


Зсгееп->Сиг$ог$ [сугМуСогзог] = ГоаЯСиахзохг (НТпзбапсе, "МУСОВ$ОВ"); 
эсгееп->Сагзог = (ТСагзог) скМуСиг$ог; 


ее Зсгееп->Сигзог = сгр)еЁац1*; 

Оператор Ш проверяет, нажата ли кнопка Эрее4ВиЦоп1. Если нажата, то 
следующий оператор регистрирует в свойстве Сигзог$ объекта Эегееп курсор, 
дескриптор которого возвращается функцией Гоа Сигзог. В эту функцию вто- 
рым параметром передается имя ресурса МУСОВЗОВК, объявленное в файле 
Вез1.гс. При регистрации используется приведенное ранее объявление гло- 
бальной константы сегМуСигзог. Вообще говоря, регистрацию курсора надо 
было бы провести один раз в обработчике события ОпСгежфе формы. В данном 
случае этот оператор перенесен в обработчик щелчка на кнопке просто ради 
большей наглядности кода. Следующий оператор задает в качестве курсора 
этот курсор из ресурса. Если кнопка ЭЗрее4ВиВвоп1 не нажата, то в качестве 
курсора задается курсор по умолчанию сгОе#аи Ц. | 

Мы рассмотрели использование стандартных видов ресурсов. Как видим, 
для них существуют функции, облегчающие использование этих ресурсов. Не- 
стандартные ресурсы типа ВСРАТА или типа, объявленного пользователем, 
использовать несколько сложнее. Как правило, такие ресурсы извлекаются 
созданием объекта потока класса ТКезоигсе &геат. Конструктор этого класса 
имеет две формы: 

__ а$&са11 ТВезочгсе5геам(1пе Тпзбапсе, сопзе Ап$15%г1па ВезМапе, 


спаг * ВБезТуре); 
__Еазеса11 ТВезочгсе5геам(1пе Тпзбапсе, 1пе ВезТО, сраг * ВезТуре); 


Параметры Шшзфапее — дескриптор приложения, содержащего ресурс, 
и ВезТуре — тип ресурса одинаковы в обеих формах. В качестве значения пара- 
метра ВезТуре можно использовать предопределенное значение ВТ_ВСРАТА, 
если в объявлении ресурса тип указан как ВСРАТА, или строку с именем типа, 
введенного пользователем. 

Параметр ВезМате, указывающий имя ресурса, различается в приведен- 
ных формах конструктора. Если в файле описания ресурса вы указали цифро- 
вой идентификатор, то проще использовать вторую форму. Впрочем, можно 
использовать и первую, предварив число символом #. Пусть, например, вы 
объявили ресурс строкой: | 


100 ВСРАТА шуЕ11е 


Тогда для его загрузки можно применить вторую форму конструктора: 
ТКезоигсе5геам (0, 100, ВТ ВСРАТА)}; 

или первую форму: 
ТКезоигсе&геам (0, #100, ВТ ВСРПАТА); 
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Конструктор класса ТВезоигсе  {геашт непосредственно не вызывается. 
Объект этого класса создается с использованием операции пем. Рассмотрим 
примеры. | 

Обработчик щелчка на кнопке ВиЙвоп1 (Текст КТЁЕ на рис. 4.2 а), демонстри- 
рующей использование текстового файла ресурса в формате ВТЕ, может иметь 
вид: 

ТВезоцгсе5 геам *ВЕЁЕ = пем ТВезоцгсе$ Е геап (0, "ВТЕ", ВТ ВСРАТА); 


В1срЕа11->Т1пез->ГоааРтом Е геап (ВЕ); 
ае1ефе КЕЕ; 


В этом коде создается в памяти объект ВИ класса ТВезоигсе фгеат, в ко- 
торый загружается текст в формате ВТЕ, заданный в файле описания ресурсов 
с именем ВТЕ и типом ВСОАТА. Затем этот текст методом ГоаЯРГготфгеат 
объекта ВлеЕЯИ1-—>ТГ пез класса Т5%4г1те$ загружается в окно редактирова- 
ния ВА ВЕЗИТ. Аналогичным методом текст может загружаться в любой объ- 
ект класса Т5%г1те$. Последний оператор кода удаляет из памяти временный 
объект потока ВА. | 

`В данном случае использование ресурса облегчилось тем, что класс 
Т5Иит25$ имеет метод чтения из потока. Однако многие объекты умеют читать 
информацию только из файлов. В этих случаях приходится создавать из ре- 
сурсов временные или постоянные файлы. Рассмотрим, например, код обра- 
ботчика щелчка на кнопке ВиЙопб (Изображение РЕС на рис. 4.2 а), демонст- 
рирующей использование файла ресурса в формате УРЕС: 


ТВезоцгсе геам *ОЪ] = пем ТВезоигсе5геап (0, "МУСОРЕС", "ОРЕС"); 
Ор) ->бауеТоЕ11е ("-)]реа.7ра");. 
Че1ефе 0571; 


Тпадче2->Р1сбаге->оааЕгомЕ11е ("-)ред.)рд"); 
Ре1ефеЕ11е ("-)рез.)рда"); 


Первый оператор создает объект потока ОЪ} и загружает в него ресурс, указан- 
ный идентификатором МУУРЕС. В качестве типа ресурса указан введенный 
в файле Кез1[.гс тип УРЕС. Затем методом ЗауеТоЕШе потока создается в теку- 
щем каталоге временный файл с именем -/реё.ря, в котором сохраняется ре- 
сурс. Объект потока уничтожается. Далее методом Гоа@ЕгошЕе объекта Ппа- 
=ге2—>РАиге изображение из файла загружается в компонент Птабе2, после 
чего временный файл уничтожается функцией РеавеЕ Пе. Только надо не за- 
быть включить в модуль для работы с файлом УРЕС директиву: 


#10с1оае <ОРЕС.Врр> , 


Иначе чтение из файла приведет к генерации исключения. 

Аналогично можно организовать получение движущегося изображения из 
хранящегося в ресурсе файла типа АУГ. Обработчик щелчка на кнопке 
ВиНоп4 (Мультимедиа А\!| на рис. 4.2 а) может иметь вид: 


ТВезоцгсе5 геам *А\у1 = 
пеи ТВезоигсе$ < геап (0, "5ЕАВСН", ВТ ВСРАТА); 

А\у1->бауеТоЕ11е ("-А\у1.ау1"); 

Че1еее Аут; 

ТМеа1аР1ауег *МеЯ1аР1ауег1 = пем ТМеа1аР1ауег (Гоги1); 
Меч1аР1ауег1->\У15151]е = #а1зе; 

МеЯ1аР1ауег1->Рагеп® = Гоги]; 

Меа1аР1ауег1->Е11еМаще = "-А\у1.ау1"; 

Меа1аР1ауег1->Пеу1сеТуре = ААскобе1есе; 
Меа1аР1ауек1->р015р1ау = Рапе]11; 

Меа1аР1ауег1->Ореп (); 
Меа1аР1ауег1->Иа1& 


= Тгое; 
Меч1аР1ауег1->Р]1ау(); 
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Меа1аР1ауег1->С1о5е (); 
Ре1етеЕ11е ("-Ау1.ау1"); 
Че1еке Меа1аР1аует1; 


Так же, как раньше, из ресурса создается временный файл -А.а1. Затем 
создается объект МефаР]ауег1 для проигрывания этого файла. В качестве “эк- 
рана” для изображения задается панель Рапе!1. Изображение проигрывается, 
после чего временный файл и объект МеФаР]ауег1 уничтожаются. 

Следует сказать, что поведение компонента ТМе@аР1ауег в С++Вии- 
ег 2006 несколько отличается от его поведения в С++Ви!аег 6. Приведенный 
выше код работает, так как временный файл имеет расширение ‚ат, а свойст- 
во ЭеусеТуре компонента МеФаР1ауег1 задано равным 44 Ашюз@есе. Это обеспе- 
чивает автоматическое распознавание типа файла. В С++ВиПаег 6 работает 
и другой подход: расширение временного файла может быть произвольным 
(например, файл -Аи.+тр), и при значении ОБе\усеТуре = 4АУГУ ео файл будет 
проигрываться нормально. Но в С++ВиПаег 2006 значение {АУГ\У!ео, поче- 
му-то, не срабатывает. 

Теперь рассмотрим использование файла шрифта из ресурса. Тут может 
решаться две задачи. Первая из них связана с использованием шрифта в дан- 
ном сеансе работы данного приложения. Эта задача решается функцией 
АЗЧЕотВезопгсе, рассмотренной в разд. 1.14. Только в данном случае надо 
предварительно создать на диске временный файл шрифта. Другая задача свя- 
зана с постоянной фиксацией шрифта в системе. Подобная задача часто реша- 
ется во время установки приложения на компьютере. В рассматриваемом при- 
мере решается именно эта задача. Она сводится к тому, что надо скопировать 
файл шрифта в папку Итаошз\Роп1з. Обработчик щелчка на кнопке Ви воп7 
(Шрифт на рис. 4.2 а) имеет вид: 

сраг АРсбаг [255]; 

СееИ1паом$01гес®огу (АРсраг, 256); 

Ап5156©глпа бРопЕ = (Апз156г1па)АРсВаг + "\\ЕопЕз\ \муЕопе. ЕЕ"; 

1Е(! Е11еЕх15$е$ (5Роп®)) 


{ 

ТВезоцгсе$геам *ОБ)] = пем ТВезоцгсеб*геам (0, "МУГОМТ", "МЕОМТ"); 
Ор] ->бауеТоЕ11е (5Гопё); 

Че1ефе 0571; 

ЗпомМез$заде ("Шрифт установлен"); 


} 
е1з5е 5ПомМеззааце ("Шрифт уже был установлен"); 
Ви оп 7->Гоп&->Маше = "Аг1а1 В1асКк"; 


Сначала функцией Се \ том Плгесфогу в массив АРерВаг заносится путь 
к каталогу У/ш4о\мз. Затем в переменной 5Еопф формируется путь к создавае- 
мому файлу ту/опЕ.И{Р в подкаталоге Гоп каталога У/ш4о\з. Функцией 
ЕПеЕх!1545 проверяется, нет ли уже этого файла. Если он есть, пользователю 
выдается сообщение, что шрифт уже был установлен. Если файла нет, то с по- 
мощью временного объекта потока ОБ] файл из ресурса копируется в папку 
Гоп1з. Последний оператор задает кнопке ВиЙйоп7 имя установленного шриф- 
та (в примере в ресурс занесен шрифт Аша| В]аск). Проверить установку 
шрифта можно следующим образом. Откройте папку \У!114о\з РопЁёз непосред- 
ственно или с помощью Панели Управления. Удалите шрифт Аша! В1аск. По- 
сле этого запустите свое тестовое приложение и щелкните на кнопке Шрифт. 
Вы увидите, что приложение сообщит об установке шрифта, а в папке ГопЁз 
появится соответствующий элемент. Можете посмотреть также в реестре ключ 
НКЕУ 1ОСАЕ_МАСНИМЕ\ ЗОРТУ/УАКЕ\ МсгозойН\ М/тадо\муз МТ\ СитетмМУегзюп\, Гот. 
В этом ключе хранится информация об установленных шрифтах, и вы сможе- 
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те убедиться, что ваш файл шрифта зарегистрирован. Хочу предостеречь от со- 
блазна заменить копирование файла шрифта изменением соответствующего 
параметра в ключе реестра. Шрифт при установке фиксируется в нескольких 
местах реестра. И при копировании файла в папку Роп13 все эти записи изме- 
няются синхронно. | | 


4.2 Динамически присоединяемые библиотеки ОШ. 


4.2.1 Общее описание 


_ Динамически присоединяемая библиотека ОШ. — это специального вида 
исполняемый файл с расппирением .АЦ, используемый для хранения функций 
и ресурсов отдельно от исполняемого файла. Обычно, когда вы пишете про- 
грамму и создаете функции, ресурсы ит.п., все они компонуются в ваш испол- 
няемый файл. Когда же вы используете ОГ.[,, то вызываемые из нее функции 
используются вашим модулем в процессе его выполнения. ОТЛ, делает полез- 
ные, часто используемые функции доступными сразу для многих приложений 
одновременно, хотя работа ведется только с одной ее копией на диске и в памя- 
ти. Обычно ОШ, не загружается в память, пока это не станет необходимым, но, 
будучи однажды загружена, она делает свои функции и ресурсы доступными 
для любой программы. 

Предположим, вы разработали различные полезные процедуры и функ- 
ции и используете их в различных своих приложениях. Конечно, вы можете 
просто скопировать эти процедуры и функции в каждый ваш проект. Но тогда, 
если несколько ваших приложений работает на компьютере одновременно, то 
копии ваших процедур загружены в память в выполняемом модуле каждого 
приложения и память, таким образом, расходуется неэффективно. Да и затра- 
ты пространства на дисках также избыточны, поскольку эти процедуры в со- 
ставе выполняемых модулей также тиражируются. Если же вы поместили 
свои процедуры в. РОГ, то все эти проблемы снимаются. 

Создание ОГ, повышает также гибкость вашей программы. Например, вы 
можете создать несколько библиотек, содержащих все используемые вашим 
приложением тексты — надписи, подсказки и т.п. Каждая из этих библиотек 
может содержать тексты на том или ином языке: русском, английском, немец- 
ком. Тогда в зависимости от того, какую из этих библиотек будет применять 
пользователь, программы будут общаться с ним на том или ином языке. 

С помощью РЫ вы можете облегчить себе модификацию ваших приложе- 
ний. Пусть вы реализовали какие-то свои функции обычным образом, вклю- 
чив их в приложение и разослав это приложение пользователям. А потом поя- 
вились какие-то новые возможности, которые могли бы расширить ваши 
функции. Например, появились новые форматы файлов, на которые можно 
было бы настроить ваши функции. Чтобы реализовать эти новые возможно- 
сти, вам придется переписать прежние функции, скомпилировать новое при- 
ложение и разослать всем вашим пользователям. А если вы реализовали функ- 
ции в виде ОТТ,, то перекомпиляция приложений не потребуется. Достаточно 
создать новую небольшую ОШ, с тем же именем и теми же именами функций, 
реализованных по-новому, и разослать пользователям только эту новую О.С. 
| Еще одним преимуществом ОТ, является то, что они могут использовать- 

ся приложениями, написанными на других алгоритмических языках. Напри- 
мер, вы можете использовать библиотеки, написанные на Разса|, У1з0а| Ваз1с, 
Ассезз$ Ваз1с и др. А ваши библиотеки, созданные в С++ВоЦаег, смогут исполь- 
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зовать любые системы, которые умеют вызывать ВЫХ, независимо от того, на 
каких алгоритмических языках они написаны. | 

Библиотеки ОГ, могут связываться с вашим приложением двумя путями: 
статическим связыванием или динамическим связыванием. 

Статическое связывание означает, что РЫ, загружается сразу, как только 
начинает выполняться приложение, которое будет ее использовать. Это наибо- 
лее простой способ использования ОШ... Вызов функций в приложении, ис- 
пользующем подобную ПШ,, почти не отличается от вызова любых других. 
функций. Некоторыми недостатками такого подхода можно считать увеличе- 
ние времени загрузки вашего приложения (ведь кроме выполняемого модуля 
приложения в этот момент грузятся также модули соответствующих ОШ)) 
и невозможность выполнения приложения пользователем, у которого нет со- 
ответствующего файла ОШ... Последнее трудно назвать существенным недос- 
татком, поскольку, конечно, вы должны распространять приложение вместе 
с ОМ... Но ведь некоторые действия приложение могло бы выполнять и без 
ОМ, т.е. оно могло бы в урезанном виде функционировать и при отсутствии 
ОГ.Г. Однако при статическом связывании это невозможно. Еще одним недос- 
татком статического связывания является то, что РЫБ занимает память все 
время, в течение которого выполняется приложение, независимо от того, вы- 
зываются ли в данном сеансе работы с приложением какие-то функции биб- 
лиотеки, или нет. 

Динамическое связывание отличается от статического тем, что библиотека 
ОШ загружается только в тот момент, когда необходимо выполнить какую-то 
хранящуюся в ней функцию. Затем эту библиотеку можно выгрузить из памя- 
ти. Это обеспечивает, конечно, более эффективное использование памяти. Но 
зато вызов соответствующих функций библиотеки существенно усложняется, 
‚да и время вызова тоже увеличивается из-за необходимости загружать и вы- 
гружать библиотеку. 


4.2.2 Создание 01. 


Создание своей ОШ, в С++ВиПаег 6 начинается с выполнения команды 
Не | Ме\ | ОМег и выбора в окне Ме\ми !етз на странице Ме\м пиктограммы ОИ 
\У/Мтага — Мастера ОШ... В С++Во!аег 2006 при выполнении той же команды 
надо выбрать пиктограмму Оупапис-ШКк Ибгагу на странице С++ВиЙаег Ргоесв. 
Вы попадете в небольшое диалоговое окно, представленное для С++Ви!аег 6 
на рис. 4.3. В С++Ви!аег 2006 окно отличается только отсутствием индикато- 
ра зе СХ. В этом окне вы можете выбрать язык ОГ, — С или С++. Индикатор 
/5е УСЕ позволит вам создать О, которая может содержать компоненты биб- 
лиотеки УСГ. При этом в модуль включится файл УСГ.Л, и установятся опции 
компоновки, обеспечивающие совместимость с объектами УСТ. Индикатор 
Мой ТИгеаде4 позволит работать с несколькими потоками выполнения. А инди- 
катор \УС++ 5Уе ОЦ обеспечит создание ОШ, в стиле М!сгозо#% \У1зиа! С++. 


Рис. 4.3 | . ОЕ Мга 
Окно задания опций создания ПЕ 


| | 
СГМ М Теа я | 
Г МС++ бе ОЕ | 


ОЭ—————и—————_о——ыщо——щц——_——— 


[о] о | в | 
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После установки всех опций и щелчка на ОК вы попадете в окно Редактора 
Кода, в котором появится (при установках, показанных на рис. 4.3) модуль 
со следующим текстом: | 


#1п0с1таае <ус1.6> 
#11с1аАае <итпаом$.В> 
#ргачта Пагз®ор 


// ТтрогЕапЕ поЁе аБоцЕ РОГ тетогу тападетепЕ иБеп уоиг ОГ, 
// изез ЕРе 5ЕаЁ1с уегзтоп оЁ ЕВе КВипТлте ГлЬгагу: 


// ТЕ уоик ОШ ехрогЁ$ апу ЕипсЕтопз ЕВаЁ раз$ $Ег1па оБдесЕз 

// (ог зЕгасе$/ с1аззез сопфа1п1па пезееа 5%&г1п95$) аз рагамефег 

// ог ЕипсЕ1оп гезу1&5$, уоц м1]11 пееа во ааа ЕЪе 11ъгагку 

// МЕММСВ.ТТВ во Бор ЕВе ОР ркгодесе ап апу окПпег рго)есез 

// ЕпаЕ изе &1е 111. Уоч м111 а15зо пееа во азе МЕММСВ.ЬТВ 

// 1Е апу оЕВег ргодесЕз ий1лсН изе ЕВе РГ и111 Бе регЕотг1п9 

// пем ог ае]1еёе орегаЕ1оп$ оп апу поп-ТОБлесЕ-аеглуеа с1аз$зез 
‚ /Х/ иБлсВ аге ехрогЕеа Егот ЕВе ОГГ. Ааа1па МЕММСК.ГТВ Во уоиг 

// рголесЕ и111 сВапде Ее ОГ ап 1$ са111п9 ЕХЕ'5$ Ео изе ЕВе 

// ВОВЕМОММ. ОГ аз ЕВелфг тетогу тападег. Тп ЕВезе сазез, ЕВе 
// Е11е ВОВГМОММ.РГТ, зрои1а Бе аер1]оуеа а1опд и1ЕВ уоик О. 


// То ачо1а из1па ВОВГМОММ.ОТТ, раз$$ $зЕглпа 1пЕогта 1оп из1па 
// "свагк *" ог $ВогЕЗЕГК1па рагатееегз. | 


// ТЕ уоиг РГТ изез ЕРе аупат1с уегз1оп оЁ Ве КТГ, уои ао поЕ 
// пееа Ео ехр11с1Е1у ааа МЕММСВ.Г1В аз ЕР15 и111 Бе аопе 
// 1тр11с1Е1у Еог уоц 


(Комментарий гласит: Важное замечание об организации памяти ОГГ, если 
ваша ОГ использует статическую версию библиотеки времени выполнения 
КипТ1те ГлЬгагу: 


Если ваша ОГ экспортирует какие-то процедуры или функции, которым 
передаются в виде параметров или от которых получаются как результат 
объекты строк $5Ег1па (или структуры и классы, содержащие вложенные 
строки), вы должны добавлять библиотеку МЕММСК.ГТВ как в проект ПОГ, 
так и в любой проект, использующий эту ОГЬ. Вы должны также включать 
МЕММСВ.ГТВ в любой проект, использующий операции создания (пеи) 

и удаления (ае]еЕе) объектов экспортируемых из данной ОГ классов, не 
наследующих ТОБ]лесЕ. Добавление МЕММСК.ГТВ в ваш проект изменит ОГГ, 

и ее вызовы так, чтобы для распределения памяти использовалась 
библиотека ВОКГМОММ.РЬГ - диспетчер разделяемой памяти. В этих случаях 
файл ВОКГМОММ.РОГГ должен распространяться вместе с файлом вашей ОГГ. 

Чтобы избежать использования ВОКГМОММ.ОГГ, передавайте строковую 
информацию посредством параметров типа "саг *" или 5ВогЕЗЕГТпч. 

Если ваша ОГ использует динамическую версию КТГ, то вам не надо явным 
образом добавлять МЕММСК.Г1ТВ, так как это добавление будет сделано 
неявно.) 


#ргачма агазизеа 
106 ИМТМАРТ Р11ЕлёхуРо1п® (НТМЭТАМСЕ 1110$, ипз1апеа 1опдз геазоп, 
%У01А* ]1рВезегуед) 


{ 


гебагп 1; 


} 


Прежде всего, обратите в этом коде внимание на длинный комментарий. 
Его суть сводится к тому, что при передаче в функцию и из функции строк же- 
лательно использовать тип (еВаг *), а не, например, Апз15%&гше. Это избавит 
и вас, и пользователей вашей ОШ, от сложностей, связанных с необходимо- 
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стью использовать Ботпатт.аИ. Правда, указанные сложности могут возник- 
нуть, если ваша ОШ, использует статическую версию библиотеки времени вы- 
полнения ВКапТ1те ГалЬгагу. Версия библиотеки времени выполнения опреде- 
ляется индикатором Цзе дупатис КТЕ на странице ИпКег окна опций проекта, от- 
крываемого командой Рго|ес! | ОрнНопз. Если этот индикатор включен, ваш ис- 
полняемый модуль будет иметь меньший размер. Но при этом пользователю 
вы должны передавать не только ваш проект, но и динамическую версию биб- 
лиотеки времени выполнения: СС3260.ОГЛ, для однопоточных приложений 
или ССЗ260МТ.ОГЛ, для многопоточных. Этот вариант вряд ли обрадует вас 
и ваших пользователей. А при использовании статической версии библиотеки 
времени выполнения применение типов строк, отличных от (еВаг *), заставит 
вас передавать пользователю файл Ботпатт.аИ. Так что все-таки проще вее- 
гда ориентироваться при передаче строк на тип (еВаг *). 

Конечно, поняв суть рассмотренного нами комментария, его текст из мо- 
дуля лучше удалить. 

Обратите внимание в заготовке модуля ПШ, на строку 


#1пс1аае <ус1.6> 


Она подключает заголовочный файл ос[./. Этот файл нужен, если вы ис- 
пользуете какие-то классы, формы, функции, связанные с библиотекой визу- 
альных компонентов. В противном случае вы можете удалить этот оператор из 
текста ОГ. 

В конце приведенного текста заготовки ОБЬ используется функция 
ОПЕпегуРошЕе, необходимая для загрузки и выгрузки библиотеки. Эта функ- 
ция вызывается системой каждый раз при загрузке библиотеки в память и при 
завершении работы с ОШ... Параметр №11$% является дескриптором. Он требу- 
ется при выполнении некоторых функций, например, ГоаФеоп, Гоа4Сагбог 
и др. В этих случаях вы можете использовать параметр №11$%$ для создания со- 
ответствующей глобальной переменной. Параметр геазоп определяет причину 
вызова О.. Этот флаг может принимать одно из следующих значений: 


> =——— о ———7 


ыы ОНИ 
| СГ РКОСЕЗЗ_АТТАСН Указывает, что ОЛ, присоединяется к адресному 

' пространству текущего процесса в результате ее за- 
| 


| 
‚ пуска или вызова функции Гоа4ГЮгагу. В этот мо- | 
‘мент операционная система просматривает список | 
| | ' РЫЬ, загруженных для данного процесса и для всех 
‘еще не загруженных ОГ, вызывается функция | 
| _РПЕпегуРони. | 


= и. „=. -—. - — —ч 


М8 

, ОГ, ТНВЕАО_АТТАСН Указывает, что текущий процесс создает новый по- | 

‘ток. В этот момент вызываются функции ОПЕюшту- | 

Роны тех О, которые в данный момент присоеди- 

| | 
-- 


_нены к процессу. 


‚р ТНВЕА. _РЕТАСН | Указывает, что › текущий потой : завершается. | 


Б—Ш——=60=— 


| РЕГ_РВОСЕБЗ_РЕТАСН " Указывает. что ОШ, отсоединяется от адресного 
‹ пространства вызвавшего ее процесса в результате 
‚завершения процесса или в результате вызова фун- | 
_кции ЕгееГЛЬгагу. 


гг ей 


ОНИ ео онвибми ге 


Упоминаемые в приведенном описании функции ГоаАТаЬгагу и Егее- 
ТГ 16гагу, как будет показано в разд. 4.2.4, связаны с динамическим связывани- 
ем ОШ... 
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Параметр 1руВезегуе4 детализирует событие, связанное с вызовом ОПЕп- 
гуРотф. Если #4\Веазоп = ОТ, РВОСЕЗЗ_АТТАСН, то значение 1руВезег- 
уе4, равное МОТ, указывает на динамическое связывание библиотеки, а зна- 
чение, отличное от МОГ — на статическое связывание. Если #4мВеазоп = 
ры, РКОСЕЗЗ_ОЕТАСН, то значение 1руВезегуе4, равное МОТ, указывает 
на то, что произошел зызов функции ЕгееТЬгагу, а значение, отличное от 
МОГГ — на завершение процесса. 

В разд. 4.3 вы увидите‘пример использования функции ОПЕшгуРошё. Но 
даже если вы не намерены использовать ее явным образом, эта функция всегда 
должна присутствовать в ОШ... 

При нормальном завершении функции РИЕштуРойе она должна возвра- 
щать ненулевое значение. 

Рассмотрим пример создания чисто демонстрационной О... Чтобы пока- 
зать способы включения в РЫ, различных элементов, сначала мы разместим 
в ней процедуру без параметров ВоВеер, которая воспроизводит стандартный 
звук, а также функцию Софе, в которую передается строка и ключ и которая 
возвращает строку, зашифрованную или расшифрованную этим ключом. 
Позднее мы поместим в эту ОЬЬ еще форму диалога, запрапивающего у поль- 
зователя его имя. Подобная ОГЁ с именем МурГ.Г.АаИЙ имеется на приложенном 
к книге диске в группе проектов РаМурИ в каталоге ОГ.Г.. 

Чтобы создать подобную ОШ, выполните последовательно следующие 
шаги. 


1. Выполните команду Не | Мем | ОМег и выберите в окне Мем !етз на страни- 
це Мем пиктограмму ОШ \\/хага. Сделайте в диалоговом окне установки, 
показанные на рис. 4.3. Вы попадете в окно Редактора Кода, куда будет за- 
гружен приведенный ранее текст. 


2. Удалите из текста комментарий. 
3. Вставьте перед описанием директиву включения заголовочного файла: 


&10с10ае "ОМурьь.Ь" 


Файла (МурГ.Г..В пока нет, но скоро вы его создадите. 


4. Сохраните ваш модуль под именем ОИМирГГ и проект — под именем 
МурГ.Г.. 


Ниже приведены фрагменты кода этой ОШЬ, относящиеся к ВоВеер 
и Соде: 


#10с1аае <ус1.6> 
#10Сс1аае <м1тпаом$. [> 
#ргачта Вагз®ор 


#ргасчма агдазазеа 

#10с1аае "ОМУурЬг. В" 

116 МТМАРТ Р11ЕпегуРо1п® (НТМ5ТАМСЕ Б1"т5х, опзтареЯ 1опа геазоп, уо1а*) 
{ 


гебагп 1; 


Уу01А РоВеер() 


{ 
Веер (); 


} 


(“ 


сраг* Соае (сПпаг* 5, спаг Кеу) 


{ 
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Рог (106 1=0; ; 1++) 


1Е ($[1]=='\0') геак; 
$[1]=5$[1] ^ Кеу; 

} 

гесатп 5; 


} 


Функция ЮоВеер просто вызывает стандартную функцию Веер. А вот 
функцию Со4е следует пояснить. Она принимает строку 8 и целое значение 
ключа Кеу. Затем в цикле каждый символ исходной строки заменяется симво- 
лом, получаемым операцией исключающего ИЛИ ‘^’над индексом данного 
символа и ключом Кеу. В результате строка оказывается зашифрованной. 
Если повторно вызвать ту же функцию для зашифрованной строки с тем же 
ключом, то проведется дешифровка, и функция вернет первоначальную стро- 
ку. По такому принципу обычно проходит любая шифровка текстов. А дальше 
уже может подключаться фантазия разработчика. Можно для каждого очеред- 
ного символа менять ключ`по какому-то правилу. Например, если заменить 
оператор шифровки следующим оператором: 


$[1]=5[1] ^ (Кеу + (1% 3)); 


то ключ будет циклически меняться для каждой тройки символов. Чаще вооб- 
ще шифровка текстов производится несколько иначе. Вместо ключа, состоя- 
щего из одного символа, задается строка, и ее символы поочередно использу- 
ются как ключи. 

Функцию Со4е можно было бы реализовать следующим образом: 


Ап515Ег1па Соае (Ап$156г1лпа $, сраг Кеу) 
{ 


Еог (ЛЕ 1 = 1; 1 <= з.Бераерв (); 1++) 
$[1] = $[1] ^ Кеу; 
гебогй $5; 


} 


Этот вариант функции эквивалентен предыдущему, но не при включении 
функции в РЫ.. Вспомните комментарий, приведенный выше в описании мо- 
дуля РЫ.. Применение типа Апз15фгте вызовет описанные в нем сложности, 
тогда как вариант с типом еВаг * не приводит ни к каким проблемам. 


Теперь давайте введем в нашу ОЕ простую форму диалога, запрашиваю- 
щего имя пользователя. Выполните команду Не | Ме\, | Гогт, которая включит 
в вашу РПЛ, новую форму. Перенесите на форму метку, окно редактирования 
ЕЗИ1 и кнопку ВиЙоп, в свойстве Мода1ВезиЁ которой задайте тгОК. Размес- 
тите все это примерно так, как показано на рис. 4.4. 


Рис. 4.4 |+: Представтесь, пожай 
Форма диалога | 


Укажите свое имя. | 


[Пользователь 


.4.2 Динамически присоединяемые библиотеки ОЕ 241 


Сохраните модуль формы, задав ему имя (ИМур19]0#. В модуле формы ни- 
каких кодов в нашем случае можно не писать. А код ОЁЬ надо изменить сле- 
дующим образом: 


#1пс1иае "ОМур1а1оа.6" 


сраг * Мур1а1од(сВаг * Озег) 

{ 

ТРогт2* Когм = пем ТГоги2 (Арр11са®1оп); 
Рогп->ЕАа161->Техе = Озег; 
Еоги->5НомМоаа1 (); 

сраг* Вез = РГоги->Еа1&1->Техе.с_з6г(); 
РКоги->ГРгее (); 

гефагп Вез; 


} 


В приведенном коде введена функция МуО1а] ой, вызывающая диалог 
и возвращающая строку, которую пользователь указал в окне ЕЧИ1. В качест- 
ве параметра в функцию передается строка Озег — начальное значение имени 
пользователя. В функцию введена локальная переменная РЕогт. Первый вы- 
полняемый оператор создает экземпляр формы диалога. В окно редактирова- 
ния этой формы заносится строка О $ег. Затем методом ЭВомМода! форма по- 
казывается пользователю как модальная. После завершения работы пользова- 
теля с этой формой текст окна редактирования заносится в значение, возвра- 
щаемое функцией, и форма удаляется из памяти методом Егее. Таким обра- 
зом, функция вызова диалога не отличается от любой другой функции. 


Теперь давайте создадим заголовочный файл библиотеки. Выполните ко- 
манду Не | Мем | ОНег и выберите в окне Депозитария на странице Ме\м в 
С++ВиПаег 6 или на странице С++ВуШег Ргоесь | С++Вийаег Рез в 
С++Ви!аег 2006 пиктограмму Неоаег Ее. Вы попадете в окно Редактора Кода, 
куда будет загружен текстовый файл. 

Запишите в файл следующий код: 


#1Еп1аеЕ _МУРЬЬ Н 
#АаеЁ1пе _МУРЬЬ Н 


#1ЕаеЕ ры, _ 

# АеЁЕ1пе ОБЬ ЕГ _ @аес1зрес (а11ехрог®) 
#е1зе 

# аеЕ1пе РЬЬ ЕГ _ Ааес1зрес (а111прог®) 
#епа1 Е 


ехфегп "С" спаг * О ЕТ Соае (сваг *$, сраг Кеу); 
ехЕегп "С" уо1а ОТЬ ЕТ аореер(); 
ехеегп "С" спаг* РЬТ ЕТ Мур1а1о9 (спаг* Озег); 


#епа1 Е 


Сохраните файл командой Ее | Зауе с именем Ми )ГГ.й. 

Давайте всмотримся в приведенный выше текст заголовочного файла. По- 
смотрите на фрагмент, начинающийся с директивы #14еЁ. Использованный 
в нем идентификатор ОГ. ЕТ может быть любым — это просто произвольный 
идентификатор. А логика работы данного фрагмента следующая: если опреде- 
лен идентификатор _ _ЮОЁЬ _, то идентификатор ОГ Ш раскрывается как 
_ _ее$рес(4Пехрог{); если же _ ОШ, _ не определен, то идентификатор 
ОГ, ЕТ раскрывается как _ _4ес]5рес(9 Ш трог{). С++Во!аег автоматически 
определяет _ _ОТТ__ в случае, если создается проект РШЬ, и не определяет 
этот идентификатор при создании объекта приложения. Таким образом, в за- 
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висимости от того, включается ли заголовочный файл в библиотеку или в при- 
ложение, он будет выглядеть по-разному. При компиляции библиотеки стро- 
ка, определяющая нашу функцию Соде, после раскрытия макроса будет вос- 
приниматься как 


ехсегп "С" сраг * _ Яес15рес (911ехрог®) Соде (спаг *5$, сраг Кеу); 


Здесь конструкция _ _4ес]5рес(4Пехрогё) означает, что функция может 
экспортироваться из библиотеки, то есть может вызываться внешними прило- 
жениями. Подобным образом должны быть перечислены все функции ОШ,, 
предназначенные для прямого использования в приложениях. Помимо таких 
функций в ОГ, могут быть вспомогательные функции-утилиты, предназна- 
ченные только для использования другими функциями. Подобные утилиты не 
должны определяться как экспортируемые. 

Когда тот же заголовочный файл включается в приложение (как вы увиди- 
те, это делается при статическом связывании ОШ, с приложением), то эта же 
строка после раскрытия макроса имеет другой вид: 


ехтегп "С" сраг * _ 4ес15рес (9111трогЕ) Соде (спаг *$, сраг Кеу); 


Здесь конструкция __4е]5рес(аП1трог{) означает, что функция импорти- 
руется, то есть вносится в модуль из ОШ... Таким образом, один и тот же заго- 
ловочный файл может использоваться и при создании ОЩЬ, и в приложениях, 
обращающихся к данной ОШ... 

Продолжим создание ОТ\.. Введите в файл модуля вашей ОШ, инструкцию: 


#тос1иае "МурььЬ.в" 


Выполните команду Ргоес<! | ОрНопз и в окне опций проекта на странице 
ЦикКег убедитесь, что включен индикатор опции Сепегсе трой Югагу. Эта опция 
обеспечит при создании ОШ автоматическую генерацию библиотеки импор- 
та — файла .1, необходимого для описанного далее статического связывания 
ОШ, с проектами. | 

Выполните команду Ргоес! | ВиЙа МУОИ.. В результате будут созданы файлы 
МурГ.Г.аП и Мур АЮ. 

Если вы захотите теперь протестировать вашу ОШ, и выполните команду 
Кип | Кип (9), то получите сообщение: "Саппоф дефий рго)ес& ипезз а 603% 
аррЦсаН оп 1з аеЁ#теа. Озе ВапРагатецегз... 41а1о= ох”. Это означает, что вы 
сначала с помощью команды Вип | Рагатеег5 должны определить хост — тести- 
рующее приложение. | 


` 


` 


4.2.3 Статическое связывание и отладка ОИ. 


Создадим тестовое приложение для ОШ, разработанной в предыдущем раз- 
деле. Будем использовать при этом статическое связывание (см. разд. 4.2.1). 

Тестовое приложение удобно размещать в той же группе проектов, в кото- 
рой находится проект О1Ш.. Так что выполните команду М'е\ | Ргоес! Мападег, 
в окне Менеджера Проектов нажмите кнопку Ме\м и создайте новый проект. 
Сохраните его под именем ТезёОГ.1. 

Форма тестового приложения показана на рис. 4.5. На диске, приложен- 
ном к книге, вы найдете этот проект в группе РаМурИ в каталоге ОГ.Г.. Форма 
содержит окно редактирования ЕЯ] и три кнопки ВВеер, ВСоде и ВП1а]0х, 
вызывающие соответственно функции ОоВеер, Со4де и МуП1а1ог из ОШ.. 
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# 
Рис. 4.5 
Окно приложения Тез{рЕ1 


Ниже приведен основной текст модуля реализации тестового приложения: 


#1 пс1аае "МУРЬЬ. В" 
#1пс10оае "ОТезер111.5" 


У0о1Аа _ ЁЕазЕса11 ТКогм1: :ВВеерС11сК (ТОБ)]есЕ *5епаег) 


РоВеер(); 
} 
Инннняннннннннннннн-н========================- 
Уо1Аа __ЁЕазеса11 ТЕогм1:; : ВСоаеС11ск (ТОБ)есЕ *5епаег) 
{ 

Еа1*1->ТехЕ = Соае (Еа1{1->Техе.с_з%к(), 5); 
} 
Ииненнннннннннннн-нн============================= 


у01А _ ЕазЕса11 ТЕГогм1:;::В01а109С11сКк(ТОБ]есЕ *5епаег). 
{ 


Еа161->ТехЕ = Мур1а1о9 ("Пользователь"); 


} 


В начале тестового приложения следует инструкция, подключающая файл 
О туаП.Й. Это тот же заголовочный файл, который подключался в вашу ОШ... 
Но, как было сказано в разд. 4.2.2, этот файл после автоматического раскры- 
тия его макросов будет иметь вид, позволяющий приложению работать с им- 
портируемыми из библиотеки функциями. Использование импортируемых 
функций не отличается от использования любых других функций. В функции 
ВВеерСПсЕ просто вызывается импортируемая функция ВоВеер. В функции 
ВСо4деСПсК в импортируемую функцию Соде передается строка текста из окна 
ЕЧЦ1 и значение ключа 5. Зашифрованная строка текста возвращается в окно 
ЕЗЧЕТ. Так что если в этом окне написать какой-то текст, то при первом щелч- 
ке на кнопке ВСоде в окне отобразится зашифрованная строка, а при повтор- 
ном щелчке на той же кнопке эта строка будет расшифрована. Если вы в даль- 
нейшем усовершенствуете алгоритм шифрования, вам достаточно будет ском- 
пилировать новый вариант ОШ.. А все приложения, использующие ОШ, ника- 
кой модификации не потребуют. 

Функция ВПа1оСНекК вызывает из библиотеки диалог, передавая в него 
имя по умолчанию "Пользователь" (см. рис. 4.4). Имя, которое пользователь 
введет в этом диалоге, отобразится в окне ЕЦ] (рис. 4.5). 

Текст модуля готов. Но нам надо еще подключить к тестирующему прило- 
жению библиотеку импорта — файл .По, обеспечивающий статическое связы- 
вание библиотеки. Для этого, прежде всего, активизируйте в окне Менеджера 
Проектов ваше приложение. Это можно сделать двойным щелчком на вершине 
тестирующего проекта. Затем щелкните правой кнопкой мыши на этой верши- 
не и выберите из всплывшего меню команду Ада. Во всплывшем диалоговом 
окне выберите шаблон файлов "Тафгагу Ше (.115)” и выберите файл МирГГ..Ш. 
Это обеспечит при запуске вашего приложения статическое связывание биб- 
лиотеки. То же самое можно сделать командой Ргоес! | Ад ю Ргоес! или соот- 
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ветствующей быстрой кнопкой. Теперь можете сохранить ваше тестирующее 
приложение, откомпилировать его и выполнить. 

Работая с С++Ви!аег 2006, надо учесть, что исполняемый файл тестирую- 
щего приложения создастся в подкаталоге Рерих ВиНа, а файл МурГ.Г..аЦП бу- 
дет находиться в основном каталоге приложения. Так что надо перенести этот 
файл в подкаталог Ребий ВиПа, чтобы исполняемый файл приложения нашел 
библиотеку. 

Описанный способ подключения библиотеки импорта используется, начи- 
ная с С++Ви!аег 6. В младших версиях С++Ви4ег используется другой меха- 
низм. Надо в файл проекта включить операторы: 


ОЗЕБТВ ("МУрЬЬ. 110"); 
ОЗЕЕТЬЕ ("МУБЬЬ.В"); 


А в файл реализации, как и начиная с С++Ви!аег 6, включить инструк- 
цию: 


#10с1цае "МурЬЬ.Ь"; 


При запуске рассмотренного тестового приложения все будет выполняться 
нормально, если вы не сделали каких-то ошибок при написании ПМ.. Но так, как 
сложную библиотеку, вероятно, невозможно написать, не сделав каких-то ошибок, 
неизбежно возникает вопрос об отладке ОЫ.. Непосредственно выполнить файл 
ОШ, невозможно. Так что для отладки всегда требуется тестовое приложения, по- 
добное описанному выше. Но при выполнении тестового приложения вы можете 
видеть только результат работы. Вы не можете задать в коде ВЫ, какие-то остано- 
_вы и пройти код по шагам, наблюдая значения интересующих вас переменных. 
Чтобы осуществить подобную отладку ОШ. надо сделать следующее. 

Активизируйте в окне Менеджера Проектов (если вы его используете) вер- 
шину библиотеки МурГГ,АЦ. Далее выполните команду Кип | Рагатеегс. 
В С++ВиПаег 6 и более ранних версиях перед вами откроется окно, показанное 
на рис. 4.6 а. В С++ВоаЦаег 2006 в отрывшемся окне надо перейти в вершину 
ОеБиосег (см. рис. 4.6 6). В окошке Ноз аррйсайоп надо задать полное имя выпол- 
няемого файла тестового приложения. В этом вам может помочь кнопка Вго\зе. 

После того как вы указали хост для вашей библиотеки, можете щелкнуть 
на ОК и закрыть диалоговое окно. Теперь вы можете задать в коде библиотеки 
любые точки останова и запустить библиотеку на выполнение. Откроется окно 
указанного вами тестового приложения. А при вызове из него соответствую- 
щих процедур и функций библиотеки, будут остановы во введенных вами точ- 
ках, и вы сможете отлаживать ОГ как обычную программу. 


Рис. 4.6 а Вип Рагате!ег$ 
Задание для 0 тестового 
приложения в С-+-+ВийПаег 6 
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Рис. 4.6 © 
Задание для ОШ. тестового приложения в С+-+ВиНаег 2006 


4.2.4 Динамическое связывание 


Динамическое связывание, о котором говорилось в разд. 4.2.1, осуществ- 
ляется заметно сложнее статического, описанного в предыдущем разделе. Ди- 
намическое связывание можно разбить на три этапа. Прежде всего, надо за- 
грузить библиотеку функцией Гоа4ТЬгагу АРТ У/!14о\з. Затем с помощью 
функции Се РгосА94@гез$ надо получить указатели на интересующие вас 
функции библиотеки. Только после этого можно вызывать библиотечные 
функции. А после вызова функции или ряда функций надо выгрузить библио- 
теку из памяти с помощью функции ЕгееГ.Фгагу. 

Посмотрим, как это все реализуется на практике на примере ОГ, МирГГ, 
созданной в предыдущих разделах. Создайте кнопкой Ме\м в окне Менеджера 
Проектов новый проект. Сохраните его под именем Тез{01.1,2. Форма тестового 
приложения показана на рис. 4.7. На диске, приложенном к книге, вы найде- 
те этот проект в группе РаМирИ. Форма содержит те же компоненты, что фор- 
ма на рис. 4.5: окно редактирования ЕЯ9Ё1 и три кнопки ВВеер, ВСоде 


Рис. 4.7 | И Динамическое связый 
Тестовое приложение с динамической 
загрузкой 0: 


Мудао9 | 
Выгрузить | 
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и ВО1а]1о5, вызывающие соответственно функции ОоВеер, Со4е и МуП1а1юх из 
ОГ. Но кроме этих компонентов добавлены еще две кнопки: ВГоад и ВОп- 
Гоа4, загружающие и выгружающие ПШ.. | 

В заголовочный файл модуля или в файл его реализации надо ввести объ- 
явления вида: 

// Объявление типа указателя на ОГ 

НТМОТАМСЕ 911Шпзбапсе; 

// Объявление типов и переменных указателей на функции ВР 


суреЯеЕ уо1а (__1трог®е * ВТуре()); 

ВТуре.* ПоВеер = МОШГ; 

суредеЕЁ сраг (_ 1трогЕе * СТуре (спаг *, сраг)); 
СТуре * Соде ПБесоае = МО; 

фуреаеЕ сВахг ( 1прогЕ * ПОТуре (спаг *)); 


РТуре * Р1а1о9 = МОБ; 
Первов объявление вводит переменную АШаз&апсе, которая будет содержать 
указатель на загруженный модуль ОШ.. Вводимые типы ВТуре, СТуре и ОТу- 
ре соответствуют типам соответственно функций ОоВеер, Со4де и МуП1а10о=х, 
импортируемых из библиотеки. Переменные ОоВеер, Со4е_Песоде и П1а]ой 
будут содержать указатели на эти функции. Фактически имена этих перемен- 
ных будут использоваться далее как имена соответствующих функций. Как 
видно из приведенного объявления, мы можем задавать имена функций, сов- 
падающие с именами в библиотеке (БоВеер), или отличные от них. Это являет- 
ся одним из преимуществ динамического присоединения библиотек. Переиме- 
нование функций необходимо, в частности, если в приложении уже использу- 
ется другая функция с именем, совпадающим с импортируемым из библиоте- 
ки. Если бы не возможность изменять имена при импорте, то подобная ситуа- 
ция вызвала бы неразрешимый конфликт. 

Ниже приведены коды функций в модуле реализации тестового приложения. 


у01Я _ Газ®са11 ТКГоги1::ВЪоааС11сКк (ТОБ)есе *5епаег) 
{ 
// загрузка ОГ 
Я91]Тизбапсе = ГоааГ1Ьгакгу ("МурьЬ.а11"); 
1Е (9411Тпзбапсе) 
{ 
// получение указателей на функции 
РоВеер = (ВТуре *) СеЕРгосАаагезз (а911Тп5$апсе, " ПБоВеер"); 
СоЯе ПРесо4е = (СТуре *) СбеЕРгосАа@агез$ (9411Тпзфапсе, "_Соае"); 
Рла1о3 = (РТуре *) СбееРгосАЯа@агкез$ (а911Тпз®апсе, "_Мур1а1оч9"); 


} . 
е15е 5помМеззаде ("Не удалось загрузить 'МуБрЪЬЬ.911'"); 


\У01А __Га5®са11 ТГоги1:: ВИпроааС11сКк(ТОБ]есЕ *5епаег) 
р 


// выгрузка РЫЁ 
Егеер1ргаку (911Тпзбапсе); 
роВеер = МОГ; 
Со9е_Ресоае = МОТ; 


Р1а1оа = МОГ; 


у01а __Еаз®са]11 ТЕогш1: :ВВеерС11ск (ТОБ)]есЕ *5бепаекг) 
{ 
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1Е (РоВеер) ПоВеер(); 
е1зе 5ПомМеззаае ("Функция 'ПоВеер' недоступна"); 


1Е (Со4ае_Ресоае) 
ЕЧ11->ТехЕ = Соае Ресоае (Е91%1->Техе.с_5Ег(), 5); 
е15е 5помМеззаде ("Функция 'Соае Ресо4е' недоступна"); 


ен янннннннннннннн-н==---===========-=---- 
У01Аа _ Еазеса11 ТЁГогм1: :В21а1о09С11сК (ТОБ]есЕ *5епаег) 


` Е (р1а1о9) Еа1*1->Тех+. = ПОза1очд ("Пользователь"); 
е15е 5ПомМез$заае ("Функция '01а1]од' недоступна"); 
} 

Функция ВГоааСИПсК осуществляет загрузку библиотеки функцией Гоад- 
ТлЬгагу. В качестве аргумента в ГоаЯГЮгагу передается имя загружаемого мо- 
дуля. Если имя указано без пути, то соответствующий файл ищется в катало- 
ге, из которого запущено приложение, в текущем каталоге, в системных ката- 
логах \!114о\з$, в каталогах, указанных в переменной окружения РАТН. Если 
файл не найден, функция возвращает нуль. Если файл найден, то проверяется, 
не загружен ли он ранее. Если не загружен, то производится его загрузка. 
Если он уже загружен, то увеличивается на 1 число ссылок на него. В обоих 
случаях функция ГоааТгагу возвращает дескриптор загруженного модуля. 

Таким образом, при успешной загрузке в переменную АШтзапее помеща- 
ется дескриптор библиотеки. Далее в процедуре ВГоааСПеК с помощью функ- 
ции ЧеРгосА94ге5$ определяются адреса библиотечных функций. В качестве 
аргументов в Се РгосА@4@4гез$ передается дескриптор модуля и экспортируе- 
мое имя функции. В случае успешного выполнения Се РгосАЯ@ге$$ возвраща- 
ет адрес процедуры или функции. При неудаче возвращает 0. 

Как видите, в приведенном коде перед именами импортируемых функций 
добавляется символ подчеркивания. Дело в том, что при экспорте из РЫ, 
С+-+ВоаПаег добавляет символ подчеркивания перед именами функций. Этот 
режим работы среды разработки С++Ви!И4ег, принятый по умолчанию, можно 
отключить. Для этого выполните команду Ргоес! | ОрНнопз и на странице 
Адуапсеа Сотрйег открывшегося диалогового окна выключите индикатор Сепе- 
го1е Упаегсогез. 

Процедура ВОпГоааСПеК выгружает библиотеку из памяти функцией 
ЕгееТл6гагу. Точнее, функция ЕгееГлЬгагу уменьшает на 1 число ссылок на 
загруженную библиотеку. Если число ссылок становится равным 0, библиоте- 
ка выгружается. В противном случае она сохраняется в памяти. 

Функция ЕогтОе$ {гоу является обработчиком события ОпОе$ {гоу формы. 
В этой функции осуществляется выгрузка библиотеки из адресного простран- 
ства, если ранее она не была выгружена. Цикл ме обеспечивает повторение 
вызова ЕгееГлЮгагу, пока эта функция не вернет Ёа{5е, т.е. пока библиотека не 
окажется действительно удаленной. Таким образом, библиотека выгрузится, 
даже если до этого несколько раз вызывалась функция ГоаЧТабгагу. Подоб- 
ный цикл в данном случае особого смысла не имеет, так как при завершении 
приложения память, отведенная под него, все равно освободится. Однако по- 
добные циклы имеет смысл организовывать в тех случаях, когда вам надо вы- 
грузить библиотеку, но точно неизвестно, не загружалась ли она в ватем при- 
ложении несколько раз. | 

Все остальные функции приведенного кода обеспечивают обычный вызов 
функций и не отличаются от рассмотренных в предыдущем разделе. Перед вы- 
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зовом каждой функции проверяется, не равен ли указатель на нее значению 
МОЕ. Такое значение указатель может иметь, если библиотека не загрузи- 
лась (например, не найдена в соответствующих каталогах компьютера), или 
если в библиотеке нет требуемой функции (в нашем примере она заведомо 
есть). Отсутствие проверки указателя приведет при вызове функции к генера- 
ции исключения и появлению окна, сообщающего пользователю на чистом 
английском языке о попытке обратиться к какому-то адресу памяти. Подобное 
сообщение, естественно, только травмирует пользователя, не давая никакой 
полезной информации о данной ситуации. 


4.2.5 ОШ в С++ВийЙаег и Месгобо Миа! С++ 


Если вы хотите создать ОШЬ, которая могла бы в дальнейшем использо- 
ваться и в проектах С+-+Ви!аег, и в проектах М1сгозо{% У1з0а1 С++, надо при- 
нять для этого некоторые меры. Прежде всего, следите за тем, чтобы при соз- 
дании библиотеки в окне рис. 4.3 была включена радиокнопка \УСС++ Ууе 0Ц. 
Это обеспечит возможность динамического связывания библиотеки с проекта- 
ми М1сгозоЁй У1зиа| С++. Методика динамического связывания библиотеки 
с приложением У15и1а| С++ ничем не отличается от рассмотренной в раз. 4.2.4: 
библиотека загружается функцией Гоа@ТлЬгагу, адрес используемой функции 
определяется вызовом Се РгосА94@ге$$, а выгружается библиотека функцией 
ЕгееГ1Ьгагу. Но при статическом связывании ОШ, с приложением М1сгозоЁ 
\У15иа! С++ некоторые проблемы могут возникнуть. Причина ‘в том, что 
в С++ВиПаег и в М!сгозой У1зца! С++ приняты разные форматы экспорта 
функций: СОГЕР и ОМЕ. Так что вам придется несколько изменить информа- 
цию об экспортируемых функциях. 

Эту задачу позволяет решить утилита [трае].ехе, находящаяся в каталоге 
Вт вашей версии С++Ви!аег. Утилита создает из указанного файла ОШ, тек- 
стовый файл описания с расширением .4е], который вы далее можете редакти- 
ровать. Первым параметром командной строки при вызове [трае} передается 
имя создаваемого файла .4е}{, а вторым — имя файла .41. Например, если вы 
выполните команду: 


1праеЕ.ехе Мур1Г.аеЕ Мур11.411 


то будет создан файл Ми)Г..4е} описания вашей ОШ.. Он будет иметь вид: 


ЬЪТВКАКУ МУРЬЬ.РЬЬ 
ЕХРОВТ$ о 
@@0муа1а10о3@Е1па112е @5 ; __ Ш1пКргос __ Опу41а1о9: :Е1па112е 
@@0ту41а1оч@1п1Е1а1127е @4 ; _ ]1пКкргос _ ЧУмуЧ1а1оа: :1п161а112е 
_Соае . @3 ; Соае 
‚РоВеер @2 ; _РоВеер 
_Когт2 @77 ; _Когм2 
_Мур1а1оа @1 ; _Мур1а1о9ч 
___ СРРАаерааноок @6 ; ___ СРРАаерааНоок 


В этом тексте вы видите, в частности, строки описания функций _Соде, 
_ДоВеер, _МуП1а10Р. Эти строки начинаются с имени функции, за которым 
следует уникальный номер, присваиваемый каждому входу в ОШ.. Затем 
после точки с запятой следует комментарий — первоначальное имя функ- 
ции. | 

Если вы хотите преобразовать вашу ОМ, для работы с М1сгозо{% У1зиа1 С++, 
надо удалить символы подчеркивания, с которых начинаются имена функций 
_Со4е, _ОоВеер, _Му[Па1о=. Теперь можно создать файл импортируемой биб- 
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лиотеки в формате М1!сгозоЁ У1зиа| С++. Это делается программой Пб.ехе, по- 
ставляемой вместе с М1сгозо У1з0а| С++. Вызвать ее надо командой: 


ТТВ /РЕЕ:МурьЬ. ЧеЕ 


В результате будет создан файл МирГГ..ЙЬ, который можно включать в проект 
\У1$1а1 С++. 

Теперь рассмотрим обратную задачу — использование в проекте С+-+Вл- 
Паег библиотеки, созданной в \У151а| С++. Имеется два пути решения этой за- 
дачи. Если вы имеете исходную импортируемую библиотеку .16, то можете ис- 
пользовать утилиту Со/2ОтЁехе, находящуюся в каталоге Вт вашей версии 
С+-+ВиИаег. Через командную строку в нее передается имя файла исходной 
библиотеки и имя файла новой библиотеки. Конечно, эти имена должны быть 
различными или хотя бы различаться расширениями. Иначе вы испортите ис- 
ходную библиотеку. Например, если имя исходной библиотеки УСШЫВ.ИФ, то 
вызов утилиты Со{{2От{ может иметь вид: 


СоЕЕ2ОщЕ УСЬТВ.11р УСЬТВ. пр 


В результате создастся файл УСЫВАтр, который является импортируемой 
библиотекой в формате С++Ви!аег. Вам остается перенести его в нужный ка- 
талог и изменить расширение на .ЦФ. 

Если изложенный способ преобразования файлов не привел к успеху, или 
если вы не имеете файла .16 исходной библиотеки, имеется другой путь реше- 
ния той же задачи. Создайте с помощью описанной выше утилиты [трае] 
файл описания‘ .4е} и посмотрите в нем экспортируемые функции. Если строки 
описания функций имеют вид подобный следующему: 


_Еипспаме@7 = _Еипспаще @1 


то приведите их к виду: 


Еипспаме=_Еопспаме@7 


Затем сохраните отредактированный фай и создайте на его основе с помо- 
щью утилиты [триб файл .Пб. В утилиту ГтрИф через командную строку пере- 
дается сначала имя создаваемого файла импортируемой библиотеки, а затем 
имя файла описания. Например: 


Тир11.ехе \УСЬтв.11ь УСТЛВ.АеЕ 


Созданный файл .П можно статически связывать с проектом С+-+Ви!Паег. 

В целом, как видим, статическое связывание библиотек, созданных в разных 
системах, сопряжено с определенными сложностями. Так что надежнее всего ис- 
пользовать в этих случаях динамическое связывание. Тем более, что этот вариант 
имеет и ряд других преимуществ, описанных в предыдущих разделах. 


4.2.6 Изображения в ОИ. 


Вопросы хранения изображений в ресурсах приложений подробно рас- 
сматривались в разд. 4.1.2. Аналогичным образом могут формироваться ре- 
сурсы ОГ. В них имеет смысл хранить изображения, которые затем будут ис- 
пользовать различные приложения. Эти изображения хранятся в файле с рас- 
ширением .гез и с именем, по умолчанию совпадающим с именем библиотеки. 

О загрузке изображений в файл ресурсов см. разд. 4.1.2. В ресурсы биб- 
лиотеки МиурГ.Г., рассмотренной в предыдущих разделах, включено два изо- 
бражения с именами "ВОЕГРНГ'` и “"ВЕАВТН". На диске, приложенном к кни- 
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ге, вы найдете проект Тез ОГ.Г.3 в группе проектов РаМуШр Г.Г, который демон- 
стрирует использование изображений из ресурсов библиотеки. Приложение 
содержит (рис. 4.8) компонент ГПпайе1, в котором отображаются изображения 
и свойство Ащфо512е которого установлено в фгае, и две кнопки, загружающие 
в Ппайе1 то или иное изображение. 


Рис. 4.8 
Приложение, использующее изображения 
из ресурсов библиотеки 


Ниже приведен код этого приложения: 


ус1Аа _ ЁЕазса11 ТЕогш1: :Ви®оп1С11сК (ТОБР]есЕ *бепаекг) 
{ 


НАМРШЬЕ Н; 
Н = ГоааЪ1югаку ("Мур11.а11"); 
ТЕ (Н !=0) 


{ 
Тмаде1->Р1сеиге->В16тар->Напа1е = ГоааВ1% тар (Н, "ВОБЕБРНТ"); 


1Е(! Тмаде1->Р1скиге->В1емар->Напа1е) 

ЗВомМеззасве ("Изображение 'ВПРЕГРНТ' в библиотеке не найдено"); 
Ггеер1Югакгу(Н); 
} 


е1зе 5ромМеззасе ("Не удалось загрузить библиотеку"); 


ИИ----------а---н------------------------------------ 
\у0о1а __Еазса11 ТЕГогш1 : :Ви®оп2С11сК (ТОБ)есЕ *5епаек) 
| | 
НАМОТЕ Н; 

Н = Гоаа1Ьгаку ("Мур11.а11"); 

ЗЕ (Н !=О0) 


{ 
Тпаче1->Р1сфиге->В16тар->Напа1е = ГоааВ1%щар (Н, "ВЕАВТН"); 


1:(! Тмаде1->Р1сбиге->В1$птар->Напа1е) 

ЗромМеззасде ("Изображение 'ВЕАКТН' в библиотеке не найдено"); 
ГгееГ1ргагу(Н); 
} 


е15е 5помМеззаае ("Не удалось загрузить библиотеку"); 
} 


Оба обработчика щелчков на кнопках идентичны с точностью до имени за- 
гружаемого изображения. В начале функцией ГоааТаЬгагу, описанной 
в разд. 4.2.4, загружается модуль библиотеки. Затем функцией Гоа4В тар 
в компонент Пптабе] заносится дескриптор соответствующего изображения. 
Вторым аргументом в эту функцию передается имя загружаемого изображе- 
ния. Если дескриптор, возвращенный функцией ГоааВЁтар, равен МОТГ, 
пользователю выдается сообщение об отсутствии изображения в библиотеке. 
В заключение функцией ЕгееТлЬгагу библиотека выгружается из адресного 
пространства приложения. 
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Отметим, что аналогичным образом в файле ресурсов ОГ можно созда- 
вать и набор пиктограмм. Использоваться они могут тоже аналогично, только 
вместо функции Гоа4ВИтар надо использовать функцию Гоа4Гсоп. 


4.3 Ловушки сообщений \Л/тдо\/$ 


В разделах 2.3 и 2.4 рассмотрены способы управления клавиатурой и мы- 
шью, в частности, с помощью сообщений. Но имеется еще один универсаль- 
ный способ перехвата всех сообщений У!/114о\3 — построение ловушек (ВоокК). 
Ловушки, перехватывающие и обрабатывающие сообщения, имеются в самой 
системе. Но вы можете добавить свои ловушки, которые расположатся в нача- 
ле очереди системных ловушек. Тем самым вы сможете перехватывать сооб- 
щения \/1140\5$ и обрабатывать их по-своему. 

Ловушки могут быть локальными и распространять свое действие только 
на один поток. В этом случае они могут включаться в исполняемые файлы 
‚ехе. Но больший интерес представляют глобальные ловушки, отслеживающие 
сообщения всех потоков. Такие ловушки должны размещаться в РЕГ, подроб- 
но описанных в разд. 4.2. 

Сама ловушка реализуется в ОПГ функцией специального вида. В эту 
функцию поступает информация о перехваченном сообщении. Она может 
предпринять какие-то действия, связанные с этим сообщением. А может пере- 
дать эту информацию следующей ловушке в системной цепочке. 

В ОШ, должны быть предусмотрены также функции, устанавливающие 
и удаляющие ловушку. Функция установки вызывает функцию Зе \т@домз- 
НооКЕх, в которую передается информация о типе перехватываемых сообще- 
ний и о функции, реализующей ловушку. Функция удаления ловушки вызы- 
вает функцию Оппоок\тдом$НооКЕх, в которую передается информация 
о функции, реализующей удаляемую ловушку. Функции ОШЩ,, устанавливаю- 
щие и удаляющие ловушку, вызываются из какого-то внешнего приложения, 
управляющего ловушкой. 

Рассмотрим упомянутые функции установки и удаления ловушек. Регист- 
рация ловушки осуществляется функцией Зе \Ут@дом$НооКЕх. Она объявле- 
на в модуле И’1тОзег.й следующим образом: | 


ННООК бееМ1паом$зНоокКЕх (116 1АНоок, НООКРВОС Т1рЕп, 
НТМ5ТАМСЕ Пмоа, ПОИМОКО ачТргеаата); 


Параметр 14НооК задает тип регистрируемой ловушки. Он может прини- 
мать много различных значений, которые приведены в описании функции 
в гл. 8. Для. дальнейшего обсуждения нам понадобятся следующие 2 значения: 


\Н _КЕУВОАВО Ловушка сообщений клавиатуры. Представляется 
`В _виде функции КеуБоагаРгос. 


ЕЕ ЕоЬ ты: Е 


\Н_ МОП$Е | Ловушка сообщений мыши. Представляется 
9: виде функции _МоизеРгос. — 


Параметр ра функции Зе \т4ом$НоокЕх является указателем на 
функцию ловушки. Место реализации этой функции определяется парамет- 
ром 4м'ТИгеад 14. Этот параметр может указывать поток, для которого устанав- 
ливается ловушка, или может быть равен 0, что означает установку ловушки 
для всех потоков. Если параметр АмТЬгеа 41а равен 0 или указывает на поток 
процесса, отличного от текущего, тогда параметр 1рЁп должен указывать адрес 
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функции ловушки, помещенной в ОШЩ.. В этом случае параметр ВМо4 является 
дескриптором модуля ОШ,, содержащего ловушку. Если же параметр 4мТЬге- 
ааТ4 указывает на поток текущего процесса, то функция ловушки, на которую 
указывает рп, может размещаться в модуле исполняемого файла, связанном 
с этим процессом. 

Вызов функции Зе У т4дом$НооКЕх устанавливает (регистрирует) ловуш- 
ку. Удаление ранее зарегистрированной ловушки производится функцией Оп- 
Воок\пдом$НооКЕх, объявленной в файле ИУтИзег.й следующим образом: 


ВОО ОпроокКИ1паом$НоокКЕх (ННООК ВПК); 


В нее передается единственный аргумент ААА — указатель на функцию ло- 
вушки. 

Рассмотрим теперь одну из функций, реализующих ловушки — Кеуфоагд- 
Ргос. Эта функция, как было указано в описании параметра 1АНоок, обеспечи- 
вает перехват событий клавиатуры. В ней параметр со4е указывает способ об- 
работки поступившего сообщения. Если этот параметр неотрицательный, он 
может принимать следующие значения: | 


В этом случае параметры \уРагаш и 1Рагаш содержат сооб- 
щение о нажатой клавише. 


|НС_А АТОМ 


| — _ НИ 

ГН НС_МОВЕМОХЕ_ ‚В этом случае параметры \Рагат и 1Рагашт также содержат 
| 

| 


| ‹ сообщение о нажатой клавише, причем его нельзя удалять 
из системной очереди сообщений. 


|... == п ЕЕ ие 


Если значение со4е меньше нуля, функция не должна обрабатывать сооб- 
щение и должна вернуть значение, возвращенное функцией Са|Мех НооКЕх 
(см. ее описание в гл. 8). 

Параметр мРагашт является виртуальным кодом, генерируемым сообще- 
нием нажатой клавиши. Параметр 1Рагат дает дополнительную информацию. 
Биты значения этого параметра описывают: 


‘о 15. | Дают число повторений, вызванных тем, что пользователь удерживал 
| 
| клавишу нажатой. 


ОИ С. ОИ 
| Г. 

| 

‚16-23 Определяют зс зсап-код (см. разд. 2. 2.3). 

В ито т. Уна ` ЙЕ ытыиМмммыЫитттт т 
| 24 Значение 1 указывает на то, что это клавиша расширенной клавиату- 
| ‚ры (функциональная или клавиша дополнительной цифровой клавиа- 


туры). 


ИНО И ИИ ПИ 


‚25-28 |Пока не используются. 


|| И ПН 


29 ] Значение 1 указывает на то, что нажата клавиша АЁ. 


я Г 


‚30 Указывает состояние клавиши перед отправкой сообщения: 
1 — нажата, 0 — отпущена. 


ое УдФ—Ф— ыЫ— 


31 | Указывает, в какое состояние переходит клавиша: 0 — нажимается,. 
|1 — освобождается. 


Теперь рассмотрим функцию МоизерРгос, представляющую собой ловушку 
для событий мыши. В ней параметр со4е полностью аналогичен параметру пре- 
дыдущей функции. Параметр мРагат содержит идентификатор сообщения 


мыши (\М_МОЧЗЕМОУХЕ, \М_ТВОТТОМОР, \ММ_ВВОТТОМОР и т.п. — 
см. разд. 2.4.1). А параметр ШРагаш является указателем на структуру типа 
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МОПЗЕНООКЗТКОСТ. Имеется тип указателей на подобные структуры — 
РМоцизеНоок5#гисё. Структура типа МООЗЕНООК$ТВОСТ содержит следую- 


щие поля: 


Тип 


ИНН 
| Описание _ —__ И _1 


ТРошё _ | Структура. с координатами курсора х иу. 


\НЁТе$&Со4е |ОТМТ Определяет код, уточняющий положение курсора 


мыши относительно окна. | 


Н\УМО Дескриптор окна, которому предназначено сообщение. 


О. —_—__ —-.—- —-_- ——____ а Е 


амЕхгаш о _ У\ово Содержит дополнительную информацию, связанную 
| сообщением. _ 


Поле мНИТе${Со4е может иметь следующие значения, уточняющие поло- 
жение курсора мыши относительно окна: 


НТВОВКОЕК `В области бордюра окна с неизменяющимися размерами. | 
НТВОТТОМ `На нижней границе окна. _ 


НТВОТТОМЕЕРТ |В нижнем левом углу окна. — 
НТВОТТОМЕ/СНТ |В нижнем правом углу окна. —_ 
НТСАРТОМ 
НТОСШЕМТ 


В полосе заголовка. | 


В клиентской области. 


Вне окна или на линии, разделяющей два окна (то же, 
что НТМОМНЕКЕ.). _ 


На полосе, изменяющей размер окна (то же, что ть 


На горизонтальной полосе прокрутки. 
НТЕЕЕТ На левой границе е окна. 
НТМЕМО В полосе меню. 


| 
НТМОМНЕКЕ Вне окна или на линии, разделяющей два окна (то же, 
что НТЕВКОЕК)._ _ 


НТВЕРОСЕ На кнопке ‚ свертывания’ окна. 


НТАТСНТ На правой границе о окна. 


НТ$ТИЕ 
НТСВО\ВОХ). 


На кнопке системного меню или кнопке Закрыть дочерне- 


На верхней границе окна. 


 НТТОРЕЕЕТ 


И В верхнем левом ‘углу окна. ООО 
|НТТОРЫСНТ УЧИ О — 
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Мы рассмотрели две, наиболее часто требующиеся функции ловушек кла- 
виатуры и мыши. Не будем останавливаться на остальных функциях. Они по- 
хожи на рассмотренные, и вы можете посмотреть их в справке С++Ви!аег. 
А теперь построим демонстрационное тестовое приложение, чтобы стало по- 
нятнее, как можно устанавливать ловушки. Пусть, например, мы хотим, что- 
бы, работая с любой программой, пользователь мог нажать клавиши А!Х, 
и это означало бы намерение завершить выполнение приложения. Но предва- 
рительно пользователю был бы сделан запрос, действительно ли он хочет за- 
вершить приложение. И еще мы хотим, чтобы при перемещении курсора 
мыши над полосой заголовка любого окна раскрывалось бы меню кнопки Пуск. 
Конечно, оба наши желания достаточно странные, но они позволят наглядно 
представить перехват сообщений клавиатуры и мыши. 

Начнем с разработки РТ. (НоорКеу.АИЙ в каталоге Кеубоата на приложен- 
ном к книге диске), содержащей соответствующие ловушки. Методика созда- 
ния РЫ, подробно изложена в разд. 4.2.2. Ниже приведен код этой ОШ.. 


#1пс1оае "НооККеу.В" 


// дескрипторы ловушек 
ННООК НКеу = 0; 
ННООК НМоцзе = 0; 
‚/Х/ ловушка клавиатуры 
1пЕ __56аса11 Кеу НооККеу(1пе сое, 1пЕ мРагкам, 1пе 1Рагап) 
{ 
// если соае >= 0, то ловушка может обработать событие 
1Е (соае >= 0) 
| 
// если АЕИ "Х' 
1Е ((мРакам == 1108('Х')) && ((1Рагам & 0х20000000) != 0) && 
(((1Рахам & 0х40000000) != 0))) 
{ 
1Е (МеззадеВох (0, "Хотите закрыть приложение?", 
"Подтвердите окончание работы", 
МВ_ТСОМОДОЕЗТТОМ + МВ УЕЗМОСАМСЕТ + 
МВ ЗУЗТЕММОРАТ,) == ТРУЕЗ) 
резегоуй+паон (бекрогедгоипаи1 пдон () ); 
гесогп 1; 
} 


е1зе гебагпт 0; 


} 

е1зе 
//если соае<0, вызывается следующая ловушка 
гебагп Са11МехЕНооКкКЕх (НКеу, со4е, мРагам, 1Рагам); 


// ловушка мыши 
11 _ 56аса11 Кеу НооКМочзе (11 соае,1пЕ мРагам, 1пе 1Рагам) 
[ 
1Е ((соае >= 0) &&5 (мРагам == ММ МСМОЧ$ЗЕМОУЕ) && 
(РМоцзеНоокК$ЕгкасЕ (1Рагам) ->иН1%ТезеСоае == НТСАРТТОМ))} 
зепаМеззаде (СееКогедчгоцпаИ1птаои (), ИМ _$УЗСОММАМО, 
5С _ТАЗКЬТЬТ, 0); 
гесагп Са]11МехЕНоокКЕх (НМоизе, соае, мРагам, 1Рагапм); 


Уо1А ЗфакеКеу () 
// установка ловушки клавиатуры 
{ 
НКеу = 5ееМ1паом$НоокЕх (ИМН_КЕУВОАВО, 
(ИМРЕМОМРКОС) Кеу НооКкКеу, НТпзфапсе, 0); 
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1Е (НКеу == 0) 
Мез5адеВох (0, "Ловушка не установилась!", "Ошибка", МВ_ОК); 


Ууо1А КетоуеНооккКеу () 
// удаление ловушки клавиатуры 
{ 
1Е (НКеу != 0) 
{ 
ОпроокИ1паом$НоокКЕх (НКеу); 
НКеу= 0; 


\У01А 5$баг%ЕМочцзе () 
//‘установка ловушки мыши 


{ 
1Е (НМойзе == 0) 
НМоцзе = 5еМ1паомзНоокКЕх (ИН_ МОЧЕ, 
(ИМРЕМОМРВОС) Кеу НоокКМоцзе, НТпзвапсе, 0); 
1Е (НМойзе == 0) — 
МеззачеВох (0, "Ловушка не установилась!", "Ошибка", МВ_ОК); 


701А КетоуеНооКМоцзе () 
// удаление ловушки мыши 


{ 
1Е (НМодзе!=0) 


{ 
ОпбоокКИ1паомзНоокКЕх (НМоцзе); 


НМочзе = 0; 


106 МТМАРТ 211ЕпекуРо1пЕ (НТМОТАМСЕ Б1п$е, опз1тапеа 1опа геазоп, 
У01А* 1рБезегуея) 


{ 
1Е((геазоп == ОЫЬ ТНВЕАР РЕТАСН) || (геазоп == РЪЬ РВОСЕ$$ РЕТАСН)) 


// удаление ловушек 


{ 
1Е (НКеу!=0) 
ОпроокИ1паомзНоокКЕх (НКеу) ; 
1Е (НМопзе!=0) 
ОпроокКИ1паом$НоокКЕх (НМочзе); 
} 


геЕцгп ‘1; 


} 


Начнем анализ приведенного кода с рассмотрения функций ловушек. 
Функция Кеу_НоокККеу является ловушкой сообщений клавиатуры. В начале 
функции проверяется по значению со4е, имеет ли право ловушка обрабаты- 
вать данное сообщение. Далее проверяется, является ли нажатая клавиша 
клавишей символа "Х", и нажата ли в это время клавиша А|. Если все эти ус- 
ловия выполнены, то сообщение обрабатывается. В качестве возвращаемого 
значения задается 1, чтобы прервать обработку сообщения другими ловушка- 
ми. Затем пользователю задается вопрос, действительно ли он хочет закрыть 
приложение. При положительном ответе пользователя получается функцией 
Се Еогесгоппа \/ том дескриптор окна верхнего уровня и процедурой Оез- 
гоу М 11 дом это окно закрывается. 

Если нажаты не клавиши “Х" и А\, то в качестве возвращаемого значения 
задается 0, что обеспечит обработку сообщения другими ловушками. Если же 
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сообщение не подлежит обработке в данной функции, то вызывается функци- 
ей Са|ПМех НооЕЕх следующая ловушка. 

_ Функция Кеу_НоокМоцзе является ловушкой сообщений мыши. В ней про- 
веряется по значению параметра со4е, можно ли обрабатывать сообщение. Далее 
по значению параметра мРагат проверяется, перемещается ли курсор мыши вне 
клиентской области окна. Затем по значению поля мНЁТе$Соде записи, на ко- 
торую указывает ШРагат, проверяется, находится ли курсор в полосе заголовка 
окна. Если все эти условия выполнены, то окну, дескриптор которого возвраща- 
ется функцией Се Еогеггоип9 Я том, посылается сообщение \УМ_5ЗУЗСОМ- 
МАМО с параметром ЭС_ТАЗКТЛ$Т (см. об этом сообщении в разд. 1.7). 

Процедуры Зфаг{Кеу и ЗфагМоцзе проводят функцией Зе \Утдом$Ноок- 
Ех установку соответствующих ловушек и возвращают в переменные НКеу 
и НМоц$е их дескрипторы. Эти дескрипторы использовались, в частности, 
в вызовах функции Са|ЙМех{НооКЕх в описанных выше функциях ловушек. 

Процедуры ВетоуеНоокКеу и КешоуеНоокМоцзе удаляют функциями 
Опвоок\тдомзНоокЕх соответствующие ловушки. Переменным НКеу 
и НМоц$е задаются нулевые значения. 

Приложение, использующее данную ОТГ.Т,, может зарегистрировать ловуш- 
ки, и не удалить их. Поэтому, на всякий случай, надо предусмотреть удаление 
ловушек при выгрузке ОГ из памяти. Чтобы обеспечить это, в конце кода 
файла реализации предусмотрена функция ОПЕвёгуРош+. Она подробно опи- 
сана в разд. 4.2.2. Поскольку эта функция выполняется как при загрузке, так 
и при завершении работы с ОШ, то ее можно использовать для снятия лову- 
шек. Первым оператором Ш отсекается выполнение этой функции при входе 
и обеспечивается обработка при выходе. Обработка сводится к тому, что сни- 
маются установленные ранее ловушки клавиатуры и мыши. 

В заголовочном файле библиотеки НооЁКеу.Й перечислены экспортируе- 
мые функции. Приведем текст данного файла: 


#12паеЁЕ _ОНОТКЕУ Н 
#АеР1пе  ОНОТКЕУ Н 


#1Е4её ры _ 

#фаеЁ1пе ОГ ЕТ _ аес1зрес (411ехрог®) | 
#е1зе 

+аеЕ1пе РЬГ ЕГ _ аес1зрес (а11ехрог®) 
фепатЕ 


ехфегп "С" уо1а ОЬЬ ЕГ беагёКеу(); 

ехфегп "С" уо1а РЫБ ЕТ ВетоуеНооККеу(); 
ехеегп "С" уо1а РЫЬ ЕТ З6аг&Моизе(); — 
ехфегп "С" уо1а О ЕТ ВетоуеНооКМочзе (); 


+ерат Е 


Откомпилируйте созданную ОШ.. Теперь давайте построим приложение, 
управляющее ловушками (проект РНооЕКеу группы проектов РСОНоой в ката- 
логе Кеубоата на приложенном к книге диске). На форме этого проекта 
(см. рис. 4.9) размещены две кнопки Зрее4ВиЦоп. В обеих установлено в фгае 
свойство А1омАПОр. Свойство СгоипрШФех в первой кнопке задано равным 1, 
а во второй равным 2. Это обеспечивает независимое включение и выключение 
обеих кнопок. 
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Рис. 4.9 = Ловушки кяавйа 


Приложение, управляющее ловушками _ |. В любом приложении ловушка 
‘(клавиатуры перехватывает клавиши 
А!-Х, а ловушка мыши - 
‚ перемещение над заголовком окна 


Ловушка клавиатуры 
Ловушка мыши 


Ниже приведен код этого приложения. 
#1пс10ае "НооККеу.В" 


у01А _ Еаз®са11 ТКогм1: :ГогиСТозе (ТОБ]ес® *5епаег) 
{ 

ВетоуеНоокКкКеу (); 

ВетоуеНооКМоцзе (); 


} 
у014 __Еаз®са11 ТЕоги1 : : $брееаВое+оп1С11ск (ТОБЗесь *бепаег) 


1Е (брее4ЯВиЕоп1->Ромп) 
Зсаг%еКеу (); 
е1зе ВетоуеНоокККеу (); 


Уу01А __ЁЕаз®са11 ТГогм]1: : Зрее4Вие оп2С11сК (ТОБ)]ес® *5епаег) 
{ 
1Е (ЗрееаВиоп2->Помп) 
ЗсагЕМочзе (); 
е]1зе ВКетоуеНооКМоцзе (); 


} 


Подключение файла НооЁКеу.Й обеспечивает статическое связывание биб- 
лиотеки (см. разд. 4.2.3) и доступ к ее процедурам. Не забудьте при этом подклю- 
чить к модулю файд .[б, как описывалось в разд. 4.2.3. Процедура РЕогтС1озе 
является обработчиком события Оп(С]о5е формы. В ней вызываются процедуры 
ОШ, ВетоуеНоокКеу и ВетоуеНоокМоицзе, удаляющие ловушки. А процедуры 
Зрее4ВиНоп1СПсК и Зреед4ВиКоп2СПеК являются обработчиками щелчков на 
кнопках. В зависимости от состояния кнопок они создают или уничтожают ло- 


вушки. 


4.4 Информация о ресурсах, импорте и экспорте 
исполняемых файлов 


4.4.1 Поиск изображений и пиктограмм в ресурсах 


ВАРТЕ \/114о\$ имеется функция ЕпатВезопгсеМате$, позволяющая по- 
лучить список имен ресурсов указанного типа, содержащихся в ресурсе любо- 
го исполняемого модуля, в частности, ОШ... В файле И тфазе.й эта функция 
объявлена следующим образом: 
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ВОО ЕпимВезоцгсематез$ (ТМ НМОРОТЕ ИМоац]1е, ТМ ЬРСЗТВ 1ртТуре, 
ТМ ЕМОМВЕЗМАМЕРКОСА 1рЕпоапРапс, 
ТМ ОМС _РТВ 1Рагам); 


Параметр ВМодше является дескриптором модуля, ресурсы которого исследу- 
ются. Параметр 1рТуре является строкой, указывающей тип исследуемых ресур- 
сов. В частности, этот параметр может принимать значения следующих констант: 

ВТ_ВТГМАР ресурсы ВМР 


ВТ_СВООР_ТСОМ ресурсы аппаратнонезависимых пиктограмм 


ВТ Т<СОМ ресурсы аппаратнозависимых пиктограмм 


Остальные возможные значения посмотрите в справке АРТ \У1тао\з. 

Параметр 1рЕпитЕипе определяет адрес функции, которая реагирует на 
каждое найденное значение ресурса. Параметр ГШРагат может определять ка- 
кой-то дополнительный параметр, передаваемый в функцию 1рЕпишЕипс. 

Функция ЕпатВезопгсеМате$ работает так. Если в файле ресурсов ис- 
полняемого модуля имеются ресурсы типа, указанного параметром 1рТуре, то 
для каждого такого ресурса вызывается функция, адрес которой указан пара- 
метром 1рЕпитГЕипс. Эта функция должна иметь заголовок вида: 


ВОО САБЬВАСК МуЕпоапВезМамеРгос (НАМОЬЕ ПМоао1е, ТРСТЗТВ 1рТуре, 
.РТЗТВ р52Мапше, ТОМс 1Рагам); 


В функцию автоматически передаются параметры ВМодще, 1рТуре, 1Ра- 
гат, указанные аргументами при вызове ЕпитВезопгсеМате$. Кроме того, 
передается параметр р52Мате — строка с именем ресурса. Функция МуЕпит- 
ВБезМатеРгос может как-то обработать полученную информацию. Если требу- 
ется продолжать исследование ресурсов данного типа, то функция МуЕпит- 
ВБезМатеРгос должна вернуть фгие. Если функция вернет #а1$е, цикл вызовов 
этой функции, инициированный функцией ЕпитВезоигсееМатез$, прервется. 

Рассмотрим пример, вид формы которого приведен на рис. 4.10, вы найдете на 
приложенном к книге диске (проект [пзрест в каталоге ОГ.Г,). Приложение содер- 
жит одну кнопку, вызывающую стандартный диалог открытия файла. Если 
пользователь выбрал в диалоге исполняемый файл, то в выпадающие списки 
СошфоВох1 и СошфоВох2 загружаются соответственно имена ресурсов ВМР и пик- 
тограмм, содержащихся в файле. Если такие ресурсы нашлись, пользователь мо- 
жет посмотреть их, выбирая имя ресурса в выпадающем списке. На рис. 4.10 изо- 
бражен момент исследования ОШ, МурГГ, описанной в предыдущих разделах. 


Рис. 4.10 .-” Изображения из ресурсов 
Приложение, исследующее 
графические ресурсы 
исполняемых модулей 


Изображения - Пиктограммы 


ЕСЕЕРН! ы [МАМСОМ >| 
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Ниже приведен код этого приложения: 
НАМОТЕ Н =М0ЬЬ; 


1пЕ __$564са11 МуЕпимВезМамеРгос (НАМОЬЕ ПМо4а1е, РСраг 1рТуре, 
РСТаг р52Мате, ОМС 1Рагапм) 


{ 


1Е (1рТуре == ВТ ВТТМАР) 
Гоги1->СопроВох1->Т$етз->АЧа (р52Мапе)}; 
е1зе 1Е ((1рТуре == ВТ_СВОЧР ТСОМ) || (1рТуре == ВТ _ТСОМ)) 


Рогп1->СопроВох2->Т+епз->ААа (рз;Маме); 
гебатп Егае; 


Уу01А __Еаз®са11 ТГогм1: : Ви 6оп1С11сК (ТОБ)есЕ *5епаег) 


{ 
1Е (Орепр1а1оа1->Ехесифе ()) 


Н = ГоааГ1Ьгаку (Орепр1а1091->Е11еМаме.с_$5т()); 
тЕ (Н !=0) 


Таре11->СарЕ1оп = "Файл " + Орепр1а1о91->Е11еМапе; 
Тпаче1->Р1сбаге->В16тар->Напа1е = №11; 
Тпаче1->Р1сфаге->Тсоп->Напа1е = №11; 
СопроВох1->С1еахт(); 

ЕпошВезоигсематез (Н, ВКТ _ВТТМАР, 

(ИМРЕМОМРКОС) МуЕпопВезМатеРгос, 0); 
СопроВох1->Т$ещТпаех = 0; 

СопроВох2->С1еагк(); 
ЕпииВезоогсематез$ (Н, ВТ СКОЧР_ТСОМ, 

(ИМРЕМОМРВОС) МуЕпопВКезМапеРгос, 0); 
ЕпииВезоцгсеМмате$ (Н, ВТ ТСОМ, (ММРЕМОМРКВОС)МуЕпииВезМамеРгос, 0); 
СопроВох2->ТепТпаех = 0; 

Егеер1Ьгагу(Н); 


у01А __Еаз®©са11 ТГогш1 : : СопроВох1С1озе0р (ТОБ]есе *5епаег) 
{ 
Н = Гоаа11Ъгаку (Орепр1а1091->Е11еМаме.с_$6г()); 
ТЕ (Н !=0) 
{ 
Тпаде1->Р1сеаге->В16пар->Напа1е = 
ТоааВ1* мар (Н, СопроВох1->Техе.с_$&г.()); 
ЕгееГ1ргагу(Н); 
} 


е1зе 5ВомМеззасде ("Не удалось загрузить изображение"); 


у01А _ Еаз®са11 ТКогш1 : : СошроВох2С1о5е0р (ТОБ)есе *5епаег) 


{ 
Н = Гоаар1Юкгагу (Орепр1а1о091->Е11еМаме.с_$56т()); 


1Е (Н !=О0) 


{ 
Тиаде1->Р1сбиге->Тсоп->Напа1е = Гоа@аТсоп (Н, СопроВох2->Техе.с_з%г()); 


ЕгееЪ1Ъгагу(Н); 
} 


е1зе ЗПомМеззаае ("Не удалось загрузить изображение"); 
} 
Функция МуЕпатВезМатеРгосе — это та самая функция, к которой 
в цикле следуют обращения для каждого элемента ресурсов. В этой функции . 
анализируется тип ресурса 1рТуре, и имена ресурсов ВМР заносятся в список 
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СошБоВох1, а имена пиктограмм — в список СотфоВох2. Функция всегда воз- 
вращает фгие, так что происходит просмотр всех ресурсов. 

Процедура ВиНоп1СПеК является обработчиком щелчка на кнопке. Про- 
цедура вызывает диалог открытия файла и загружает функцией ГоаЯТлЬгагу 
выбранный пользователем модуль. Далее удаляется изображение из Птаге1, 
очищаются выпадающие списки СошфоВох, и производится вызов Епит- 
КезоигсеМате$ для различных типов ресурсов. В заключение загруженный 
модуль выгружается из памяти функцией ЕгееГгагу. 

‚ Обработчики щелчков на выпадающих списках СотфбоВох сводятся 
к тому, что функциями Гоа4ВЁтар или Гоа ЧТсоп выбранный пользователем 
ресурс загружается в Ппайе1. 

О получении пиктограмм из файлов см. также в разд. 5.4. 


4.4.2 Получение информации об импорте и экспорте 
исполняемого модуля 


В ряде случаев требуется определить, какие ОР, и пакеты времени выпол- 
нения (а это тоже П,) использует тот или иной исполняемый модуль. Напри- 
мер, если вы создали проект с поддержкой пакетов времени выполнения, то 
вам надо знать, какие пакеты вы должны передать пользователю одновремен- 
но со своим исполняемым модулем. Даже если вап! модуль не использует паке- 
ты времени выполнения, он наверняка использует какие-то ОГ.Г,; даже если вы 
их явным образом не вызываете. Не забывайте, что ваш код — только неболь- 
шая часть того, что включает С++Воа4ег в любое приложение \!т4о\з. Так 
что в любом случае полезно знать, какие ОТ, должны быть у пользователя, 
чтобы ваше приложение нормально работало на его компьютере. 

Иногда также требуется узнать, что именно экспортирует ОШ.. Подобная 
задача возникает при использовании ОТ., разработанных не вами. 

Все эти задачи могут быть решены с помощью программы {4итр.ехе, кото- 
рая поставляется вместе с С++Ви!аег и располагается в каталоге Вт. Это про- 
грамма МБ РОБ, так что удобнее всего запускать ее из ОЗ, М№ооп Сот- 
шап4ег, \Мшаомз Соштапаег и т.п. При запуске надо указать в командной 
строке имя файла исследуемого исполняемого модуля. Для облегчения анали- 
за результатов полезно также направить выходной текст в какой-нибудь тек- 
стовый файл. Например, если вы хотите получить сведения о той ОГ, МирЁГ, 
которую разработали в предыдущих разделах, можно выполнить команду: 


саитр МУРЬЬ.а11 > авпр. хе 


В результате вы получите текстовый файл дитр.1хф, содержащий инфор- 
мацию о МирГ.Г..АЦ. В частности, там будут строки вида: 
Тпроге$ Егом КЕВМЕГЗ2.ОЬЬ 


Егеер1Югагу 
сеЕСоптап а 1пеА 


Тпроге$ Егом ССЗ260МТ.ОЬЬ 
орегафког ае1ефе (\уота *) 
_Тп16ТегпАпаОпехРЕгз () 


Это сообщения о ПТЛ,, которые используются вашим файлом и которые 
должны иметься у пользователя. Для каждой ОШ, указываются экспортируе- 
мые ею функции, которые используются в исследуемом исполняемом модуле. 
Впрочем, в данном случае никакой экзотики нет — все используемые библио- 
теки входят в стандартную поставку \ш94о\мз. 
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х 


< 


Найдете вы также раздел: 


Ехрогез Егом тшуа11.а11 
7 ехрог®е@а папе ($), 7 ехрогЕ ааагеззе ($). Ога1па1 разе 1$ 1. 
богсеа ру Мате: 


КУА 


Ога. 


Н1пЕ Мапе 


00002180 
00002170 
00001988 
000019АС 
000035А4 
00001848 
000030Е8 


0000 _ 11пКргос _ Чтмуа1а1о9: :Е1па112е 
0001 _ 11пКргос _ Чтуа1а1оч: : Тп161а112е 
0002 Соае | 

0003 _ПоВеер 

0004 КГогп2 


0005 _Мур1а1оа 
0006 СРРАаебоаНоок 


Это перечень экспортируемых функций. В данном случае вы и сами знае- 
те, что именно экспортируете из своей ОГ, помимо некоторых служебных 
функций. Но при работе с ОШЬ, которую вы не создавали сами, такой перечень 
экспортируемых функций может быть полезен. Впрочем, в разд. 4.2.5 описана 
утилита ппрае], которая позволяет получить перечень функций, экспортируе- 
мых из ОШЬ, в более компактном и обозримом виде. 


Окна и графика 


5.1 Управление окнами 


5.1.1 Управление окнами форм с помощью их дескрипторов 


Обычно на компьютере в любой момент открыто множество окон форм раз- 
личных приложений. Каждое окно формы в свою очередь. обычно содержит 
окна размещенных в нем оконных компонентов: панелей, окон редактирова- 
ния ит.ип. 

Доступ к любым окнам может осуществляться через их дескрипторы. 
У каждого оконного компонента имеется свойство Нап @е. Это свойство явля- 
ется дескриптором окна. Позднее мы увидим, как можно получить дескриптор 
любого окна, открытого в данный момент в Ут ао\мз. Но пока для тестирова- 
ния рассмотренных далее функций приведу оператор, который определяет де- 
скриптор стандартной программы \т4о\з Калькулятор: 


НИМР Б\па = Е1лпаМ1паом ("5с1Са1с", "Калькулятор"); 


Если Калькулятор в данный момент выполняется на компьютере, то приве- 
денный оператор запишет в переменную В\У/п4 дескриптор окна этой програм- 
мы. Если же нет уверенности, что Калькулятор выполняется, имеет смысл за- 
менить приведенный оператор следующим кодом: 

Нимо Вита; 


1Е(! (П\па = Етпам1паом ("5с1Са1с","Калькулятор") )) 


{ 
И1пЕхес ("Са1с", $5М ЗНОИММА); 
П\па = Е1тпаЙ1тпаом ("5с1Са1с", "Калькулятор"); 


} 


Если Калькулятор в данный момент не выполняется, то функция Еша\т- 
до\ возвращает нуль. В этом случае Калькулятор вызывается функцией \Ут- 
Ехес, после чего в переменную В\/п4@ заносится требуемый дескриптор. 

Приведенных операторов достаточно, чтобы вы могли тестировать рас- 
смотренные далее функции. Но если вы хотите выбрать для тестирования не 
программу Калькулятор, а, например, С++Ви!Паег, то дескриптор можете оп- 
ределить оператором: 


НИга = Е1паАМ1паом ("ТАррВи11аег", МОЪт,) ; 


Далее мы рассмотрим ряд функций, позволяющих управлять окном, за- 
данным его дескриптором. Но, конечно, самое гибкое управление осуществля- 
ется посылкой окну сообщений \Ишаомз функцией ЗепаМеззарге: 


ЪВЕЗОГТ бепаМеззасде (ТМ НИМР ВБИпа, тм ОТМТ Мзда, 
ТМ МРАКАМ "Рахат, ТМ ГРАКАМ 1]Рагап); 


Параметр М$7 указывает тип посылаемого сообщения, а параметры мРа- 
гат и 1Рагат — соответствующие параметры сообщения. В последующих раз- 
делах эта функция будет постоянно использоваться. 
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Зная дескриптор, можно получить доступ к некоторым характеристикам 
окна. Функция де У т4омТех& позволяет получить текст окна. Функция объ- 
явлена следующим образом: 


116 сбее\1паомТехе (ТМ НИМР Б\па, одт ЬРЗТВ 1р5Ег1пад, 
ТМ 10Е пМахСооп®); 


Параметр В\/п4 задает дескриптор окна, параметр 1р5#гте является ука- 
зателем на буфер, в котрый функция заносит текст, а параметр пМахСопп& оп- 
ределяет размер этого буфера. Если текст превышает указанный размер, он 
усекается. При успешном завершении функция заносит в буфер текст и воз- 
вращает число занесенных символов, не учитывая завершающего нулевого 
символа. Под текстом окна подразумевается или текст заголовка для окон 
форм, или текст окна редактирования, или имя панели и т.п. Если окно не 
имеет текста, или текст пустой, или указан ошибочный дескриптор, функция 
возвращает нуль. 

Например, если вы записали в переменную В\У’п@ дескриптор какого-то 
окна, то следующий код отобразит в метке ГаБе|1 его текст: 

сраг БаЁ[ 256]; 

Ссееи1птпаомТехеЕ (Пипа, БаЕ, з1т2еоЕ (РаЕЁ)); 

Таре11->СарЕ1оп = РоЕЁ; 

Если дескриптор В\/’п4 относится к окну какой-то формы (например, получен 
приведенным ранее оператором для программы Калькулятор), то в метке отобра- 
зится текст заголовка окна. А если дескриптор получен, например, оператором 


НИМ БИпа = Еа161->Напа1е; 


то в метке отобразится текст соответствующего окна редактирования. 
Перед использованием функции де \У/Лт@домТехё можно вызвать функцию 
Сег\’тдомТех еп И: 


1пе СееМ1паомТехЕЪепаей (ТМ НИМО В\па)}; 


Эта функция возвращает в случае успешного выполнения число символов 
текста, которое можно использовать для выделения буфера достаточного раз- 
мера перед вызовом функции Се У шдомТехё. 

Функция Зе \т4домТехё: 


ВООТ 5ееИ1паомТех® (ТМ НИМ Мпа, тм ЬРСЗТВ 1р5ег1па); 


позволяет изменить текст окна. Например: 


беЕИ1паомТехЕ (ПИпа, "Это мой текст"); 


Функции Се \Ут9домТех{ё и Зе У т4о\мТехё иногда не дают ожидаемого 
вами результата, поскольку для некоторых окон редактирования (например, 
для Мето, а иногда и для ЕЙ) понятия текст окна и действительное содержи- 
мое окна могут различаться. Поэтому, если вам требуется получить или изме- 
нить именно содержимое окна, то лучше использовать сообщения \У/11940о\з 
\ММ_СЕТТЕХТ и \М_СЕТТЕХТ соответственно. Тогда в приведенных выше 
примерах вызов функции Се \т4омТех& можно заменить оператором 


бепаМе$зачде (ПИпа, ММ СЕТТЕХТ, $12еоЕЁ(раЕ), (ТРАВАМ) (ГРСТЗТВ)рчЕ); 


а вызов функции Зе Ут4омТех& можно заменить оператором 


ЗепЯМеззасде (ПИпа, ММ 5ЕТТЕХТ, 0, (ЪРАВАМ) (ЪРСТЗТВ) "Это мой текст"); 
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Первый из приведенных операторов занесет в буфер Би текст окна, а вто- 
рой — запишет в окно строку: "Это мой текст”. 

Для окон редактирования, включая окна Мето и ВасВЕЗЦ, сообщения 
У\/М_СЕТТЕХТ и \УМ_ЗЕТТЕХТ работают с полными текстами окон, пока их 
размер не превышает 64 К. Для текстов большего размера в окнах ВасВЕЧЦ 
надо использовать сообщения ЕМ_СЕТЗЕГТЕХТ, ЕМ_$ТВЕАМООТ, ЕМ_ 
ЗТВЕАМИУ. В выпадающих списках сообщения \УМ_СЕТТЕХТ и \ММ_ЗЕТ- 
ТЕХТ работают с текстом в окне редактирования списка. В кнопках — с над- 
писями на кнопках. 


Имеются функции Се\УтдомР]1асетеп{ и Зе \Ут4домР]асетепф, кото- 
рые позволяют соответственно получить и установить характеристики, опре- 
деляющие местоположение окна формы. Они объявлены следующим образом: 

ВОО СеЕ\й1паомР1асетепе (ТМ НММО В\па, 

О0Т ИТМРОИРЬАСЕМЕМТ *1рипар1); 


ВООЬ Зе\1паомР1асемев* (ТМ НИМО Б\па, 
ТМ СОМ5Т ИТМРОИРЬАСЕМЕМТ *1рипар1); 


Параметр 1рмп@ар! является указателем на структуру типа ‚ УМПМООМ- 
РГАСЕМЕМТ: 
БуреаеЕ зЕекгасЕ фадИТМРОИРЬАСЕМЕМТ { 
ОТМТ Терпдеёй; 
ОТМТ Е1ад93; 
ОТМТ зромСпа; 
РОТМТ РЕМ1пРоз1Е1оп; 
РОТМТ рЕМахРо$1Е1оп; 
ВЕСТ гсМ№огта1Ро$1Е1оп; 
#епа1Е 
} ИТМООИРТАСЕМЕМТ; 


суредеЕ ИТМРОМРТАСЕМЕМТ *РИТМРОИРГАСЕМЕМТ, *ТГРИТМРОМРЪАСЕМЕМТ; 


Поле 1еп 28 содержит размер структуры в байтах. Так что перед вызовом 
описываемых функций значение этого поля надо задать равным $12ео (\УТ\- 
РО\РГАСЕМЕМТ). Поле Йа5$ при вызове функции бе У т4омР]асетеп{ 
всегда равно нулю, а при вызове функции Зе \1т4омР]асетеп{ задает фла- 
ги, определяющие положение окна в свернутом виде и метод его последующе- 
го восстановления. Данное поле может содержать один или два следующих 
флага: 


тт 


ма ВЕЗТОКЕТО- Флаг указывает, что после восстановления окно дол- | 
| | МАХТМТЯЕО | `жно быть развернуто, независимо от того, в каком 

‚ состоянии оно было до свертывания. Установка этого 

Флага влияет только в случае, если окно свернуто 

`(зВо\Сша = $\_ЗНОММИУМТГИЕО), и только на 

одно очередное восстановление. Флаг не изменяет 

‘поведение окна при последующих восстановлениях. | 

| 

| 

| 

| 

| 


Е м——— —— —_—_- 


——— 
' \УРЕ_5ЕТМТМРОЗГТОМ | Флаг указывает, что координаты свернутого окна 
Могут быть заданы полем риМатРов вов. _ 


Поле $ВомСт@ показывает или устанавливает состояние окна. Чаще всего 
используются значения 53\_$5НОМ/МОВМАТГ или 5\М_КЕЗТОВЕ — окно ак- 
тивизируется и восстанавливается в своей нормальной позиции и нормальных 
размерах, 5М_НТЕ — окно делается невидимым, 5\М_МИМ1ТМТАЕ — окно 
свертывается. Другие возможные значения см. в гл. 8 в описании функций. 
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При вызове функции де \У/т@домР]асетеп{ поле звомСт@ может прини- 
мать только значения 5З\_ЗНОММАХТМТАЕО — развернутое состояние, 
9 \_5НО\М’МТМТМТАЕО — свернутое, 53\_5НОМ/МОВМАТ, — нормальное. 

Поля р МшРоз1 оп, рЕМахРо51оп и геМогта Роз 1 оп определяют коор- 
динаты левого верхнего окна соответственно в свернутом, развернутом и нор- 
мальном состоянии. 

При успешном завершении функции де \шт4омР]асетеп{ и Зе \ш@до\- 
Р]асетеп{ возвращают ненулевое значение, в случае ошибки — 0. 

Приведу пример использования рассмотренных функций. Пример чисто де- 
монстрационный. Следующий код обеспечит изменение положения левой гра- 
ницы окна программы Калькулятор, что приведет к изменению его ширины: 

НИМО ВИ\па = Е1зпай\1паом ("5с1Са1с", "Калькулятор"); 

ИТМРОИРЬАСЕМЕМТ ИР; 

ИР.1епаЕВ = з12еоЕ (ИТМРОИРЬАСЕМЕМТ) ; 

СесИ1паомР1асемеп* (ВИпа, &МР); 

Рог (10 1=0; 1 <= 100; 1++) 

Ро ЕСМохта1РОВНЕ оп. 168% += 1; 

ЗеЕИ1паомР]1асемептЕ (П\Ипа, &МР); 

} 


В этом примере изменяется положение только левой границы окна. Если 
же заменить оператор, задающий значение поля геМогта Роз11оп, оператором: 
ИР. гсМогма1Роз1Е1оп = Вес (ИР. гсМогма1Роз1Е1оп.1еЕЕ + 1, 
ИР. хсМогма1Ро$1&1оп.бор, 


ИР. гсмогма1Ро$1%1о0оп.г1аВе + 1, 
ИР. хсМогма1Ро$1Е1оп.БоЕЕом); 


то будет осуществляться сдвиг окна без изменения его размера. 
Управлять состоянием окна можно, задавая значение поля зВомСта. Напри- 
мер, если перед вызовом функции Зеё \УтдомР1асетеп{ выполнить оператор 


ИР.зВомСмЯ = 5М_ 5НОИМТМТМТАЕО; 


то окно свернется. 

Функция Зе \УтдомР]асетепё позволяет одновременно изменять не- 
сколько характеристик окна. Для изменения только состояния окна удобнее 
использовать функцию ЭВом \У/шдом: 


ВОО ЗВомИМ1паом (ТМ НИМО В\па, тм 1п6е пСпабвом); 


Параметр пСта$Во\м может принимать те же значения, что и описанное 
ранее поле звомСт@ структуры УТПМРОМУРГАСЕМЕМТ. Правда, определено 
еще одно значение — З\М_5ЭНОМОЕЕАОТ.Т, означающее состояние по умол- 
чанию, заданное структурой ЭТАВКТОРИМЕО, использованной в функции 
СгежфеРгосе$$ при создании процесса, связанного с данным окном. 

Например, свернуть окно можно оператором: 


ЗВомм1паом (В\па, $И ЗНОИМТМТМТРЕР); 
Как видите, это намного проще, чем использование функции Зе том Р1а- 
сетепф, требующее предварительного объявления и заполнения структуры 


\ТМРО\МРГАСЕМЕМТ. Впрочем, еще проще для свертывания окна восполь- 
зоваться функцией Созе\/т9о\м: _ 


С1озеЙ1тпаом (ВИпа); 


Перемещать окно тоже удобнее не функцией Зе \Ут@домР]асетепф, 
а функцией Моуе М1 дом: 
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ВООГ Моуей1паом (ТМ НИМО Р\Мпа, ТМ 1106 Х, ТМ 1106 У, 
ТМ 10 питаер, ТМ 1рЕ пНезоаре, 
ТМ ВООЬ ЬЮВера1пЕ); 


Параметры Х, У, ПУ, пУ14 определяют соответственно координаты 
левого верхнего угла, длину и ширину окна. Параметр БВераштф определяет, 
перерисовывается ли окно во время перемещения: при значении фгие перери- 
совывается. 

Текущее положение и размер окна можно получить функцией де \М/т9ом- 
Весё: 


ВООЬ Сее\1паомВес® (ТМ НИМОЬ Б\па, оЧтТ ЬРВЕСТ 1рВес®); 


Ниже приведен пример совместного применения функций бегу шдом- 
Вес и Моуе\У/т94о\м для сдвига окна: 
ВЕСТ В; 
Сее\1паомВесЕ* (ВИпа, &8В); 
Рог (10 1=0; 1 <= 100; 1++) 
Моуе\1паом (В\па, В.1еЕЕ + 1, В.кор, В.глапе - К.1еЕф, 
В.роебом - В.бор, Егае); 


Функция Че Саз5Маше позволяет определить класс окна: 


106 СееС1аз$Мате (ТМ НМУМР Ю\па,ОЧТ ЪРЗТКВ 1рС1а$55Маме, 
ТМ 106 пМахСооп®); 


Функция заносит в буфер 1р а$$Маше размера пМахСоипё имя класса 
и возвращает число занесенных символов, или 0, если произошла ошибка. 
Если окно создано в С++Ви!дег, то класс окна — это соответствующий класс 
С+-+Ви!аег. Если же это программа, которая создавалась не в С++ВиПаег, то 
имена классов будут иными. 


5.1.2 Дочерние окна, управление «чужим» приложением 


Некоторые из окон \У/ш949о\мз являются дочерними — т.е. помещаются 
в клиентской области другого, родительского окна. Это, прежде всего, окна до- 
черних компонентов, помещенных на формах. Но могут существовать и окна 
вторичных форм приложения, для которых в их свойстве Рагеп{ указана в ка- 
честве родительского компонента другая форма. Если известен дескриптор не- 
которого окна, то получить дескриптор его родительского окна можно функ- 
цией Се Рагепё: 


НИМО СесРагеп® (ТМ НММО Мира); 


Функция возвращает дескриптор окна, родительского по отношению к окну 
с дескриптором В \/па. Если родительского окна нет, возвращается МО. Так 
что если, например, объявить следующие переменные В\пч4 и Н: 


НУМО В\Мра, Н; 


и присвоить переменной В\/п4 дескриптор какого-то окна, то добраться до ро- 
дительского окна можно оператором: 


\р11е(Н = СееРагеп+ (В\па)) Вира = Н; 


Если окно с дескриптором В\па не имеет родительского окна, приведенный 
цикл не сработает ни разу. А если родительское окно имеется, то в результате 
выполнения цикла в переменную В \У/пА будет занесен дескриптор самого верх- 
него окна в этой иерархии. Можете опробовать функцию @е&Рагепф, поместив, 
например, на свою форму панель, на панель окно ЕЦ, и выполнив код: 
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‘сраг раЕ[256]; 
НИМО РИ\ра = Еа11->Напа1е, Н; 


имрз1е(Н = СеЕРагерЕ (ПИпа)) Випя = Н; 


Сееи1паомТехЕ (Пипа, БаЕ, з1хеоЕ (роаЕ)); 
Таре11->Сар®1оп = БыЕЁ; 


В результате в метке Габе!1 отобразится текст заголовка окна вашей формы. 


Окна, не имеющие родительского окна, называются окнами верхнего 
уровня (ор-|еуе!). Функция Се Рагепф возвращает для них МОШ.. Но если 
окно не имеет родительского, это еще не значит, что данное окно является 
главным окном своего приложения. Приложение может открывать множество 
самостоятельных окон, среди которых одно — злавное. Нередко требуется оп- 
ределить, к какому приложению относится  оЧали иное окно. Приложение 
обычно является владельцем (омптег) своих вторичных окон. Определить вла- 
дельца окна можно функцией Се \т9ом, в которую в качестве первого аргу- 
мента передается дескриптор окна, а в качестве второго аргумента записывает- 
ся костанта С\_ОМ/МЕЩ. Так что, имея дескриптор В\У/п@ какого-то окна, 
можно получить информацию об этом окне и его владельце, например, сле- 
дующим кодом: 

саг ЮаЁ[ 256], БЕ? [256], ЬаЕЗ[256]; 

сеЕ\й1паомТехЕ (НИпа, БаЕ, з17еоЕ (БаЕ)); 

СеЕС1аззМаме (Н\па, Бо Е2 , з17ео0Е (БаЕ2) 

НИМО Н = бек\1паом (НИпа, сИ_ОММЕВ); 

сеЕ\и1паомТехЕ (Н, БоЕЗ, з127е90Е (БаЕЗ)); 

Гоги1->Тафе11->СарЕ1оп = "окно " + Апз15егапа (роЕЁ) + 


", класс " + Ап$1бЕглпа (БаЕ2) + 
", приложение " + Апз15Ег1па (раЕЗ)); 


у 


); 


Описанные функции позволяют перемещаться вверх по иерархии окон. 
Теперь посмотрим, как можно перемещаться по иерархии вниз. Перебрать все 
дочерние окна некоторого родительского окна можно с помощью функции 
ЕпоишСЬПа\/т9доу5: 

ВОО ЕпапСр11А\1паом$ (ТМ НИМО Ю\ИраРатепвь, 


ТМ ИМРЕМОМРВКОС 1рЕпопРапс, 
ТМ ГРАВАМ 1Рагам); 


Эта функция перебирает все дочерние окна того окна, дескриптор которого 
_ задан параметром В\У/паРагеп+. Найдя дескриптор очередного дочернего окна, 
функция посылает его в качестве первого параметра в написанную пользовате- 
лем функцию обработки — так называемую функцию обратного вызова 
(саПЬасКк Рапс@ оп). Адрес этой пользовательской функции указывается пара- 
метром 1ШрЕпитЕипс. Третий параметр 1ШРагат функции ЕпатСЬИа\/1т190\5$ 
передается в качестве второго параметра в пользовательскую функцию. Его 
пользователь может использовать по своему усмотрению. Пользовательская 
функция должна принимать два параметра: дескриптор родительского окна 
и переданный в нее параметр 1Рагат. Она должна возвращать фгие, если тре- 
буется продолжение перебора, или #а]5е, если перебор следует остановить. 
В С++ВоШаег такая функция с двумя параметрами в вызове 
ЕпошСЬПЧ\/1140о\м5 должна приводиться явным образом к типу 
\ММРЕМОМРКОС. 

Рассмотрим пример. Пусть в вашем приложении имеется окно Мето], и вы 
хотите занести в Мето1 список всех дочерних оконных компонентов какого-то 
окна с указанием их классов. Например, вы хотите получить список дочерних 
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компонентов окна программы Калькулятор. Подобное приложение вы найдете 
на приложенном к книге диске в каталоге САИаУ”7та в проекте СРИа\Ита1. 
Окно этого приложения приведено на рис. 5.1 а. Чтобы можно было сопоставить 
результат с окном программы Калькулятор, на рис. 5.1 6 приведено окно этой 
программы. 


Е] | - Список дочернин окон и меню Калькулятой т =101Х)| 6) Е Калькулятор _. 
Правка Вид Справка 


и 


Спысок оконных компонентов — Список разделов меню 


‚ - класс Е ЧК «Правка 
&Копировать — СИ+С 
Вст&авить Си 
Мб - класс ВиКоп &Вид 
М+ - класс Вицоп Обычный 
- класс Вицюй &Инженерный 
4 - класс Вицоп | 
- класс Вицоп Количество цифр в группе 
- класс Виюп ` Справка 
- класс Виком Вызов справки 


- класс Виюй 
- класс Вибюп &0 программе 


. - класс Вицоп 
# - класс ВиКом 
* - класс Вицоп 
- - класс ВиЦцоп 
+ - класс Вицоп 


Рис. 5.1. Приложение (а), формирующее список дочерних окон и меню окна программы 
Калькулятор (6) 


Ниже приведен код, обеспечивающий получение списка дочерних окон 
(левая часть рис. 5.1 а). | 
сваг ЮуЕ[256], БоЕ?2 [256]; 


роо1 _ з&4са11 ЕпимСЬ11а(НИМО БМ1па, ЪРАВАМ 1Рагап) 
{ 


‚/И/ Функция обратного вызова 
бепаМеззаде (ВИ1па, ММ СЕТТЕХТ, $12еоЕ(раЕЁ), (ТРАКАМ) (РСТЗТК) БоЕ); 
СеесС1аззМаме (ВИ1па, БаЕ2 , з12еоЕ (БоЕ?2)); 
Гогм1 ->Мето1->Ъ1пе$->АЯа (Апз15Ег1па (БаЕЁ) + 
" - класс " + Ап5$15еглра (РаЕ2)); 


гесагпрп фгае; 


Инн ннннанянннннннннннннн=-======================- 
Уу01А __Газ®са11 ТГогм1: :ГогиСгеаее (ТОБ)ес® *5епаег) 

{ 

НИМО Б\ра; 

// получение дескриптора окна 

1Е(! (ПМпа = Е1лпа\1паом ("5с1Са1с", "Калькулятор"))) 


{ 
И1пЕхес ("Са1с", $М ЗНОММА); 


Б\рпа = Е1паМ1паом ("5с1Са1с", "Калькулятор"); 


} 
// получение списка дочерних окна 
. ЕпомСЬ11А\1паом$ (Мпа, (ИМРЕМОМРВОС) ЕпотСрЬ11а, 0); 


} 


Функция ЕпишСИП@Я — это функция обратного вызова, обрабатывающая 
передаваемый в нее дескриптор дочернего окна ВУ 14. Сначала с помощью со- 
общения \М_СЕТТЕХТ в буфер Бай заносится текст окна. Затем функцией 
СеСа$Маште в буфер Би?2 заносится имя класса окна. Строка, содержащая 
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текст окна и имя класса записывается в окно Мето1. В заключение функция 
возвращает фгие, что обеспечивает продолжение перебора дочерних окон. Если 
бы нам надо было не перебирать все окна, а найти окно с каким-то заданным. 
текстом, то, получив дескриптор такого окна, мы могли бы вернуть #а[5е. То- 
гда дальнейший перебор прекратился бы. 

Функция ЕогтСгеж{е является обработчиком события ОпСгеа&ёе формы. 
Первые операторы этой функции определяют дескриптор окна Калькулятора. 
Эти операторы были рассмотрены в разд. 5.1.1. А последний из приведенных 
операторов вызывает функцию ЕпишСВПЯ\ т94ом5. Первым ее параметром 
указан найденный дескриптор окна Калькулятора. В качестве второго пара- 
метра указано имя описанной выше функции обратного вызова ЕпатСЬИ@. 
Тип этой функции явным образом приводится к типу УМРЕМОМРВОС, кото- 
рый предусмотрен описанием функции ЕпишСИПа\1т40о\$. Последний пара- 
метр задан равным нулю. После того как функция ЕпашСЬПа\/1140о\$ вызва- 
на, она перебирает все дочерние компоненты и для каждого вызывает функ- 
цию ЕпишСВПОА. 

В данном примере последний аргумент в вызове Епап1СЬИЯ\/ т 94о\5 равен 
нулю. Но в качестве этого параметра можно было бы указать какую-то допол- 
нительную информацию, которую надо передать в функцию ЕпашСЬИЯ. 
Пусть, например, задача заключается не в том, чтобы перебрать все дочерние 
окна, а в том, чтобы найти окно с заданным текстом или окно заданного клас- 
са. Например, вам надо найти окно редактора, которое, как можно видеть на 
рис. 5.1 а, имеет класс ЕЁ. Эту задачу можно было бы решить так. Ввести ' 
глобальные переменные: 

Апз15Еглпа $5 = "Еа1е"; 

НИМО ЪЕЯ:е; 


В функции РГЕогтСгеже заменить вызов ЕпатСЬПЯМ/1140\$ следующим опе- 
ратором: 


ЕпомСЬ11А\1паомз$ (Мпа, (ИМРЕМОМРКОС)ЕпопСЬ11аАа, (ТРАВКВАМ) &5); 


В качестве последнего аргумента в ЕпатСЬПа\/1140о\$ передается адрес стро- 
ки, в которой записано имя класса искомого окна. Адрес явным образом при- 
водится к типу ГРАВАМ. В функцию ЕпатСЬИА перед заключительным опе- 
ратором надо вставить код: | 
ТЕ (Ап$156к1па (БаЕ2) == * (Ап5156г1па *)1Рагам) 
РЕЯ = БМ:па; 
гесагп Еа]15е; 


} 


Если класс окна совпадает с заданным, то в глобальную переменную ВЕЗЁ 
передается дескриптор этого окна, и функция возвращает Ё#а]5е, прерывая 
дальнейший перебор окон. 

Мы рассмотрели получение дескрипторов всех дочерних окон. Далее, если 
требуется, можно посылать этим окнам сообщения У/1т94о\з, и таким образом 
управлять кнопками и окнами внешнего приложения. Немного позже мы рас- 
смотрим подобный пример. Но для полного контроля над внешним приложе- 
нием надо еще получить доступ к его меню. Дескриптор полосы главного меню 
окна возвращает функция вбеМепи: 


НМЕМО СееМепа (ТМ НИМР Вита); 
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Единственный аргумент, передаваемый в эту функцию — дескриптор окна 
Ь\’пд. Например, следующий оператор вернет дескриптор главного меню 
окна, заданного его дескриптором В\’па: 


НМЕМО ЮМепа = СеЕМепа (па); 


Определив дескриптор меню, можно узнать число его разделов (выпадаю- 
щих меню) функцией Се МепиЦетСоцпЕ: 


10Е СеЕеМепоаТептСоцп* (ТМ НМЕМО №Мепа); 


Функция бе МепиИте позволяет получить тексты разделов: 


116 сбееМепи$&г1п9 (ТМ НМЕМО ВМеро, ТМ ОТ\МТ атогГем, 
ООТ БРЗТК 1р5ег1па, 1М 1пЕ пМахСочпеь, 
ТМ ОТМТ оЕ1ад); 


Параметр ВМепи является дескриптором меню. Параметры реше 
‘и пМахСоппё определяют соответственно буфер, в который будет записан 
текст, и его размер. Параметры иГОЦет и иаЕ1ай определяют раздел, текст ко- 
торого надо найти. Если и ай = МЕ ВУРОЗПТОМ, то аГОЦеш — позиция 
раздела. Первый раздел имеет позицию 0, второй — 1 и т.д. Если иЕае = 
МЕ_ВУСОММАМЮ, то иГОЦет — команда. Подобный варианты обращения 
к разделу меню вы можете увидеть в разд. 5.2.1. Но для нашей задачи он не го- 
дится. Функция деМепи те возвращает число символов, скопированных 
в буфер, или 0 в случае ошибки. 

Надо отметить, что рассмотренная функция бе Мепи{гте сейчас счита- 
ется устаревшей. Вместо нее рекомендуется использовать функцию @е- 
МепиЦет Шо: 


ВОО сеЕМепаТ$епТпЕо (ТМ НМЕМО ВМепа, ТМ ОТМТ ащепт, 
ТМ ВООГ ЕВуРоз11оп, 
ТМ ООТ ГРМЕМОТТЕМТМЕО 1рм11); 


Параметр иЦет эквивалентен иШЦет в функции бе Мепи{гте. Пара- 


метр #{ВуРо$1оп должен равняться фгие, если аЦет указывает позицию раз-` 


дела. А параметр |1рши является указателем на структуру типа МЕМО- 
ТТЕМУ.УЕО, в которую записывается информация о разделе. Эта структура со- 
держит не только текст раздела, но и множество другой информации. Она под- 
робно описана в гл. 8. Но в наших примерах нам не будет требоваться ничего, 
кроме текста раздела. Так что для простоты будем далее использовать функ- 
‘цию се Мепиишр. 

Функция Се Зи Мепи позволяет получить дескриптор выпадающего меню: 


НМЕМО сбеебаЮМепа (ТМ НМЕМО ЮМепи, ТМ 11е пРо$); 


Параметр пРо$ указывает позицию раздела, который соответствует выпадаю- 
щему меню. Если в данном разделе выпадающего меню нет, возвращается 0. 
Теперь мы можем реализовать вторую часть приложения СПАИАа\та1Т, 
обеспечивающую отображение в окне Мето2 (справа на рис. 5.1 6) состав 
меню программы Калькулятор. Приведенный ниже код записан в функции 
ЕогтСгеа{е вместо многоточия, которое было в приведенном ранее листинге. 
// получение списка разделов меню 
НМЕМО НМ = сеЕМепа (В\а); 
НМЕМО ЗМ = МОБ; 


10 СоипЕМ СсеЕМепаТеепСочпЕ (НМ); 
116 СочпЕ$; 


_ 
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Бог (106 1 = 0; 1 < СоапЕМ; 1++) 

{ 

СеЕМепа5&г1п9 (НМ, 1, БаЕ, $12еоЕЁ(раЕЁ), МЕ ВУРОЗТТТОМ); 
Мепо2->11пез->Ааа (БаЕЁ); | 

1Е(ЗаБМ = СбеббаЬМепа (НМ, 1))} 


{ 
Соцпе5 = СеЕеМепаТвепСовп® (баЬМ); 
Бог (106 К = 0; К < СоппЕ5; К++) 
{ 
СеЕМепа$г1па (5аЪ6М, К, БаЁ, з12еоЕЁ(роаЁ), МЕ ВУРОЗТТТОМ); 
Мепо2->Г1пез->Ааа (" " + Апз15СкЕтпа (БаЕ)); 
} 
} 
} 


Вряд ли этот код требует особых комментариев. В нем сначала определяет- 
ся функцией Се Мепи дескриптор главного меню НМ. В переменную Соиф М 
записывается число разделов меню, полученное функцией Се МепоЦет- 
Соппф. Затем следует цикл по разделам. Функция Че Мепи т? дает текст 
раздела. Функция де Зи Мепи проверяет, имеется ли в разделе выпадающее 
меню. Если имеется, то его дескриптор заносится в переменную Зи БМ, и орга- 
низуется цикл по разделам выпадающего меню. | | 

Теперь мы умеем получать доступ ко всем дочерним компонентам окна и 
к разделам его меню. Так что можно получить полный контроль над окном 
внешнего приложения. В качестве примера рассмотрим проект СРИа\” та, ко- 
торый имеется на приложенном к книге диске в каталоге СРИа\У та. Окно ' 
приложения показано на рис. 5.2 а. В левом списке 11$ Вох1 перечислены все 
разделы меню программы Калькулятор, а в правом списке 11$Вох2 перечис- 
лены кнопки этой программы. Заполнение этих списков производится автома- 
тически. Более того, поскольку программа Калькулятор может работать 
в двух режимах — обычный вид и инженерный (рис. 5.2 6), то при переключе- 
нии режима автоматически изменяются списки меню и кнопок. В списке кно- 
пок, как вы можете видеть, имеются не только обычные кнопки, но и радио- 
кнопки (`Градусы”, "Радианы” и др.), а также индикаторы (“Шу”). 

° Двойной щелчок на любой строке списков эквивалентен щелчку на соответ- 
ствующей кнопке Калькулятора или на соответствующем разделе меню. Текст, 
появляющийся при этом в окне Калькулятора, читается в окно ЕЗИ1 вверху 
формы приложения. А цифры, вводимые в окно редактирования приложения, 
автоматически передаются в окно калькулятора. Таким образом, из окна при- 
ложения можно выполнять любые действия, доступные калькулятору. 


\ 
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Рис. 5.2 6 6) Е Калькулятор 
Приложение (а), полностью Правка Вид Справка 
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Ниже приведен код этого приложения. 


ТЬ1зЕ *МЬ15Е = пем Т11$%; 
ТЬ1$& *ВГ156 = пем Т11$%; 
НИМР БИпа, РЕч1е; 

сраг РаЕ[256]; 


роо1 _ $&аса11 ЕпимСр11а (НИМ РИпа, ГРАКАМ 1Рагап) 
{ 
НИМО *Р; 
сраг БаЕ2 [256]; 
СееС1аззМаме (В\1па, БаЕ2, $1теоЕ (БоЕ2)); 
1Е (Ап$з156г1па (раЕ2) == "Вабеоп") 
{ 
ЗепаМеззасве (В\1па, ИМ СЕТТЕХТ, $17еоЕ (БаЁ), (ГРАКАМ) (ГРСТЗТВ)БаЕЁ); 
1Е(БаЕЁ[0] !=О0) 
{ 


Р = (НИУМО *)та11ос (з17еоЕ (НИМО)); 

*Р = ИВИи1па; 

ВЬ1$5Е->Ааа (Р); 

Роги1->115$Вох2->ТЕепз->Ааа (БоаЕЁ); 
} 


} 

е1зе 1Е (Апз15Егапа (БаЕ2) == "ЕЧ1е") 

| 
ВЕа1е = ЮМ1па; 
бЗепаМеззачде (№Еч1%*, ММ СЕТТЕХТ, 512еоЕ (раЕ), (ТРАКАМ) (ГРСТЗТК) рчЕЁ); 
ЕРоги1->Еа1+1->ТехЕ = БаЕЁ; | 

.} 


гебагтп Фгае; 


\01А _ Еаз®са11 ТРогм1: : РогаСгеафе (ТОр]ес®е *5епаег) 
{ 

1Е(! (ПИпа = Е1пай1паом ("5с1Са1с","Калькулятор") )) 

{ 

И1пЕхес ("Са1с", $М ЗНОММА); 

ВИпа = Е1па\1паом ("5с1Са1с", "Калькулятор"); 

} 

НМЕМО НМ = сбееМепа (В\па); 

НМЕМО $а6М = №11; 

106 СочпЕМ = бееМепаТеетмСочпЕ (НМ); 

1106 СочцпЕ5; 

ОТМТ *Р; 
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сраг *%; 

// очистка списков 

Бог (106 1 = 0; 1 < М15Е->СоапЕ; 1++) 

Егее (М15%->Теепмз[1]); 
Рог (10 1 = 0; 1 < В115$%Е->СодрЕ; 1++) 
Егее (В115%->Теепз [1]); 

МГ1$зе->С1еаг(); 

ВЬ1$Е->С1еаг(); 

Т1$ЕВох1->С1еаг(); 

Ъ1зЕВох2->С1еах ():; 

// получение списка разделов меню 

Рог (106 1 = 0; 1 < СоапЕ М; 1++)_ 

{ 

1Е (5арМ = беббаЬМепа (НМ, 1)) 
{ 
СоцпЕ5 = беЕМепаТЕепСоспЕ (5а6М);. 

Рог (10 К = 0; К < Сочп 5$; К++) 

{ . 
СесМепи5® г1па (5аЮм, К, РаЕЁ, з12еоЕ(раЕ), МЕ ВУРОЗТТТОМ); 
1Е(БаЕ[0] !=О0) 

{ 
Р = (ОТМТ *)па11ос ($51хеоЕ (ОТМТ)); 
*Р = СеЕМепатТЕештр (5За6м, К); 
МТ1$Е->Ааа (Р); 
// удаление амперсанда 
1Е(Е = зЕегсрхт (раЕ, '&')) 
{ 
*Е = 0; 
5Егсаф (БаЕ, & + 1); 
} 

// удаление указания горячих клавиш 
1Е(Е = зеусрк (раЕ, '\8')) *Е = 0; 
1$5ЕВох1->Твемз->Ааа (раЕ); 

} 
} 
} 
} 
// получение списка дочерних компонентов 
ЕпопСр11АМ1паом$ (ПИпа, (ММОЕМОМРВОС) ЕпипСЬ11а, 0); 


уо1Аа __ЁРаз®са11 ТЕГоги1: :1$56Вох10Ю1С11сК (ТОБ)есЕ *5епаег) 
{ 
// имитация щелчка на разделе меню 
ЗепаМеззааде (п\п, ИМ СОММАМЬО, 
* (ОТМТ *) М1 $56 ->Т6ем$ [11$ЕВох1->Т6епшТпаех], 0); 
1Е( (11$5ЕВох1->Т6ем$->56г1па$ [№1$6Вох1->ТкетТпаех] == "Инженерный") || 
(115ЕВох1->Т%6ем$->5Ег1па$ [115ЕВох1->Т6епшТпаех] == "Обычный")) 
// обновление списков разделов меню и кнопок 
ЕогиСгеаее (5епаег); 


} 


уо1А _ Еазеса11 ТГогм1 : :.15ЕВох20Ю1С11сК (ТОБ]есЕ *5бепаег) 
{ 
// имитация щелчка на кнопке 
бепЧМеззасе (* (НИМО *)В1156->ТЕемз [115$ЕВох2->Т6Ееш!1паех], 
ИМ _ЬВОТТОМРОимМ, 0, 0); 
ЗепЯМеззаче (* (НИМО *) ВТ15Е->ТЕепм$ [Т1$ЕВох2->ТЕеп{Тпаех], 
ИМ ТВОТТОМОР, 0, 0); 
бепаМеззаче (ВЕч1е, ИМ СЕТТЕХТ, 512еоЕ (раЕЁ), 
(ТТРАВАМ) (ГРСТЗУТВ)БаЕЁ); 
Еа11->ТехЕ = БаЕ; 
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зепаМеззаче (1Еч1е, ММ 5ЕТТЕХТ, 0, 
(ТРАКАМ) (ГРСТЗТВ) Еа11->Техе.с_з6г()); 


Уу01А _ Еазеса11 ТГоги1: : Рогирезе гоу (ТОБ)есЕ *5епаег) 
{ 
Рог (106 1 = 0; 1 < М15Е->СоцпЕ; 1++) 
Егее (МГ15Е->Т$епз[1]); 
Яе1еее М!Г15$%; 
Рог (106 1 = 0; 1 < В115Е->СоорЕ; 1++) 
Егее (Вт1$%->Теепм$ [1]); 
Че1еке В11$%; 
} 


Рассмотрим приведенный код. Глобальные переменные МГ1$% и В11$& — 
списки типа 'Т11$$, в которых будут храниться соответственно идентификато- 
ры разделов меню и дескрипторы кнопок. Переменные В\’п4 и ВЕ предна- 
значены для хранения дескрипторов окна формы и окна редактирования. 

Функция ЕпишСЬИЯ является функцией обратного вызова при переборе 
дочерних окон. Если окно имеет класс ВиЙоп, то с помощью сообщения 
\М_СЕТТЕХТ читается его текст. Если строка текста не пустая, то функцией 
штаПос выделяется память для хранения дескриптора окна. Указатель на это 
место памяти заносится в список В14$$, а текст заносится в список 11$&Вох2. 
Для окна класса ЕЯ выполняются другие операции: дескриптор сохраняется 
в переменной ВЕ?\, а текст читается и заносится в окно Е9Ц1 приложения. 

Функция ГогтСгеаже является обработчиком события ОпСгеа&е формы. 
Эта же функция вызывается, как вы увидите далее, при необходимости обно- 
вить списки разделов меню и кнопок. В начале функции, как уже не раз рас- 
сматривалось, производится определение дескриптора окна Калькулятора. 
Затем производится очистка списков. В частности, освобождается память, от- 
веденная под хранение всех объектов, на которые указывают элементы спи- 
сков МГ $$ и В $. Конечно, в первый момент при запуске приложения это не 
требуется и не производится, если списки пустые. Но при повторных вызовах 
этой функции освобождать память необходимо. | 

Затем следует уже рассмотренный ранее перебор разделов меню. При этом 
проверяется, имеется ли текст в очередном разделе. Это позволяет исключить 
включение в списки разделителей, которые имеются в меню. 

Для последующего обращения к разделу меню трёбуется знать его иденти- 
фикатор. Этот идентификатор может быть получен функцией Се МепиЦет1 О: 


ОТМТ беЕМепаТеептр (ТМ НМЕМО БМепрао, ТМ 1106 пРо$); 


Параметр ВМепа является дескриптором меню, а параметр пРо$ указыва- 
ет позицию раздела в этом меню. Возвращаемый этой функцией идентифика- 
тор каждого раздела, имеющего текст, помещается в динамически распреде- 
ляемую память, а указатель на него добавляется в список МТа$%. Из текста 
раздела удаляется символ амперсанда, а также обрезается конец строки, начи- 
нающийся с символа табуляции и содержащий указание горячих клавиш. От- 
редактированный текст заносится в список 11$ Вох1. После формирования 
списков разделов меню вызывается функция ЕпотСВПЯ\М”т4о\м$, обеспечи- 
вающая совместно с рассмотренной ранее функцией ЕпитСЬ!@ формирование 
списков кнопок. | 
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Функция 1[1%Вох1ЫСИсК является обработчиком двойного щелчка на 
строке списка 115$ Вох1{. Сначала разделу меню, текст которого находится 
в выделенной строке списка 11$ Вох1, посылается сообщение ММ_СОМ- 
МАМ. Это сообщение направляется разделу меню, указанному идентифика- 
тором, и вызывает выполнение команды, связанной с разделом. Указатель на 
идентификатор раздела меню извлекается из списка МГа$ по индексу [4$$- 
Вох1—>Цет шд4ех, поскольку индексы списков М $$ и 11$ Вох1 согласованы 
друг с другом. Этот указатель приводится к типу указателя на МТ и разыме- 
новывается. После отправки сообщения проверяется, не является ли раздел 
разделом Инженерный или Обычный. Дело в том, что при выборе этих разделов 
вид окна Калькулятора изменяется (см. рис. 5.1 би5.2 6). Соответственно ме- 
няется и состав меню, и состав кнопок. Значит, надо обновить все списки. Для 
этого вызывается описанная ранее функция ЕогтСтгеафе. 

Функция [11$ Вох2 ОЫСПеК является обработчиком двойного щелчка на 
строке списка [1$%Вох2. Дескриптор кнопки, выделенной в списке 11$Вох2, 
определяется примерно так же, как описано выше при определении идентифи- 
катора раздела меню. Кнопке посылаются сообщения УМ_ТГВОТТОМРОМ/М 
и \"М_ТВОТТОМОР, вызывающие нажатие и отпускание кнопки. Затем окну 
редактирования программы Калькулятор посылается сообщение \УМ_СЕТ- 
ТЕХТ, чтобы прочитать текст окна, изменившийся после срабатывания кноп- 
ки. Этот текст заносится в окно ЕЯЁ1 приложения. 

Функция ЕЧЦ1СПВапее является обработчиком события ОпСВапре окна 
ЕЧЕТ. С помощью сообщения \УМ_ЗЕТТЕХТ текст этого окна пересылается 
в окно редактирования программы Калькулятор. Функция ЕогтОе$фёгоу яв- 
ляется обработчиком события Оп)ез& гоу формы. Эта функция очищает па- 
мять, выделенную ранее под списки М1$6 и В14$%. 

Описанное приложение можно, конечно, усовершенствовать. Вместо спи- 
сков $Вох1 и [1$&Вох2 было бы удобнее создавать в приложении автомати- 
чески соответствующие меню и кнопки. Все выглядело бы красивее. Но я не 
стал усложнять код, чтобы было более понятно основное — получение списков 
меню и кнопок и управление с их помощью внешним приложением. 

Надо также отметить, что созданное приложение ориентировано на управ- 
ление программой Калькулятор, но в действительности является универсаль- 
ным. Достаточно изменить в функции ЕогтСгезж{е вызов ЕшАа\/Л1т9о\,, и мож- 
но управлять любым внешним приложением. Так что если вы решите развить 
это приложение, то укажу на некоторые его недостатки, которые можно доста- 
точно легко устранить. При работе с меню предполагается, что все разделы 
главного меню являются головными разделами выпадающих меню. Если это 
может быть не так, то нетрудно добавить раздел е]5$е к оператору И(Зи БМ = 
Сео Мепи(НМ, 1)), в котором занести в списки соответствующий раздел 
главного меню. В приложении полагается также, что все разделы выпадаю- 
щих меню связаны с конкретными командами, а не являются в свою очередь 
головными разделами других выпадающих меню. Устранить этот недостаток. 
можно, добавив в поиск разделов еще один вложенный цикл по разделам та- 
ких каскадных меню, если они обнаружатся. | 

Еще одним недостатком, сужающим возможности описанного приложе- 
ния, является то, что в нем окно, для которого производится поиск дочерних 
компонентов, предполагается окном формы. Если приложение содержит не- 
сколько окон, то надо добавить еще циклы по этим окнам. Думаю, что если по- 
добная задача у вас возникнет, то сказанного в данном разделе будет достаточ- 
но, чтобы вы с нею справились. 
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5.1.3 Перебор окон верхнего уровня, 
свертывание окон всех приложений 


Получить дескриптор любого окна можно функцией Гита \У/т@о\, которая 
имеет вид: 


НИМО Е1паМ1паом (сопзЕ сБаг *1рС1аззМате, 
соп$ сраг *]1р\1паомМапе); 


Параметр 1р 1аз5Мате указывает на строку, содержащую имя класса. Па- 
раметр 1р\Ут4омМате указывает на строку, содержащую имя окна. Если 
этот параметр равен МОТ, то считается, что под критерий поиска подходит 
любое окно указанного класса. Если поиск прошел успешно, то функция воз- 
вращает дескриптор окна, имеющего указанное имя класса и имя окна. В про- 
тивном случае возвращается МО... 

Эту функцию легко использовать, если вы знаете имя класса искомого 
окна. В предыдущих разделах она уже не раз использовалась для получения 
дескриптора окна программы Калькулятор. При этом указывалось имя клас- 
са этого окна — $е1Сас. Откуда можно получить имя этого класса? 

Одна из возможностей узнать имя класса какого-то приложения — вос- 
пользоваться поставляемой вместе с С++ВаПАаег программой Утяейт 32 
(файл ...\Вт\ишз32.ехе). Запустите интересующее вас приложение, затем запус- 
тите \!11$1214 32, выполните команду Зру | Нпа \/тдом, и вы увидите список 
всех окон, зарегистрированных в данный момент в У\Уп94о\з. Лучше, чтобы 
в этот момент у вас было бы открыто не очень много окон, чтобы проще было 
найти среди них нужное. 

В списке, который вы увидите, для каждого окна будут указаны среди 
прочей информации имя класса в фигурных скобках "{ }" и заголовок окна — 
последний элемент данных в строке каждого окна. Например, запустив “Каль- 
кулятор , вы можете с помощью И? 5111 32 найти, что имя класса окна этого 
приложения — "5охСа(". 

_ Другой способ найти дескриптор окна — воспользоваться функцией @(е{- 
Мех \/тдом: 


НИУМО СееМехеИ1паом (ВИпа Ю\па, ипз1апеа 1пеЕ мСпа); 


Она определяет дескриптор следующего или предыдущего окна в /-последо- 
вательности. Параметр В\У/п@ — дескриптор окна, от которого начинается отсчет. 
Параметр “Ст определяет направление поиска. Если мСш@4 = @М_НУМО- 
МЕХТ, то ищется следующее окно, находящееся ниже. Если \“Ст@а = 
С\У’_НУ’МОРВКЕУТХ, то ищется предыдущее окно, находящееся выше. 

Следующее окно в 7-последовательности — это то, которое вызывалось из 
указанного или к которому пользователь обращался после создания указанно- 
го окна. Если указано дочернее окно, то поиск ведется среди дочерних окон. 

Если искомое окно найдено, то возвращается его дескриптор. Если сле- 
дующего или предыдущего окна нет (в зависимости от значения мСт9), то воз- 
вращается 0. ` 

С помощью этой функции можно решить задачу определения дескриптора 
окна выполняемого приложения, например, программы Калькулятор. Ниже 
приведен соответствующий код: 

НИМО Н =Напа1е; 

спаг РсВ [128]; 

ао 

{ 
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Н = СесМехе\М1таом (Н, СИ _НИМОМЕХТ); 

СеЕ\И1паомТехе (Н,Рср, 128); 

1Е( ! СопрагеТех® (Рсв, "Калькулятор") ) 
Бгеак; 

} мр11е (Н != М№0Гр); 

1Е (Н != МОБ) 


Первый выполняемый оператор присваивает переменной Н значение свой- 
ства Нап Ме формы вашего приложения. Далее в цикле просматриваются 
окна, лежащие ниже в 7-последовательности, и среди них ищется окно с тек- 
стом “Калькулятор”. Для этого используется функция СотрагеТехф, сравни- 
вающая без учета регистра строку, на которую указывает Рей, со строкой 
"Калькулятор". Если строки совпадают, функция СошрагеТех& возвращает нуль, 
и цикл просмотра прерывается. 

Окно Калькулятора будет найдено, если оно получало фокус после запус- 
ка вашего приложения. Если цикл завершается со значением Н = МОТ, зна- 
чит приложение Калькулятор в данный момент не открыто. 

Рассмотренная функция Че Мех{ \Ут9дом, как мы видели, позволяет орга- 
низовать перебор окон. Однако для этих целей более удобна функция Епит- 
\!114о\$, объявленная в файле Итизег.Й следующим образом: 


ВООГ ЕпитИ1паом$ (ТМ ИМРЕМОМРКОС 1рЕпомГипс, ТМ ТРАКАМ 1Рагапм); 


Функция перебирает все окна верхнего уровня (см. 06 этом понятии 
в разд. 5.1.2) и поочередно посылает их дескрипторы в качестве первого пара- 
метра в написанную пользователем функцию обратного вызова. Адрес этой 
пользовательской функции указывается параметром 1рЕпитЕипе. Второй па- 
раметр Рагат функции Епат \1т9о\5$ передается в качестве второго пара- 
метра в пользовательскую функцию. Его пользователь может использовать по 
своему усмотрению. Пользовательская функция должна принимать два пара- 
метра: дескриптор родительского окна и переданный в нее параметр 1Рагат. 
Она должна возвращать фтае, если требуется продолжение перебора, или #а1зе, 
если перебор следует остановить. С подобной функцией вы уже встречались 
в разд. 5.1.2. Напомню, что в С+-+Виа!аег такая функция с двумя параметрами 
в вызове Епат \ 11 4о\$ должна приводиться явным образом к типу \УМОЕ- 
МОМРКОС. 

Предположим, вы хотите по щелчку на кнопке ВиЙоп1 вашего приложе- 
ния получить в окне Мепо]1 список всех окон верхнего уровня, открытых 
в данный момент в \!!тдо\з. Это можно сделать следующим кодом. 


роо1 _ $Еаса11 ЕпомРгос1 (НИМО М1пНапа1е, 1опа Рагап ) 


{ 

сраг БоЕ[256], БаЕ? [256]; 

СеЕИ1паомТехЕ (И1пНапа1е, БаЕ, з12еоЕ (БаЕ)); 

СсеесС1аз$Маме (М1пНапа1е, раЕ2, з1хеоЕ (раЕ2)) 

Гоги] ->Мето1->1пез->Ааа (Апз15Ег1па (БаЕ) 
Ап$15 гла па (раЕ2} 


; 
+ " - класс " + 
) 


Га 


хебиагпр Егхае; 


у01А _ ЁЕазеса11 ТЕогп1: :Вие6оп1С11сК (ТОБ]есе *5бепаег) 
[ | 


ЕпамИ1тпаАом$ ( (ИМРЕМОМРЕОС) ЕпамРгос1, 0); 
} 
Если перед вами стоит иная задача — свернуть окна всех приложений, от- 
крытых в данный момент, то в приведенном коде функции ЕпитРгос1 можно 
все операторы, предшествующие оператору гефиги, заменить одним оператором: 
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Ро5&Меззачде (И1пНапа1е, ММ 5У$СОММАМО, $С_МТМТМТаЕ, 0); 


Этот оператор посылает всем окнам сообщение \УМ_5ЗУЗСОММАМО с па- 
раметром 5С_МТМТМТАЕ — свернуться (см. подробнее смысл этого сообщения 
в разд. 5.2.1). 

В приведенном варианте кода сообщение о свертывании посылается всем 
окнам верхнего уровня без разбора. Можно ввести предварительный анализ 
состояния окна, чтобы избежать подобной избыточности: 


1Е ( (Сее\1паом (№1пНапа1е, СИ_ОММЕВ)) // главное окно приложения 
&& (!Т5Тсоп1с (И1пНапа1е)) // не свернуто 
&& (1$М1пАаомУ1з1Ь1е (И1пНапа1е))) // видимо 


Роз&Меззачде (\1пНапа1е, ММ 5У$СОММАМР, $С_МТМТМТОЕ, 0); 


Эта структура 11, прежде всего, отбирает главные окна приложений. Далее 
проверяется, не свернуто ли окно. Для этого вызывается функция 1$еос, ко- 
торая возвращает гие, если окно свернуто. Затем проверяется, видимо ли 
окно: функция 1$\шаом У15Ше возвращает фгие, если стиль окна \$_У1- 
ЭТВГЕ — видимое (реально в данный момент оно может быть невидимо, если 
загорожено другими окнами). Только если окно прошло все эти проверки, ему 
посылается сообщение \УМ_5У5СОММАМО. 

Приведенный код сворачивает окна всех приложений, включая окно соб- 
ственного приложения. Иногда может потребоваться свернуть все окна, кроме 
окна данного приложения. Этого можно достичь небольшой переделкой приве- 
денной выше функции ЕпатРГгос: | 


роо1 __$Еаса11 ЕпимРгос1 (НИМО И1пНапат1е, 1опа Рагам ) 
{ 


1Е ( (Сее\1паом (И1пНапа1е, СИ _ОММЕВ)) // главноз® окно приложения 
&& (!Т5Тсоп1с (М1пНара1е)) // не свеонуто 
&& (15М1пАом\У1з1Б1е (М1пНапа1е)) // видимо 


&& (М1пНапа1е!=Ар11сае1оп->Напа1е) 
&& (М1пНапа1е!=Гогт1->Напа1е))) 
Роз&Меззаде (\1пНапа1е, ММ ЗУЗСОММАМО, $С_МТУТМТОЕ, 0); 
гебцгп фгце; 


} 


Две выделенные жирным шрифтом проверки отличают данный код от пре- 
дыдущего. Они предотвращают свертывание окна данной формы (предполага- 
ется, что это форма Еогт1Т.) и свертывание данного приложения (АррИсавоп). 

Выше была рассмотрена методика перебора окон, основанная на функции 
Епит \ 1 9ом$. Возможен и другой путь, основанный на рассмотренной ранее 
функции Че Мех \У1т9до\. В файле шпизег.й эта функция сделана идентичной 
функции Се \Ут9омх, так что из приложения с равным успехом можно вызы- 
вать Се Мех У/1т194о\, или Сер У/1т9оу.. 

С помощью этой функции можно организовать свертывание окон всех при- 
ложений следующим образом: 

НИМО М1пНапате ; 

\М1пНапа1е = Напа1е; 

м611е (И1пНапа1е != 0) 

` изпнавале = сбеемехЕМ1пао\м (М1пНапа1е, СМ НИМОМЕХТ); 

1Е ( (Сее\1паом (И1пНапа1е, СИ ОММЕВ)) // главное окно приложения 
&& (! 1зТсоплс (И1пНапа1е)) // не свернуто 
&& (13И1паом\/1$1Ь1е (И1пНапа1е))) // видимо 
Роз&Меззаде (И1пНапа1е, ИМ 5У5СОММАМО, $С МТМТМТАЕ, 0); 
} 
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Отличие от предыдущего примера заключается только в организации цикла 
по окнам. В качестве начального значение для поиска задается \УтшНап Ме = 
Нап @ф{е. Затем окна перебираются функцией Се Мех У т4до\м. А проверка 
окон и их свертывание осуществляется так же, как в первом примере. 

Для того чтобы при таком подходе свернуть все окна, кроме окон данного 
приложения, достаточно заменить первый оператор, задающий начальное зна- 
чение \УшНапа, на следующий: | 


\1пНара1е = Арр11са®1оп->Напа1е; 


Видимыми останутся все окна текущего приложения, а все прочие будут свер- 
нуты. 

В заключение рассмотрения функций доступа к окнам надо упомянуть 
еце об одной функции — Че Еогесгопп 9 У т9до\: 


НИМР СесГгогеагоцпай1птаом (УОтТр) 


Функция возвращает дескриптор окна, являющегося активным в данный 
момент. Этой функцией, можно воспользоваться для построения приложения, 
осуществляющего мониторинг компьютера. Если периодически с помощью 
таймера Татег вызывать эту функцию, можно вести протокол: в какой момент 
с каким окном и приложением работает пользователь. 


5.1.4 Доступ к окну 090$ 


Дескриптор окна выполняющейся программы РОБ можно получить функ- 
цией Ет9\У/тдом, которая уже не раз использовалась нами. Но в нее надо пе- 
редать имя класса окна, дескриптор которого требуется получить. А имя клас- 
са окна ООВ зависит от версии \!!14омз. Для Уш9омз 9.х это имя “Му”, а для 
Уп 9омз МТ/2000/ХР имя класса “Сопзо]е\таомС]Лаз$”. Так что дескриптор 
окна РОБ можно получить следующим кодом: 


Ап$156г1па С1Маме ; 
НИМО Н; 


1Е (СебУегз1оп() < 0х80000000) 
С]Маме = "Сопзо1е\1паомС1а$з$"; 
е1зе С1Маме ="6 ву"; 
Н = Е1пам1паом (С1Маме.с_з6к(), №011); 


Сначала функцией Се Уегз1оп (см. разд. 1.2) проверяется версия \У/1140\з 
и в переменную СИМаше заносится соответствующее имя класса. А затем 
функцией Ешд\У1т4о\м получается дескриптор окна. Приведенный код нахо- 
дит дескриптор окна ОО, независимо от его заголовка. Если на компьютере 
открыто только одно такое окно, в переменную Н занесется его дескриптор. 
Если не ни одного открытого окна 2ОЪ, переменная Н будет равна 0. А если 
есть вероятность, что открыто несколько окон 0ООБ, то вторым параметром 
в вызов ЕтА\/ш9о\ надо передать строку, содержащую заголовок окна. 

После того как получен дескриптор окна, его можно использовать в любых 
функциях АРТ \!114о\з для управления этим окном. Например, оператор 


С1озеЙ1паом (Н); 
свернет это окно. А оператор 
ЗепаМеззачде (Н, ММ СТЪОЗЕ, О0, 0); 


закроет его. Правда, в \УшЧомз МТ/2000/ХР при этом, возможно, будет задан 
вопрос, закрывать ли его немедленно. В \У/1ш4омз 9.х окно закроется без вся- 
ких вопросов. 
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Операторы 


сраг РаЕ[127]; 
СеЕМ1пЧомТехе (Н, БаЕ, 128); 


занесут в буфер Ба заголовок окна РОБ. А оператор 


ЗесИ1паомТех® (Н, "Окно управляется моим приложением"); 


изменит текст заголовка окна. 
Оператор 


Епаб1ей\1паом (Н, Еа15е); 


сделает окно РОБ недоступным, так что пользователь не сможет ни работать 
с ним, ни закрыть его. Но ваше приложение по-прежнему может его закрыть 
сообщением \М_СГОЪЗЕ. Оператор 


Епаю1е\1паом (Н, Егае); 


восстановит доступность окна. 

В окне ОО можно рисовать. Для этого надо получить функцией де ОС 
или ае\т4ом)сС дескриптор контекста этого окна и далее можно рисовать 
на этом контексте, как на любом другом. Получение дескриптора контекста 
и рисование на контексте подробно рассмотрено в разд. 5.5. 


5.2 Оформление окон 


5.2.1 Системные меню форм 


Под системным меню понимается то стандартное меню, которое всплывает 
в любом окне У том при щелчке на квадратике в его левом верхнем углу. 
Это меню содержит обычно разделы Восстановить, Переместить, Размер, Свернуть 
и т.п. 

Если вам требуется как-то переопределить реакцию вашего приложения 
на стандартные разделы системного меню, это можно сделать, введя собствен- 
ный обработчик сообщения УМ_5УЗСОММАМО. 

Например: 


заголовочный файл: 


с1аз$ ТЕогм1 : раБ]11с ТРГогм 


{ 


__ручЬ115зВеа: // ТРЕ-тападея СотропепЁз 
рг1уа%е: // Изег аес]акаЕ1оп$ 

У01А __ Еазеса11 ИМ5узСопмапа (ТИМ5узСомтага&); 
руЬ11с: . | // ПОзегк аес1агаЕТопз$ 


__Еазеса11 ТЕогм1 (ТСомропепе* Омпег); 


ВЕСТМ_ МЕЗЗАСЕ МАР 

МЕЗЗАСЕ _НАМРЪЕВ (ИМ 5УЗ5СОММАМО, ТИМ5 узСотмтапа, ИМ5 узСомтапа) ; 
ЕМР МЕЗЗАСЕ МАР (ТСопропеп®); 
}; 


файл реализации: 


СОП$е 
5С МуГЕем1 = ММ Ч$ЕБ + 1, 


282 Глава 5. Окна и графика 


5С_Мут%ем2 = ИМ О5ЕК + 2; 


уо1А __ЕазЕса11 ТЕогм]1 : : МУМ5узСопмапа (ТИМ5узСомтапа& Мз$9) 


{ 
$м16еср (Мза.СмаТуре) 


{ 


сазе $С _ СТОЗЕ: 5ромМеззаче ("$5С СТЪОЗЕ"); 
ЬгеаКк; 

сазе $С МАХТМТАЕ: 5ВомМеззачце ("$5С_МАХТМТАЕ"); 
БгеаКк; 

сазе $С МТМТМТАЕ: 5ВомМеззаде ("5С_МТМТМТАЕ"); 
ЬгеаКк; 

сазе $С МОУЕ: 5помМеззачде ("$5С_МОУЕ"); 

‚ БгеаКк; 

сазе 5С ВЕЗТОВЕ: 5ПочМеззаде ("$С_ВЕЗТОВЕ"); 
ргеак; | 

сазе $С_5Т2Е: ЗВомМеззаде ("$С_5$12Е"); 
БгеаКк; 


} 
РеЕИ1паомРгос (Напа1е, ММ 5У$СОММАМОР, Мзчд.СпаТуре, 
МАКЕГРАКАМ (М5а.ХРоз,Мза.УРо$)); 
Мза.Вези1* = 0; 
} 


В этом примере приложение просто извещает вас о пришедшей команде: 
эС_СГОЗЕ — Закрыть, 5С_МАХИМТАЕ — Развернуть, ЭС_МТМТМТАЕ — Свер- 
нуть, ЭС_МОУЕ — Переместить, 5С_ВЕЗТОКЕ — Восстановить, 9С_ЗТДЕ — Раз- 
мер. После извещения о команде вызывается функцией Бе! т@4омРгос стан- 
дартная обработка сообщения, которая обеспечивает выполнение соответст- 
вующей команды. Последний оператор обработчика возвращает 0, что являет- 
ся для системы сигналом об окончании обработки сообщения данным моду- 
лем. | 

Обратите особое внимание на запись в классе, обеспечивающую обработку 
сообщения. В разделе рмузжфе объявляется обработчик сообщения, а в раздел 
риб Це помещается карта, ссылающаяся на этот обработчик. 

Вы, конечно, можете в приведенном коде убрать все вызовы ЗЭВом- 
Мез5асе, вызов стандартного обработчика, и ввести собственную обработку 
того или иного сообщения. Например, если вы замените приведенную выше 
строку для команды 5С_МОУ\УЕ строкой 


сазе $С МОУЕ: ТеЕЁ = 0; Тор = 0; 


то команда меню Переместить будет перемещать окно приложения в верхний 
левый угол экрана. 

Если вы хотите изменить что-то в системном меню вашего приложения, 
вы можете получить к нему доступ с помощью функции де ЗузветМепи. Ее 
первый параметр — дескриптор окна, а значение второго параметра определя- 
ет режим работы функции: Ёа]5$е — получение копии системного меню, фгие — 
установка системного меню по умолчанию с удалением существующего меню. 
Например, операторы 


НМЕМО МусузЕепМепи; 


МубузсешМепи = СбеббузбепМепи(Напа]1е, Еа15е); 
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дают копию МуЗузетМепи системного меню, после чего вы можете добавить 
в системное меню новые разделы или удалить некоторые из существующих 
в нем разделов. | 

Удаление раздела осуществляется функцией РеаееМепи. Первым аргу- 
ментом в нее передается идентификатор удаляемого раздела или его индекс 
(индексы начинаются с 0). А второй аргумент определяет, как именно иденти- 
фицируется раздел первым аргументом: МЕ_ВУСОММАМРО — идентификато- 
ром раздела, МЕ_ВУРОЗГТОМ — индексом. Например, оператор 


Ре1ефеМепи (МубуземМепи, $С_СТО$ЗЕ, МЕ _ВУСОММАМО); 


удалит из системного меню вашего приложения раздел Закрыть и сделает недо- 
ступной соответствующую системную кнопку. Впрочем, горячие клавиши 
АН-ЁЕ4 все-таки будут закрывать приложение. Но их отключить нетрудно. До- 
статочно в форме установить в фгие свойство КеуРгемем, и в обработчик собы- 
тия ОпКеуромп формы вставить оператор: 


1Е (521ЕС.Сопба1п$ ($5$5А16) && (Кеу == УК Е4)) 
Кеу = 0; 


Тогда приложение можно будет зарыть только с помощью Диспетчера Задач 
УЛтао\з. 
Оператор 


СсесбузсетМепча (Напа1е, фгое); 


восстановит системное меню по умолчанию. 
Добавить новые разделы в системное меню можно функцией Арреп4Мепи 
или шзег{МепиЦет. Вторую из них, позволяющую вставить раздел в указан- 
ную позицию меню и задать множество характеристик раздела, мы рассматри- 
вать не будем. Вы можете посмотреть ее в гл. 8. А функция АррепаМепа, под- 
робное описание которой также дано в гл. 8, вставляет раздел в конец меню, 
указанного ее первым параметром. Второй параметр задает флаги, определяю- 
щие вид вводимого раздела. В частности, флаг МЕ _ЭТЕМС означает раздел с 
текстовой надписью, флаг МЕ_ЗЕРАКАТОК — разделитель. Есть еще ряд 
флагов, назначения которых вы можете посмотреть в гл. 8. Третий параметр 
задает идентификатор вводимого раздела. А последний параметр — строка 
текста, связанная с разделом. | 
Пусть, например, вы хотите добавить в конец системного меню раздели- 
тель и два раздела с идентификаторами ЗС_МуЦет1 и ЭС_МуЦет2. Первый 
из них будет переключать состояние окна формы с нормального на “поверх 
всех” и обратно. Он должен содержать индикатор, указывающий текущее со- 
стояние окна. Второй раздел будет вызывать хранитель экрана. 
Это может быть реализовано следующими операторами: 
МубузсетМепиы = СеббузеепМепо (НапЯ]е, Еа15е); 
АррепаМепи (МубузЕетМепа, МЕ _ЗЕРАВАТОВ, 0, ""); 
АррепаМепа (МубузеетМепи, МЕ_$5ТВТМс, $С МутТ%Еепт1, 
"&Поверх остальных"); 


АррепаМепа (МубЗузЕемМепа, МЕ _5ТВТМС, $С МутЕем2, 
"&Хранитель экрана"); 


° Первый из приведенных выше исполняемых операторов добавляет в ко- 
нец меню разделитель, а два следующих оператора добавляют новые разделы 
5С_МуЦКет1 и 5С_МуЦет2, причем разделы меню могут повторяться, то 
есть при повторном выполнении этих операторов эти пункты добавляются 
еще раз. 
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Рассмотренный ранее обработчик сообщения \УМ_5ЗУЗСОММАМО может 
быть дополнен следующим образом: 

НМЕМО МузузеепМепа; 

_ СОП$Е 


5С МутТ&ем1 = ИМ О5ЕБ + 1, 
5С_МуГ%ем2 ИМ О5ЕВ + 2; 


Уу01а __Еаз®са11 ТЕГогм1 : : ИМ5узСомтала (ТИМ$ узСоттапа& М$9) 


{ 
$м16ср (Мза.СпаТуре) 


{ 
сазе $5С МутТ%ем1:; 
1Е ((СесМепабфафе (МубузеепМепч, 
5С МутЕет1, МЕ ВУСОММАМО) & МЕ СНЕСКЕР) != 0) 


{ 
ЗееИ1паомРоз$ (Напа1е, НИМР МОТОРМОЗТ, 0,0, 0, 0, 
ИР МОМОУЕ | 5ИМР_МОЗТаЕ); 
СВескМепаТ {еп (МубузЕетМепиа, $5С_Мут!еем1, 
МЕ _ВУСОММАМР | МЕ ОМСНЕСКЕО); 


} 


е1 зе 


{ 

зеЕМ1паомРоз$ (Напа1е, НИМР_ ТОРМОЗТ, 0, 0, 0, 0, 
ЗИР_МОМОУЕ | $МР_МОЗТАЕ); 

СпескМепиТ ем (МубузЕетМепи, $С_МуГ%еп1, 
МЕ_ВУСОММАМР | МЕ _СНЕСКЕРО); 


} 
ЬгеаКк; 
сазе $С_МуТ%ет2:; 
бепаМеззаде (Арр11са&1оп->Напа1е, ИМ 5У$5СОММАМР, $С_5СВЕЕМЗАУЕ, 0); 
Ьгеак; 


} 
РеЕ\И1паомРгос (НапЯ1е, ММ 5УЗСОММАМО, Мза.СпаТтуре, 


МАКЕГРАВАМ (М5з.ХРо$,М$за.УРоз)); 
Мза.Вези1& = 0; 
} . 

Обработка команды ЭС_МуЦет2 в особых комментариях не нуждается. 
Она сводится просто к посылке сообщения, вызывающего хранитель экрана 
(см. разд. 1.4). А обработку команды ЭС_МуЦет1 надо рассмотреть подроб- 
нее. Поскольку реакция на эту команду (включать или выключать состояние 
“поверх остальных”) должна зависеть от текущего состояния раздела меню, 
надо, прежде всего, определить это состояние. Для этого в приведенном коде 
использована функция СеМепи${ае (см. ее подробное описание в гл. 8). Она 
возвращает текущие флаги раздела. Если среди этих флагов имеется 
МЕ_СНЕСКЕО (наличие флага проверяется операцией & и сравнением резуль- 
тата с 0), значит индикатор раздела включен. В противном случае индикатор 
выключен. Забота о переключении индикатора лежит на программе. Переклю- 
чение делается функцией СвВескКМепи Це (см. ее описание в гл. 8). Если в чис- 
ло ее флагов (последний аргумент) введен флаг МЕ_СНЕСКЕЮ, в разделе появ- 
ляется галочка, свидетельствующая о том, что раздел выбран. Флаг 
МЕ _ОМСНЕСКЕО убирает галочку — выключает индикатор. 

Изменение состояния окна производится функцией Зеё \тдомРо$. Ее 
второй параметр показывает задаваемое состояние окна: Н\УМО_ТОРМОЗТ — 
поверх остальных, Н\УМО_МОТОРМОЗТ — выключение этого состояния. 
Следующие четыре параметра задают новое положение и размеры окна. Но пе- 
реданные последним параметром флаги 5\УР_МОМОТЕ и 5\Р_МОЗТАЕ обес- 
печивают сохранение прежней позиции и размеров окна. Так что при этих 
флагах предыдущие параметры игнорируются. 
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Следует отметить, что в данном случае нельзя было бы задавать состояние 
“поверх остальных” установкой свойства Еогт&Уе в #55$4ауОпТор. Дело 
в том, что задание Еогт&Уе одновременно задаст и системное меню по умол- 
чанию, т.е. уничтожит введенные вами новые разделы. 

Выше рассмотрены некоторые функции, позволяющие управлять систем- 
ным меню. Соответствующий тестовый пример Р5узМепи вы найдете в ката- 
логе Гогтз на диске, приложенном к книге. Его окно показано на рис. 5.2. 
Кнопка Создать добавляет в системное меню описанные выше разделы Поверх 
остальных и Хранитель экрана. Кнопка Восстановить восстанавливает функцией 
Се ЗузетМепи системное меню по умолчанию. Кнопка Удалить удаляет из 
системного меню команду Закрыть. При щелчке на этой кнопке не только уда- 
ляется раздел системного меню, но становится недоступной и системная кноп- 
ка с крестиком в правом верхнем углу окна, закрывающая приложение. Так 
что после этого закрыть окно приложения можно будет только клавишами 
А|-Е4 или из Диспетчера задач УМ ш@4о\з. 


Рис. 5.3 ‚3! Системное меню =. 
Окно приложения Р5у5Мепи и „ 
‚Удаление команды "Закрыть" `` ^^ 

После щелчка на этой кнопке 


закрыть приложение можно будет 
только клавишами АК-Е4 


Г Меню по умолчанию гНовые разделы’ ^^ 


| 
И 


Восстановить | 


Надо сказать, что, помимо рассмотренных, имеются и другие функции, 
работающие с меню: Тег МепиЦет — вставка нового раздела, де Мепи- 
Цеш по и Зе Мепо Цент по — получение подробной информации о разделе 
и установка его характеристик, Епа/]еМепаЦет — управление доступностью 
раздела, и ряд других. Да и в рассмотренных функциях рассказано не о всех 
их возможностях. Более подробную информацию вы найдете в гл. 8, в справке 
[4] (там приведены также более сложные примеры) или во встроенной справке 
С-++Во!аег. 


5.2.2 Непрямоугольные окна и формы 


5.2.2.1 Регионы 


Иногда желательно создавать формы или окна на них непрямоугольной 
формы. В отношении форм это чаще всего связано со стремлением украсить 
свое приложение, отойти от традиционных прямоугольных форм. В отноше- 
нии непрямоугольных окон, помимо стремления к нетрадиционности, могут 
преследоваться и более прагматические цели: выделение каких-то областей 
на форме, создание перемещаемых окон различной конфигурации в задачах 
конструирования и т.п. 
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Задачи создания форм и окон произвольной формы решаются с помощью 
понятия области, региона окна — геё1оп. Регион — это часть окна, восприни- 
маемая именно как окно. Все, что находится за пределами региона не воспри- 
нимается пользователем и системой как окно. 

Регион — это объект, имеющий дескриптор типа НВСМ. Если регион 
сформирован, то его задание для оконного компонента, включая форму, осу- 
ществляется функцией Зе \УтдомВп, объявленной в файле Итизег.й сле- 
дующим образом: 


10 ЗееИтпаомКВап (ТМ НИМР Ю\па, тм НВСМ БВап, ТМ ВООЪ БВеагам); 


Параметр В\У/п4@ является дескриптором окна, которому передается реги- 
он, параметр ВВеп — дескриптор сформированного региона, а параметр 
5Бедгам должен быть равен фгие, если надо немедленно после задания регио- 
на перерисовать окно. Функция возвращает ненулевое значение, если выпол- 
нилась успешно. 

После выполнения функции Зе \т4домВоп владельцем заданного регио- 
на становится система. Так что этот регион нельзя использовать повторно — 
его надо заново создавать. 

Пока регион не использован в вызове функции Зеё \Ут4домВгт, его можно 
запомнить функцией СеВерглопрафа: 


РИОВР сееведтопрака (ТМ НВСМ ПВап, ТМ РМОВО амСочпе, 
ООТ ЬРЕСМОРАТА 1рВапрафа); 


Параметр ВВ?т является дескриптором запоминаемого региона. Параметр 
4\Соипё указывает число байтов в буфере 1рВп)аца, в котором должны со- 
хранятся данные региона. Если объема буфера не хватило для записи всех дан- 
ных, или если в вызове беВерлопОафа параметр 1рВеп)афа задан равным 
МОЕЕ, то функция возвращает число байтов, необходимое для хранения дан- 
ных. В остальных случаях при успешном выполнении функция возвращает 1, 
а при ошибке — 0. 

Таким образом, сохранение региона можно обеспечить следующим об- 
разом: 

РИОКО МВедч = СсееВедтопрафа (ВСМ, 0, МО); 

ТРЕСМРАТА Р = (_ВСМРАТА *)ма11ос (М№Вед); 

Сеевед1опрафа (ВСМ, МВед, Р); 

Первый вызов аеВеглоп)ава заносит в переменную МВей необходимый раз- 
мер буфера. Затем функция шаПое выделяет необходимый блок памяти и пе- 
редает в переменную Р указатель не него. А второй вызов аеВег1оп Вафа запо- 
минает в выделенном блоке памяти данные региона ВСМ. Пример запомина- 
ния региона вы можете увидеть в разд. 5.2.2.3. 

Запомненные данные можно использовать для восстановления по ним ре- 
гиона с помощью функции Ех&СгежфеВег1оп: 


НВСМ ЕхеСгеафкевВеатоп (ТМ СОМЗТ ХРОВМ *1рХхХЕогм, ТМ РИОВР пСочпе, 
ТМ СОМЗТ ВСМРАТА *рКапрака); 


Параметр 1рХФогт указывает структуру типа ХЕОЕВМ, которая может ис- 
пользоваться для трансформации региона. Она подробно рассмотрена 
в разд. 5.5.2. Отметим только, что с ее помощью можно проводить любые ли- 
нейные преобразования региона: сдвиг, поворот, зеркальное отражение, мас- 
штабирование. Так что функция Ех СгежеВег1оп может не только восстанав- 
ливать запомненный регион, но и трансформировать его. Если задать рХФогт 
равным МОГГ,, то трансформация не будет проводиться. Параметры пСоип% 
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и рВеп)а&а определяют размер и указатель буфера, в котором хранятся дан- 
ные региона. Функция возвращает дескриптор результирующего региона. 

Таким образом, если продолжить приведенный выше пример, то создать 
регион по запомненным данным можно оператором: 


НВСМ МуВед1оп = Ех®СгеафевВед1оп (МОЬЬ, МВед, Р); 


5.2.2.2 Функции формирования регионов 


Рассмотреть функции, позволяющие создавать регионы, проще всего на 
примере. Соответствующий проект РГогтз имеется на приложенном к книге 
диске в каталоге Рогтз. На рис. 5.4 вы можете видеть это приложение в раз- 
личных состояниях. Приложение содержит панель Рапе]]1 и две группы ра- 
диокнопок, соответствующих различным рассмотренным далее функциям. 
Выбор кнопки в левой группе изменяет конфигурацию формы, а выбор кнопки 
в правой группе изменяет вид панели Рапе!1. 


Непрямвугольные формы ей = х 
‚Функция для Формьг————1 Гг`Функция для панели- ——— Функция для формы -- т, ‚ Функция для панели 
С СемеАесЯ ол С бежщеВесЯот | °С Семее Яодп | ‚ С СвеаеАесА дп 
: С СежеРесЯууюйех | С СедеВесЯомиес! ‚ Г СемеАесАдтищес  , - С СеаеВесА дтифтес 
‚ © СемеВоилЯАесЯ дл Г СедеРоит Вест | ; С СезеАоипдВесА т  : ‚ ’ СиезеРоиптвВес А дп 
: С СемеЕ бобоА ол С СемеЕрёсАоп Г ’ © СезеЕйрёсАдл С СеаеЕНрисА ди 
СГ СожеЕбресА дутовесе | ‚С СедеЕбрысА дутаиес! ‹ С СезеЕйресЯ дптдгес! ` а СтеабеЕ ИрисВ апидиес! 
‚ С СемеРоуоотЯ от | ‚ Г СекеРаудоеЯ дл С СезеРоудотА ди > ‚СтежеРоудоиР д" 
‚С СежеРоуРоудотА дл ‚ С СемеРоРоуооА дл | ’С СезеРоуРомдотЯдл = < Г СлезеРоуРомаотР ап 
г С сомымеВол | | @ болбтейод Г. ‚С СотьтеВаи °С сотьпеРдй 
Рапей , т Рапей 
а) 6) 


мы г Функция д 
Зап ; С СезеВе 
=” Рич. 
СемеНо' „ЭВеЯ ол 
ГС ЧезеЕК Нот 
, С СовЕ! Вотиднесе :_ 
ГС СешерР, "Аб 
| Г СтежерРх зудотА аи 
| © Сотыте 
И ОИ 


РапеП 


в) 


Рис. 5.4. Гри состояния приложения с непрямоугольными окнами 


Ниже приведен код этого приложения: 


Уу01А _ Еаз®са11 ТЕоги1: : Ва@1обгоцр1С11сК (ТОБ]есе *Зепаег) 
{ 

НВСМ МуВед1оп, МуВеч1оп2; 

ТВесе Вес =. Вес® (0, 0, имзлаеь, Не1апе); 

ТРолпЕ Р[7]; 
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106 №Р[1]; 


$м1еср (КаЯ1оСгопр1->Т&епшТпаех) 


{ 
сазе 0: МуВед1оп = Сгеа$евВесЕВап (0, 0, ИМ1аЕВ, Незоаье); 


БгеаКк; 
сазе 1; МуВедтоп = СгеафеВес&ВапТпа1гесь (&Вес); 
Бгеак; 
сазе 2: МувВедлоп = СгеафекоцпавВес® Ват (0, 0, Изаей, Незоаве, 50, 50); 
ргеак; | 
сазе 3: МуВед1оп = СгеафеЕ111рЕ1сВап (0, 0, МаЕв, Не1ар®); 
| Ьгеак; | 
сазе 4: МувВед1оп = СгеафеЕ111ре1сВап1Тпа1гес® (&Вес); 
Бгеак; 
сазе 5: Р[0] = Ро1пе (0, Нелаве / 2); 
Р[ 1] = Ро1пЕ (Млаев / 2, 0); 


Р[ 2] = Ро1пЕ (М1аей, Незаье / 2); 
Р[ 3] = Ро1пе (И1АЕв / 2, Не1аре); 
МуКеач1оп = СгеакеРо1удопКап (Р, 4, АШГТЕВМАТЕ); 
ЬгеаКк; 
сазе 6: Р[0] = Ро1п® (0, Нелар® / 2); 
Р[ 1] = Ро1п& (ИЗАЕн / 4, 0); 
Р[2] = Ро1пЕ (М1аев / 2, НелавЕ / 2); 
Р[ 3] = Ро1п® (Млаен / 4, Не191*); 
Р[ 4] = Ро1пЕ (Ман / 2, Нелаве / 2); 
Р[ 5] = Ро1п® (3 * Маащн / 4, 0); 
Р[ 6] = Ро1пЕ (Млаеь, Нелаве / 2); 
Р[ 7] = Ро1пе (3 * Изаеь / 4, Не1а0®); 
МР[ О] = 4; 
МР[1] = 4; 
МуВеач1оп = СгеакеРо1уРо1удопВап (Р, МР, 2, АГТЕВМАТЕ); 
Бгеак; 


Сгеа*еЕ111ре1сВап (М1аеь / 4, 0, 
3 * Иащь / 4, Незаь*); 
МуВед1оп2 = СгеафеЕ111рё1сВап (0, Незаре / 4, И1аеь, 
| 3 * Нелаве / 4); 
Сомр1певВап (Муведч1оп, МуВедзоп, МуВед1оп2, ВСМ_ХОВ); 
Бгеак; (`` 


сазе 7: МуВедлоп 


} 
зееМ1паомВап (НапЧ1е, МуВед1оп, +гие); 


Уу014 __Еаз®са11 ТГогт1: :Ва@1оСбгоир2С11сК (ТОр]есЕ *5епаег) 
{ 
НВЕСМ МуВед1оп, МуВед1оп2; 
ТВесе Вес = Кес® (0, 0, Рапе11->М1аЕей, Рапе11->Не1а1®); 
ТРо1пе Р[7]; 
106 М№МР[1]; 
$16 СВ (ВаЯ1оСгопр2->Т$емГТпаех) 
{ 
сазе 0: МуВедлоп = Сгеабекес® Ват (0, 0, Рапе11->и1аф6ь, 
Рапе11->Незаве); 
ргеак; | 
сазе 1: МуВед1оп = СгеафеВес®*ВапТпа1гес® (&Вес); 
Бгеак; | 
сазе 2: МуВедлоп = СгеафеВоцпавесе Ват (0, 0, Рапе11->мтафь, 
Рапе11->Не1аве, 50, 50); 
Ьгеак; 
сазе 3: МувВед1оп = СгеафеЕ111ре1сВап (0, 0, Рапе11->изаев, 
| Рапе11->Не1айе); 
Бгеак; 
сазе 4: МувВед1лоп = СгеакеЕ111рЕ1сВапТпА1гес® (&Вес); 
ЬгеаКк; 
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сазе 5: Р[0] = Ро1г.& (0, Рапе11->Не1аь*е / 2); 
Р[ 1] = Роли (Рапе11->М1лаей / 2, 0); 
Р[ 2] = Роли (Рапе11->М1АЕй, Рапе11->Нелзаве / 2}; 
Р[ 3] = Ро1пе (Рапе11->М1аер / 2, Рапе11->Не1аь®); 
Мувеач1оп = СгеакеРо1удопКап (Р, 4, АГТЕВМАТЕ); 
ЬгеаКк; 

сазе 6: Р[О] = Ро1пе (0, Рапе11->Нетаве / 2); 
Р[ 1] = Ро1пЕ (Рапе11->м1аев / 4, 0); 
Р[ 2] = Ро1иЕ (Рапе11->М1аей / 2, Рапе11->Нелаве / 2); 
Р[ 3] = Ро1и® (Рапе11->И1аев / 4, Рапе11->Нелав®); 
Р[ 4] = Ро1иЕ (Рапе11->М1аер / 2, Рапе11->Нелаве / 2); 
Р[] 5] = Ро1ие(3 * Рапе11->и1аев / 4, 0); 
Р[ 6] = Ро1и* (Рапе11->М1аЕй, Рапе11->Незаве / 2); 
Р[ 7] = Ро1пе (3 * Рапе11->М1аер / 4, Рапе11->Не1а8®); 
МР[ 0] = 4; 
№Р[1] = 4; 
МуКед1оп = СгеаферРо1уРо1удопВап (Р, МР, 2, АПТЕБМАТЕ); 
ЬгеаКк; 


у 

й 
сазе 7: МуКедлоп = Сгеа®еЕ111ре1сВап (Рапе11->Итаеь / 4, 0, 
3 * Рапе11->ИтафеНь / 4, Рапе11->Нелав*); 

МуКед1оп2 := Сгеа&еЕ111ре1сВап (0, Рапе11->Не1аве / 4, 
Рапе11->И1аен,3 * Рапе11->Незаре / 4); 
Сотр1пеБоап (Мувед1оп, МуВед1оп, МуВед1оп2, ВСМ_ ОВ); 

Югеак; 


} 
ЗееиИ1паомВап (Рапе11->Напа1е, МуВед1оп, &гие); 


} 


Уу01 _ ЁРаз®са11 ТЕогл1; : ЕогиМочзеромп (ТОЮ)есЕ *5епаег, 
ТМоизеВвВиа оп Ваббоп, ТРЕЕ баке ЗИТЕЕ, 1106 Х, 1пЕ У) 


{ 


ВКе1еазеСареаиге (); 

| РегЕогм (ММ 5УЗСОММАМР, 0хЕ012, 0); 

} 

Две почти одинаковые процедуры ВаФ1юоСгопр1СПсЕК и Ва41оСгопр2СПсК 
являются обработчиками щелчков на соответствующих группах радиокнопок. 
Они различаются тем, что в первом обработчике свойства Ул, Нее 
и Нап е относятся к форме, а во втором — к панели Рапе!1. Кроме того, они 
различаются одним параметром функции Сошбшевоп, которая будет рас- 
смотрена позднее. 

В каждом обработчике в зависимости от выбора пользователя применяет-. 
ся та или иная функция, для формирования региона МуКе?1оп. Рассмотрим 
эти функции. Все они возвращают дескриптор объекта сформированного ре- 
гиона. 

Функция СгежфеВес!В оп создает прямоугольную область. Ее параметры 
определяют координаты левой, верхней, правой и нижней стороны. Как и во 
всех остальных функциях, система координат имеет началом левый верхний 
угол окна. Подчеркнем, что именно окна, а не его клиентской области. В при- 
веденном примере эта функция задает в качестве МуВег1оп всю область окна. 

Функция СгежеВес&Вопт1гес аналогична функции Сгежфеквес Вот. 
Только она принимает всего один параметр — указатель на прямоугольную об- 
ласть типа ТВес+. В приведенном примере она формируется функцией Вес. 

Функция СгежеВвоппаВесВоп формирует прямоугольную область со 
скругленными углами (см. форму на рис. 5.4 а). Первые четыре параметра сов- 
падают с параметрами функции СгежфеВес Вт и описывают прямоугольник. 
Два последних параметра задают соответственно ширину и высоту эллипса, 
используемого для скругления углов. 
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Функция СгежеЕШрЯесВ оп формирует область в виде эллипса (см. форму 
на рис. 5.4 6). Ее параметры совпадают с параметрами функции Сгеафе- 
Бес Втп и характеризуют описанный вокруг эллипса прямоугольник. В при- 
веденном примере эта функция задает эллипс, вписанный в форму. 

Функция Сгеаже ЕШрисВ оп ш1гес{ аналогична функции СгежеЕШрис- 
Всп. Только она принимает всего один параметр — прямоугольную область 
типа ТВес$. В приведенном примере она формируется функцией Вес. 

Функция СгежеРо!ухопВ еп формирует область в виде замкнутого много- 
угольника (см. панель на рис. 5.4 6). Первый параметр этой функции — указа- 
тель на массив точек типа ТРошф, характеризующих углы многоугольника. 
Каждая точка повторяется только один раз. Функция сама замыкает много- 
угольник, соединяя первую и последнюю точки. В примере массив точек для 
функции СгежеРо]угопВ п формируется в переменной Р с помощью функции 
Рош{. Этот массив описывает ромб, вписанный в форму. Второй параметр 
функции указывает число используемых точек массива. Так что в массиве мо- 
жет быть больше точек, чем используется для формирования многоугольника. 
Последний параметр характеризует способ заполнения области внутри много- 
угольника и может принимать значения АГТЕВМАТЕ или \ПМОТМО. При 
значении АГТЕВМАТЕ регион заполняет области между четными и нечетны- 
ми сторонами многоугольника, а при значении \УТПМОПУС заполняется вся 
внутренняя часть многоугольника. Различие этих двух режимов можно заме- 
тить только на достаточно сложных многоугольниках. Такой пример вы може- 
те видеть на рис. 5.5. Это пример, на котором двум панелям задается регион в 
виде пятиконечной звезды. Как видно из рисунка, при режиме АГТЕКМАТЕ 
из региона вырезается внутренний пятиугольник. . 


Рис. 5.5 СгеаеРофдопЯ дг(Р. 5. УАНОН6} = СтеаеРовдопВдт(Р, 5. АТЕАМАТЕ] 
Иллюстрация режимов 
АЁЕТЕВМАТЕ и МАМЫОМС 


Рапей 


Ниже приведен код этого примера. 


НВСМ МуВедтоп; 
ТРозпеЕ Р[5]; 

Рапе11->\1аеьв 
Рапе12->\1аЕй 
Рапе12->\1аЕв 


Рапе11->Незайе; 
Рапе11->И1аеп; 
Рапе12->Не1ане; 


Бог (1106 1 = О; 1 < 5; 1++) 

Р[ 1] = Ро1пЕ (Рапе11->мтаев / 2 * 
(1 + 511(М РР* 2/5. * 2*1)), 
Рапе11->М1аеь / 2 * 
(1 - со5(М РР * 2/5. * 2*1))); 


Мукедтоп = СгеафеРо1удопВап (Р, 5, ИТМОТМС); 
ЗеЕ\1пАомВап (Рапе11->Напа1е, МуВеа1оп, Егае); 
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МуБКеачлоп = СгеафеРо1удопВап (Р, 5, АГТЕВМАТЕ); 

ЗеИ1паомКап (Рапе12->Напа1е, МуВедзоп, &гие); 

В этом коде панели бдормируются одинаковыми квадратами. В массив Р 
в цикле заносятся через одну вершины звезды: первая, третья, пятая, вторая, 
четвертая. А затем по полученному массиву формируются регионы панелей 
в режимах АГТЕВМАТЕ и \УПМОГХС. | 

Функция СгежеРо1уРо]угопВ еп формируег область, состоящую из ряда 
замкнутых многоугольников (см. панель на рис. 5.4 в). Первый параметр этой 
функции — указатель на. массив точек типа ТРошф, характеризующих углы 
многоугольников. В нем сначала размещаются точки первого многоугольника, 
потом второго и т.д. Второй параметр функции — указатель на массив целых 
чисел. В нем указывается число точек каждого многоугольника: первого, вто- 
рого ит.д. Третий параметр функции СгежеРо!уРо|угопВ п определяет число 
многоугольников. А последний параметр характеризует способ заполнения о0б- 
ласти внутри многоугользика и может принимать значения АГТЕКМАТЕ или 
\МГМОГХС так же, как в функции СгежеРо]угопВтп. 

В примере в качестве первого массива используется Р, в качестве второго 
РМ. Сформированная область состоит из двух примыкающих друг к другу 
ромбов. 

Функция СошЫшеВК ги позволяет комбинировать различным образом два 
региона. Ее первый параметр — дескриптор результирующего региона, вто- 
рой — дескриптор первого из комбинируемого регионов, третий — дескриптор 
второго комбинируемого региона. Четвертый параметр определяет способ ком- 
бинирования и может принимать следующие значения: 


вВ@м_ _ АХО __ Создать пе пересечение двух областей. 


ВСМ_СОРУ Создать колию первой комбинируемой области (вторая область 
‚не учитывг. ется). 


ВСМ_  ТЕЕ Создать об: тасть, состоящую из части первой комбинируемой об- 
‚ ласти, не входящей во вторую. 


ВСМ_ ов | Создать об' ьединение двух областей. 


ВОСМ _хов, |Соодать об’ьединение двух областей и исключить из него пересе- 


чение этих областей. 
ЕЕ о А Еды п ЕЕ == ЕЕ 


В приведенном примере комбинируемые области формируются функцией 
СгежеЕШрИсВ2т в виде вертикально и горизонтально вытянутых эллипсов. 
Их дескрипторы заносятся в переменные МуВег#1оп и МуКег1оп2. Затем функ- 
цией СошЪшевВоип эти области комбинируются, и дескриптор результата зано- 
сится в переменную МуКег1оп. Для формы используется режим ВСМ_ХОВ. 
Результат вы можете видеть на рис. 5.4 в. Из объединения исходных областей 
вырезана середина, в которой эти области пересекаются. Для панели использу- 
ется режим ВСМ_ОВ. Результат вы можете видеть на рис. 5.4 а. В данном слу- 
чае происходит просто объединение комбинируемых областей. 

В приведенном коде имеется еще процедура ГогтМоцизедомп — обработ- 
чик события ОпМоизедомп формы. Назначение его следующее. При непрямо- 
угольной форме может цолностью или частично исчезать заголовок окна и со- 
ответственно его системные кнопки. Во-первых, при этом надо предусмотреть 
какие-то элементы, котсрые позволят управлять окном. И, во-вторых — жела- 
тельно предусмотреть возможность перемещать форму по экрану, несмотря на 
отсутствие заголовка, за который обычно пользователь буксирует форму. Вот 
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эта вторая задача и решается включенным в приложение обработчиком собы- 
тия ОпМоизеоми формы. Пояснение приведенного кода см. в разд. 5.2.3. 
А смысл этого обработчика в том, что пользователь может буксировать форму 
за любую ее точку. 


5.2.2.3 Пример создания формы окон на основе изображений 


Функции, рассмотренные в разд. 5.2.2.2, позволяют формировать регион 
по произвольному изображению. Иногда проектировщик может захотеть сде- 
лать это ради оригинальности или красоты (точнее, красивости). А иногда это 
может быть оправдано, исходя из сути задачи. Например, может быть удобно 
окно с конфигурацией карты России или каких-то областей, городов и т.п. 
Или при разработке игры может потребоваться фишка в форме некоторой фи- 
гуры. Или в задачах компоновки, когда вам надо создать окно, повторяющее 
по форме некоторый рисунок детали, фрагмента интерьера и т.п. Не описы- 
вать же каждый раз в подобных задачах контур окна вручную при смене гео- 
графической карты или при смене изображения! 

В разных ситуациях требования к решению этой задачи могут быть раз- 
личны. Может быть задан цвет или совокупность цветов, на которых в окне 
должны быть сделаны пустоты. Обычно это цвета фона, но могут быть и цвета, 
на которых в окне должны быть «дырки». Задача может быть поставлена ина- 
че: задан контурный рисунок, и надо вырезать форму окна по форме этого кон- 
тура. Контур может быть как односвязный, так и состоящий из нескольких 
несвязанных контуров. В приведенном ниже примере рассмотрены две задачи: 
вырезание заданного цвета из изображения и формирование региона по конту- 
ру изображения. Остальные варианты вы сможете реализовать сами по образу 
и подобию рассмотренных. 

Приложение, которое на приложенном к книге диске вы найдете в ката- 
логе Гогтз в проекте Рогтз, входящем в группу проектов РогтКеюпСтоир, 
показано на рис. 5.6. Главная форма приложения содержит кнопку Файл (ее 
имя в приведенном далее коде ВОреп), которая позволяет загрузить выбран- 
ный пользователем графический файл. Выбранное изображение отображает- 
ся на форме в компоненте Пвабе1. Щелчок на кнопке ЗВСо]ог типа 
эрее4ВиНоп, расположенной над изображением, позволяет указать на изо- 
бражении точку, цвет которой надо использовать при формировании окна на 
основе этого изображения. По умолчанию используется цвет левой нижней 
точки изображения. При щелчке на кнопке она остается в утопленном поло- 
жении, а вид курсора изменяется — он приобретает форму пробника цвета. 
Если пользователь щелкнет, подведя курсор к любой точке изображения, то 
в квадратике рядом с кнопкой (компонент Ппаге2) отображается цвет этой 
точки. После того как нужный цвет установлен, пользователь может щелк- 
нуть на кнопке $ВСо]ог, она перейдет в ненажатое состояние, а курсор при- 
обретет обычный вид. 

Щелчок на кнопке Создать форму (ВСгеале} вызывает генерацию вспомога- 
тельной формы в соответствии с выбранным изображением и цветом. На 
рис. 5.6 б показан ряд подобных форм. Они помещены поверх окна программы 
У/ога, чтобы была понятнее их конфигурация. Показаны формы, построенные 
на основе изображений из файлов Ргоггат ЕИез \ Соттоп ЕЦез \ Вотапа 
орагеа \ Гтазез \ оразй \ 16Союг \ АТНЕМА.ВМР (стандартное изображение 
фирмы Вог|апа), Кизза.6тр (карта России) и Нта.фтр (черное кольцо на се- 
ром фоне). Два последних файла имеются на приложенном к книге диске в том 
же каталоге, в котором. находится проект Рогтз. 
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Рис. 5.6. Приложение создания _ Создание формы по изображению 
форм по изображениям (а) | | 
и созданные им формы 
на фоне окна \\№ога (6) 


ы т. м Вставка форнат Сервис Таблица 2 Правка 
сеа м а хам“; гих! У ВТ 10% -. 
: 4& Обычный + Бел х Ана! (2 == = АЕ 


виз | 


` Стр. 1:2 Разд 1 12766 На 4,5см Ст4 Кол ЗАП ИСАР ВАЛ №5“ русский Ро 5 


По умолчанию на главной форме в группе Вид формы (Ва@юоСгоир1) 
включена радиокнопка С изображением, а в группе Тип изображения (Ва@1о- 
Сгопр2) включена радиокнопка полное. Результат вы можете видеть в левом 
столбце на рис. 5.6 6. Области с заданным цветом удаляются из исходного 
изображения, регион вспомогательной формы строится по оставшейся части, 
и изображение переносится на эту форму. Выбор радиокнопки Без изображе- 
ния в группе Вид формы на главной форме делает то же самое, но не переносит 
изображение на созданную вспомогательную форму (см. формы в среднем 
столбце двух верхних рядов на рис. 5.6 6). Так что получается обычная форма 
причудливой конфигурации, на которой могут размещаться любые компо- 
ненты. | 

Можно заметить, что в рассмотренных режимах окна создаваемых форм 
получаются не сплошными, если указанный цвет используется не только как 
фон, но и встречается внутри изображения. На рис. 5.6 б в двух верхних рядах 
форм это не очень видно. Но в левой нижней форме имеется огромная дыра 
в середине. Исходное изображение, как было сказано выше, имеет одинако- 
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вый цвет фона и внутреннего круга. Поэтому внутренний круг удален из ре- 
зультирующей формы. В ряде случаев подобный эффект нежелателен. Избе- 
жать его позволяет радиокнопка контур в группе Тип изображения на главной 
форме приложения. Результат вы можете видеть в средней форме нижнего 
ряда на рис. 5.6 6. Выделен только контур изображения, а внутри него ника- 
ких дырок нет. Алгоритм этого режима сводится к следующему. В исходном 
изображении находится первая точка с цветом, отличным от заданного. Затем 
отслеживается контур — граница между пикселами заданного цвета и други- 
ми цветами. Когда контур замыкается, по нему строится регион вспомогатель- 
ной формы. Внутри контура цвета не анализируются, так что никаких изъя- 
тий внутри сформированной формы не производится. Правда, реализованный 
в приложении алгоритм ограничивается одним контуром. Если таких конту- 
ров в исходном изображении несколько, то будет построен только один из них. 
Например, в изображениях, использованных в двух верхних рядах 
на рис. 5.6 6, будет выделен какой-то один остров или даже отдельная точка. 
Алгоритм можно распространить на построение всех контуров изображения. 
В приложении это не сделано, чтобы избежать излишнего усложнения кода, 
которое снизило бы его наглядность. 

Выбор радиокнопки С пустым изображением в группе Вид формы создает фор- 
му обычной конфигурации, но с «дырой», которая соответствует изображению 
(правые формы на рис. 5.6 6). 

Теперь несколько слов о свойствах всех создаваемых форм. Поскольку они 
не имеют полосы заголовка, их невозможно перемещать обычным способом, 
и они не имеют системной кнопки, позволяющих их закрыть. Поэтому в фор- 
мах предусмотрена описанная в разд. 5.2.3 возможность их буксировки за лю- 
бую точку, а не только за полосу заголовка. Закрыть форму, не имеющую заго- 
ловка, можно клавишами А!-ЁЕ4. Но в формах этого приложения предусмотре- 
но также контекстное меню, всплывающее при щелчке правой кнопкой 
мыши, которое содержит команду Закрыть форму. Кроме того, это меню содер- 
жит команду Сохранить регион. Она позволяет сохранить в файле, указанном 
пользователем, регион формы. Без этой команды рассматриваемое приложе- 
ние было бы чисто демонстрационным. А так оно становится генератором ре- 
гионов, которые потом могут использовать другие приложения. В группе про- 
ектов РогтКезопСтоир имеется приложение РАеоп, иллюстрирующее ис- 
пользование региона, записанного в файл, при построении формы. В форме 
приложения ЕАеоп конкретное имя файла (“Вей.гхп”) записано в виде кон- 
станты ЕИеМаще. Так что конфигурация создаваемой формы определяется ре- 
гионом, запомненным в файле с этим именем. Естественно, имя файла в при- 
ложении можно изменить. 

Главную форму приложения Гогтз вы видите на рис. 5.6 а. Все помещен- 
ные на ней компоненты перечислены выше, кроме диалога ОрепР1сёигеП1а1о51, 
обеспечивающего выбор открываемого файла изображения. В компонент Ппа- 
;е1 загружено изображение, которое показано на рис. 5.6 а. Как говорилось ра- 
нее, это изображение пользователь может изменять щелчком на кнопке Файл. 

Во вспомогательной форме свойство Вогдег5{Уе задано равным 6$М№опе, 
чтобы убрать полосу заголовка. На форме находится компонент [пабе], в ко- 
торый может переноситься изображение из главной формы, диалог сохране- 
ния в файле Зауе01а1о21 и компонент всплывающего меню РорирМепи1{. 

Начнем рассмотрение кода модуля главной формы (файл ИРГогтз2) 
со вспомогательных функций: 
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#10пс1аае "ОРогм$3.В" 


ТСо1ог Со1огТгапз; // прозрачный цвет 
соп$Е ТСигзог сгРеп = 1; // курсор указания цвета 
Иена ------------------ 


01а _ Еаз®кса11 ТКГогт1: : ГогшСкеа®е (ТОБ)есе *5епаег) 


{ 


Зсгееп->Сиагзог$ [сгРеп] = ГоааСагзохг (НТпзбапсе, “"СОВЗРЕМ"); 
бееСо1ог (0, Тмаде1->Р1скаге->Нелайе - 1); 


\у01А _ Еаз®са11 ТГоги1: : 5е Со1ог (116 Х, 116 У) 
{ 


Со1огТгап$ = Тимааде1->Сапуаз->Р1хе1$[Х] [У]; 
Тпадче2->Сапуаз->ВгизВ->Со1ог = Со]1огТгап$; 
Тпаче2->Сапуаз->Е111КВес® (Тмаде2->С11епеВес®);. 


\01А __Еазса11 ТГогт1: : 5ВСо1огС11сК (ТОБ]ес®е *5епаег) 
{ 


1Е (бсгееп->Сиагзог == сгРеп) 
бсгееп->Сигзог = сгреЁЕаи]1*; 
е15е 5сгееп->Сагзог = стРеп; 


01а __Еаз®са11 ТЕогм1: : Тмаде1Мочзеромт (ТОБ)есе *5епаег, 
ТМоизеВае оп Ваебоп, Т5В1Е баке $5В1ЕЕ, 116 Х, 116 У) 


{ 
1: (Зсгееп->Сиагзог == суРеп)} 
бееСо1ок (Х, У); 


\01А __Еаз®са11 ТЕГоги1: :ВОрепС11сК (ТОБ)ес®е *5епаег) 


{ 
1Е (ОрепР1скигер1а1о0о91->Ехесиее ()) 


{ 
Тпаче1->Р1скаге->оаЯЕгомЕ11е (ОрепР1сбагер1а1о391->Е11еМате); 


ЗееСо1ог (0, Ттаде1->Р1сеиге->Незайе - 1); 

1Е (Тмаде1->ВоопазВесе.Взайе > Еогт1->С11еп И1аЕй - 10) 
Роги1->С11еп ИтаЕр = Тмаде1->ВоппазКесе.В1айе + 10; 

1Е (Ттаде1->ВоцпазВесе.Воеком > ЕГоги1->С11епеНезаве - 10) 
ЕКоги1->С11епЕНел1аре = Тпаде1->ВоипазВесе.ВоЕбом + 10; 


} 

} | 

Директива 1аа4е дает ссылку на файл вспомогательной формы ОГРогтз3. 
Глобальная переменная Со]огТгап$ хранит цвет, выбранный как "прозрач- 
ный”, т.е. вырезаемый из региона. Глобальная константа егРеп задает иденти- 
фикатор курсора, используемого в приложении для выбора цвета. Этот курсор 
создан в файле ресурса проекта под именем “"СОВЗРЕМ”. Процесс создания не- 
стандартных курсоров в ресурсах описан в разд. 4.1.2. | 

Функция ЕогтСгезж{е является обработчиком события ОпСгеазе формы. 
В этом обработчике регистрируется курсор, извлекаемый из ресурсов функци- 
ей ГоааСигзог. Затем вызывается описанная ниже функция $е{Со]ог, в кото- 
рую передаются координаты левого нижнего угла изображения в Ппабе1. 
Функция Зе Со]ог по переданным в нее координатам определяет цвет пиксела 
с этими координатами и заносит его в переменную Со]огТгап$. Затем этот цвет 
передается в кисть компонента (пабе? (квадрата над изображением — 
см. рис. 5.ба), и этот компонент закрашивается указанным цветом с помощью 
метода ЕШВес+. 
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Функция ЭВСоогСПеК является обработчиком щелчка на кнопке выбора 
цвета. Каждый щелчок приводит к переключению вида курсора между обыч- 
ным и сгРеп. Функция Ппабе1 Моизедомп — обработчик нажатия кнопки 
мыши над компонентом Ппазе1. Если в данный момент вид курсора соответст- 
вует сгРеп, то вызывается описанная выше функция ЗеёСо]юог, в которую пере- 
даются координаты курсора. Это обеспечивает фиксацию цвета точки, указан- 
ной пользователем, как "прозрачного". 

Функция ВОрепСЦсК является обработчиком щелчка на кнопке Файл. 
В этом обработчике сначала вызывается диалог открытия файла. Затем вы- 
бранное пользователем изображение загружается в Ппабе1. Вызовом функции 
Зе{Со]ог устанавливается в качестве прозрачного цвет нижнего левого угла 
изображения. Затем, проверяются размеры компонента Ппабе1. В этом компо- 
ненте свойство Ащфо512е равно фгие, так что размеры компонента соответству- 
ют размерам изображения. Если изображение не помещается на форме, то раз- 
меры формы соответствующим образом увеличиваются. 

Мы рассмотрели все вспомогательные функции модуля. Теперь остано- 
вимся на главной функции — обработчике щелчка на кнопке Создать форму. 
Пока рассмотрим код этой функции в сокращенном виде: 


У01Аа __Еаз®са11 ТЁГогм1:; :ВСгеа®еС11сКк (ТОБ)]есЕ *5епаег) 
{ 
Зсгееп->Сигзог = сгНочгС1аз$$; 
НКСМ МуВедлоп, МуВедтоп2; 
МуБеатоп = 0; 
1Е (Ва4Я1оСгопр2->ТеепшТпаех == 0) 
{ 
// вариант полного поиска прозрачного цвета 
116 70 = -1; // начало ряда пикселов непрозрачного цвета 
Рог (1106 1 = 0; 1 < Тпаде1->Не1апе; 1++) 
// цикл по строкам 
{ 
90 = -1; | 
Еог (1106 7 = 0; 1 < Тпаде1->мМлаев; 9++) 
// цикл по пикселам строки 
{ 
1Е (Ттаче1->Сапуа$->Р1хе1$[7] [1] != Со1огТгапз) 
// непрозрачный цвет 
{ 
// если ряд непрозрачных пикселов не начат, он начинается 
1Е(70 < 0) 710 = 3; 
} 
е1 зе // прозрачный цвет 
1Е(50 >= 0) | 
// если есть ряд непрозрачных пикселов, 
// то он добавляется в регион 
{ 
1Е(! МуВедтоп) 
{ 
МуВед1оп = СгеабеВес® Вот (70, 1, 3}, 1+1); 
} 
е1зе 
{ . 
МуКеач1оп2 = СтеафеВвВес®Воп (730, 1, 7], 1+1); 
Сопр1пеВап (МуВед1оп, МуВед1оп2, МуВед1оп, ВСМ_ ОВ); 


} // конец цикла по 7 - по пикселам строки 
1Е(70 >= 0) 
[ 
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// ряд непрозрачных пикселов обрывается на границе области 
1Е(! МуВеад1оп) 

{ 

МуКез1оп = СгеафеВес®Вап (710, 1, Ттаде1->и1аеВ - 1, 1+1); 
} 

е1зе 

{ 

МуВеяч1оп2 = СгеакевВес®Воап (30, 1, Тмаде1->итаев - 1, 

1+ 1); 

Сотр1певВап (МуБеа1оп, МуВед1оп2, МуВедтоп, ВСМ_ ОВ); 

} 
} 


} // конец цикла по 1 - по строкам 


} // конец Каа1обгоир2->ГЕетГТпаех = 0 
е15е 
// вариант контурного изображения 


{ 
} 


// создание формы заданного типа 
Арр11саЕ1оп->Сгеа®еГогм (___с1а$$14 (ТГогм2), &Гогм2); 
1Е (Тмаде1->\таЕеВ > Гоги2->С11еп 6 Итаеь - 10) 
Рогт2->С]1епЕИ1аЕВ = Ттаде1->мтаев + 10; 
1: (Ттаде1->НезаВе > Гоги2->С11епНезапе - 10) 
Роги2->С11епЕНе1апЕ = Тмаде1->Незайе + 10; 
Гоги2->Тмаде1->Тор = 0; 
ГКоги2->Ттаде1->ЪеЕ® = 0; 
1Е (Ва@а1оСбгопр1->ТеешТпаех == 0) 
// создание изображения 
Гоги2->Тмаде1->Р1сбаге->Азз1ап (Ттмаде1->Р1сЕоге)}; 
// удаление изображения | 
е1зе Гогп2->Ттаде1->Егее(); 


1Е (Ваа1оСкопр1->ТЕешТпаех ==’ 2) 

{ 

// формирование разности регионов ВИ 

МуВед1оп2 = СгеафевВес®Вап (0, 0, Еогт2->М1аЕв-1, 
Еоги2->Не1ар&-1); 

Сопр1пеВап (Мувеч1оп, МуВед1оп2, МувВед1оп, КСМ РОТЕЕ); 

} 

// запоминание региона в форме Гогт2 

Гоги2->ВепВап (МукКеа1оп); 

// задание региона форме Гогт2 

ЗесИ1паомКапт (Еогт2->Напа1е, МуВед1оп, $гае); 

РГоги2->5Вом (); 

Зсгееп->Сигзог = сгреЁао1*; 


} 


В приведенном коде пропущен фрагмент, обеспечивающий отслеживание 
контура. Этот фрагмент, соответствующий выбору радиокнопки контур в груп- 
пе Тип изображения (см. рис. 5.6 а) мы рассмотрим позднее. 

Первый оператор изменяет вид курсора на «песочные часы», поскольку 
в большом изображении создание региона может занимать заметное время. 
Объявляются два дескриптора регионов МуВеё1оп и МуВег10оп2, первый из 
которых задается нулевым. Затем следуют вложенные циклы, перебирающие 
все пикселы изображения. Задача заключается в том, чтобы найти в каждой 
строке изображения последовательности прилегающих друг к другу пикселов 
с цветом, отличным от заданного значения СоогТгапз$, и все такие последова- 
тельности добавить в формируемый регион. Начальный индекс каждой такой 
последовательности запоминается в переменной 10. При переходе к каждой но- 
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вой строке этой переменной присваивается значение —1, свидетельствующее 
о том, что пока начало последовательности не обнаружено. Если в процессе 
цикла по пикселам строки обнаруживается пиксел цвета, не равного Со]ог- 
'Тгап$, и при этом 10 = -1, то индекс этого пиксела запоминается в 10. А если 
обнаруживается пиксел цвета, равного Со]огТгап$, и при этом значение }0 не 
отрицательное, значит, перед этим была обнаружена последовательность не- 
прозрачных пикселов, которая в данный момент прервалась. Тогда, если реги- 
он МуВегР1оп еще не начал формироваться, то в него функцией СгеафеВес Вт 
заносится обнаруженная последовательность индексов пикселов. А если Му- 
ВБег1оп уже ненулевой, то найденная последовательность индексов заносится 
в регион МуКВер1оп2, а затем этот регион объединяется с МуВег1оп функцией 
СошЬтевВргп. В заключение задается 10 = —1, и продолжается поиск очередной 
последовательности непрозрачных пикселов. 

После просмотра каждой строки проверяется значение 10. Если это значе- 
ние неотрицательно, значит, была обнаружена последовательность непрозрач- 
ных пикселов, которая оборвалась на границе изображения. Тогда эта после- 
довательность описанным выше способом добавляется в регион. 

По окончании циклов по всем пикселам регион МуВе5ё1оп сформирован, 
и можно создавать объект формы с таким регионом. Методом АррПеаН- 
оп->СгезеГогт создается объект вспомогательной формы Еогтё. Если раз- 
меры созданной формы меньше размеров изображения, по которому формиро- 
вался регион, то проводится соответствующая корректировка размеров фор- 
мы. Имеющийся на форме Еогт2 компонент Ппае1 перемещается в ее левый 
верхний угол. Если в группе радиокнопок Вид формы выбрана кнопка с изобра- 
жением, то в компонент Пптаге1 формы Еогт? переносится изображение из 
компонента Ппазе1 главной формы. Если кнопка с изображением не выбрана, 
то компонент Ппахе1 формы Еогт2 уничтожается. 

Затем проверяется, не выбрана ли кнопка с пустым изображением. Если вы- 
брана, то из площади вспомогательной формы надо вырезать сформированный _ 
ранее регион МуВег1оп. Тогда функцией СгезеВес В оп создается регион 
МуВе?210п2, соответствующий всей поверхности формы Еогт2. Затем функци- 
ей СотЫпеВеп формируется разность регионов МуВе?г1оп и МуКерг1оп2. Ре- 
зультат заносится в регион МуВергл1оп. 

После того как регион вспомогательной формы полностью сформирован, 
вызывается функция этой формы ВетВтп, которая будет рассмотрено далее. 
Ее задача — запомнить в объекте формы ее регион, чтобы потом в случае необ- 
ходимости его можно было перенести в файл. Запоминать регион надо до того 
момента, как он будет использован функцией Зе \т4омВоп, так как после 
этого он будет удален. Заключительные операторы показывают пользователю 
созданную вспомогательную форму и возвращают курсору обычный вид. 

Теперь рассмотрим код модуля вспомогательной формы. 

Фрагмент заголовочного файла: 

с1азз ТЕГогм2 : риб11с ТЕГогм 


{ 


рг1уаее: 
106 ХО, У0; // начальные координаты курсора 
Боо1 1Моуе; // флаг буксировки 
ТРВСМРАТА Р; // указатель на буфер данных региона 
ОРМОВО МВеа; // размер буфера данных региона 
рур11с: 
‚ __Еаз®са11 ТЕГогм2 (ТСотропеп®* Омпекг); 
Уу01А __Газ®са11 ВетВап (НВСМ ВСМ); 
}; 
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Файл реализации: 
Уу01А __Еазеса11 ТЕГогп2 : : ВетВоап (НАСМ ВСМ) 
{ 
МВез = сСееведч1опрака (ЕСМ, 0, №011); 
Р = ( ВСМРАТА *)ма11ос (№Вед); 
СсесВед1опрафа (КСМ, МВедз, Р); 


у01А _ Еазеса11 ТГогм2: :№2С11сК (ТОр]ес® *5епаег) 
{ 
1Е (бауер1а1о91->Ехесиее ()) 
{ 
ЕТЬЕ * Е; 
Е = Еореп (5$ауер1а1о31->Е11еМмаме.с_з%г(), "мь"); 
ЕмгтЕе (&МВед, з1теоЕ (2МОВО),1,Е); 
Еиг1фе (Р,№Веа,1,Е); 
Ес1озе(Ё); 


ИНН ------ 
У01А __Еазеса11 ТГоги2::Гогирезе гоу (ТОБ]есе *5епаег) 

{ 

Егее(Р); 

} 
Иинннннннннннннннннннн=н+--=======-==-====--==----- 


у01А __ЕазЕса11 ТГогм2: : КогиМочзероип (ТОБ]есе *5епаег, 
ТМочзеВае оп Ваббоп, Т5В1ЕЕббаее $5Р1Еф, 1пЕ Х, 11% У) 
// начало буксировки, запоминание координат и установка флага 


ХО =хХ; 

УО У; 

} 

ее енененннннннн-----=- 


014 _ Еаз®са11 ТРГогт2: : КогиМоцзеМоуе (ТОБ)ес® *5епаег, 
ТРЕЕ баее 5Р1ЕЕ, 11% Х, 110% У) 

// продолжение буксировки, изменение координат - 
{ , 

1Е (ТМоуе) 

{ 

ТВесе К = ВоипазВесЕ; 

В.ЪеЕЕ += Х - хХО0; 

ВК.Вларе += Хх - ХО; 

ВК.Тор += У - 0; 

В.Воефом += У - У0; 

ВоцпазВесЕ = В; 


} 


Уу01А __Еаз6са11 ТГогт2: : ГогиМочзе0р (ТОБ]есЕ *5епаег, 
ТМонзеВа оп Виббоп, Т5Р1ЕЕб бабе $01Е6, 11% Х, 110% У) 
// окончание буксировки, сброс флага 


{ 


Т1Моуе = Еа1<е; 


у014 __ЁЕаз&са11 ТЕГогм2: :№1С11сК (ТОБ]есе *5епаег) 


{ 
С1о$е (); 


} 


В классе формы объявлено несколько закрытых переменных. Переменные 
ХО, У0, ГМоуе используются для буксировки формы с помощью мыши. А пе- 
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ременные Р и №ЁКех определяют буфер, в котором хранятся данные региона 
формы. В классе также объявлена открытая функция ВетВеип, которая запо- 
минает данные региона, дескриптор которого передан в нее как параметр. Как 
вы видели, эта функция вызывается из главной формы, и в нее передается де- 
скриптор сформированного региона. 

Функция использует вызовы функции @аеВегопОаёа, которая была опи- 
сана в разд. 5.2.2.1. Первый вызов возвращает в МВех размер буфера, необхо- 
димого для хранения данных. Следующий оператор выделяет в памяти функ- 
цией таПос требуемое место для буфера и возвращает указатель на него в Р. 
Последний оператор запоминает в буфере данные региона. 

Функция М2СПеК является обработчиком щелчка на разделе Сохранить ре- 
гион всплывающего меню формы. Обработчик вызывает диалог сохранения 
в файле, создает двоичный файл функцией #ореп, записывает в него функцией 
ГугЦе размер буфера МВех, а затем записывает в файл содержимое буфера Р. 

Обработчик ЕогиОе$гоу события Опезёгоу формы удаляет из памяти 
буфер Р. Обработчики ЕогтМоц5едомп, ЕогтМоизеМоуе и ЕогтМосзе Ор со- 
бытий, связанных с мышью, мы рассматривать не будем. Эти обработчики, 
обеспечивающие буксировку формы за любую ее точку, подробно рассмотрены 
в разд. 5.2.3. Функция М1СИсК является обработчиком щелчка на разделе Зо- 
крыть всплывающего меню формы. 

Рассмотрим теперь проект РАебюп, который демонстрирует использова- 
ние запомненных в файле данных региона. В форме этого приложения свойст- 
во Вогдег5{Уе задано равным 6$Мопе, чтобы убрать полосу заголовка. Следо- 
вательно, утеряна возможность управлять формой с помощью системного 
меню. Поэтому форма содержит всплывающее меню, обеспечивающее сверты- 
вание, восстановление и закрытие окна. Никаких других компонентов на фор- 
ме нет, хотя вы, конечно, можете поместить на ней все, что требуется. В заго- 
ловочном файле в классе формы объявлены переменные ХО, У0, Г.Моте, ана- 
логичные рассмотренным во вспомогательной форме, которые используются 
для буксировки формы с помощью мыши. Код файла реализации модуля име- 
ет вид: 


соп5Е Ап$156г1па Е11еМатме = "Вед.гап"; 


уо1а __ аз®са11 ТЕоги1 : : ЕогиСгеаее (ТОБ]есф *бепаег) 
{ 


ЕТЬЕ * Е; 

РИОВО М; 

1Е (! Е11еЕх1 56$ (Р11еМапе) ) 

{ 

ЗВомМеззаае ("Файл '" + Е11еМатше + "' не найден\п" + 
"Приложение закроется"); 

С1о5е (); 

} 

Е = Еореп (Е11еМаме.с _з%к(), "кЬ"); 

Егхеаа (&М, з1теоЕ (ОИОВрО),1,Е); 

ТРЕСМРАТА Р = ( ВСМПОАТА *)та11ос (№); 

Егеаа (Р,М,1,Е); 

Ес1озе (Е); 

НВСМ МуВКед1оп = Ех®Сгеа*еВеатоп (МОЬЬ, М, Р); 

Егее (Р); 


ЗеЕИ1паомКап (Напа1е, МуВедтоп, &гае); 


\01А __Еазса11 ТГогм1; : КогиМочзеромт (ТОр]есе *5епаег, 
ТМоизеВа* оп Виефоп, ТРЕЕ бфафее $5Ь1ЕЕ, 1пе Х, 110% У) 


{ 
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Т1Мохе = Егае; 
ХО =х; 


< 

>) 
| 

-< 


Уу01А _ Еазеса11 ТКогш1: : КогиМочзеМоуе (ТОр)есЕ *5епаег, 
Т5В1ЕЕ5баке $501Е6, 1пЕе Х, 1106 У) 
{ 

1Е (ТМоуе) 

{. 
ТВесЕ В = ВоцпазВесе; 
В.ТеЕЕ += Хх - ХО; 
В.В1апе += Х - ХО; 
ВК.Тор += У - У0; 
В.Воееом += У - У0; 
Вочпа$Весе = В; 


у01А _ Еазса11 ТКГогм1 : : ГогиМочзе0р (ТОБ]есе *5епаег, 
ТМоцзеВае оп Виаебоп, Т5Р1ЕЕбЕаее ЗР1ЕЕ, 110 Х, 110Е У) 


{ 


ТМоуе = Еа1з$е; 

} 
Инннннннннннннннннн==========-========-=-=-=-=-==-=- 
у01А _ Еаз®са11 ТКогм1: :№1С11сК (ТОБ)есЕ *5епаег) 

{ 

С1озе (); 

} 
Иннннннннннннннннн-============================== 


у01А _ ГЕаз®са11 ТРГогм]1 : :№2С11сК (ТОр)есе *5епаег) 


{ 
зепаМеззаде (Арр11са*1оп->Напа1е, ИМ 5$У$СОММАМО, 


$С_МТМТМТАЕ, 0); 


у01А _ Еаз®са11 ТКогш1: :№3С11сК (ТОБ)]есе *5епаег) 


{ 
бепаМеззаде (Арр11са&1оп->Напа1е, ИМ 5У$СОММАМО, 


$С ВЕЗТОВЕ, 0); 
} 


В файле объявлена переменная ЕПеМате, в которой записано имя файла, 
содержащего данные какого-то региона. Массивы такого рода создаются рас- 
смотренным выше приложением Гогтз. Так что вы можете изменить имя фай- 
ла, чтобы использовать регион любой формы, созданной вами с помощью этого 
приложения. | 

Основной интерес в приведенном коде представляет обработчик РГогт- 
Сгтеже события ОпСгез{е формы. В нем открывается заданный файл и из него 
читается сначала размер буфера, который необходимо выделить под данные 
региона. Затем этот буфер создается, и в него читаются хранящиеся в файле 
данные. Функцией Ех Сгез&еВег1оп, рассмотренной в разд. 5.3.1, создается 
регион по этим данным. А затем функцией Зе \’ш4ом Вот этот регион соеди- 
няется с формой. В результате форма приобретает форму региона, данные ко- 
торого хранились в файле. — 

Функции ЕогтМоцзердомп, ЕогтМоцзеМоуе, ЕогтМоцзеОр не отлича- 
ются от приведенных ранее в описании вспомогательной формы проекта 
Гогтз. А функции М№1С|еК, М2СПНек и МЗСПеК являются обработчиками раз- 
делов всплывающего меню, обеспечивающих соответственно закрытие, свер- 
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тывание и восстановление формы. При этом используются операторы работы 
с системными меню, рассмотренные в разд. 5.2.1. 


Мы пока пропустили рассмотрение алгоритма построения региона по кон- 
туру изображения, которое происходит, если в окне главной формы, показан- 
ном на рис. 5.6 а, включена в группе Тип изображения радиокнопка контур. Этот 
алгоритм сводится к следующему. Сначала просматриваются по строкам пик- 
селы изображения, пока не встретится первый символ с цветом, отличным от 
Со]огТгап$. Найденная точка — первая в искомом контуре. Далее следует наи- 
более сложная часть алгоритма — отслеживание линии контура. Вокруг теку- 
щей точки контура надо найти такую примыкающую к ней точку, которая бы 
имела цвет, отличный от СоюогТгапз, еще не была на предыдущем шаге вклю- 
чена в контур и соседствовала бы с точкой, имеющей цвет Со]огТгапз, или 
с точкой границы изображения. Такая примыкающая точка и будет следую- 
щей точкой контура. Построение контура продолжается до тех пор, пока кон- 
тур не замкнется. Замыкание контура произойдет, когда очередная точка кон- 
тура совпадет с начальной. 

Рассмотрим подробнее процедуру поиска очередной точки контура. Для 
этого используется двумерный массив А[3] 3]. Каждый элемент массива ото- 
бражает один из пикселов, расположенных вокруг пиксела, соответствующего 
текущей точке контура. Информация в массиве кодируется с помощью объяв- 
ленного в коде перечислимого типа: | 


епим Тбе11 {Мопе, МТгапз$, СопЕ, Тгапз$, Вочпа}; 


где М№опе означает неизвестен тип пиксела, Тгап$ — прозрачный, МТгап$ — 
непрозрачный, Воип@ — граница, Сопё — предыдущая точка контура. Напри- 
мер, в некоторый момент массив А может иметь вид: 


А[0] [0] = Тгап$ А[0] [1] = МТгапз$ А[0][2] = М№МТкапз 
А[1] [0] = Тгапз А[1] [1] = СорЕ А[1] [2] = М№МТкапз 
А[2] [0] = СорЕ А[2] [1] = МТхгапз$ А[2][2] = МТгкапз 


В центре (А[ 1] 1]) расположена текущая точка контура. Ее тип, естествен- 
но Сопф. Слева и справа от нее расположены соответственно точки типов Тгап$ 
и М№МТгап$, так что средняя точка, действительно, относится к контуру. В пози- 
ции А[2]0] расположена точка типа Соп — предыдущая точка контура. 
В верхнем ряде слева одна точка типа Тгапз, а за ней следуют две точки типа 
МТгап$. Значит, в рассмотренной ситуации следующая точка контура — точка 
А[0]1]. | 

После того как это установлено, центр анализируемой области надо пере- 
местить в новую точку контура, которая теперь станет центральной. Это зна- 
чит, что содержимое массива А надо сдвинуть на строку вниз. Новые значения 
элементов массива будут следующими: 


А[0] [0] = №юпе А[0] [1] = №юпе А[0][2] = №пе 
А[1] [0] = Тгапз$ А[1] [1] = СорпЕ А[1] [2] = МТгапз 
А[2] [0] = Тгапз А[2] [1] = СопЕ А[2] [2] = М№МТгкапз 


Новая нижняя строка — это прежняя средняя строка. Новая средняя стро- 
ка — это прежняя верхняя, но в ней указан тип Соп для выбранной перед 
этим новой точки контура. Все элементы новой верхней строки пока имеют 
тип М№опе. Это значит, что истинный тип трех соответствующих пикселов надо 
будет определить на основании их цвета. 

Мы рассмотрели один шаг поиска новой точки контура в одной конкрет- 
ной ситуации. Аналогично организуется шаг поиска в других возможных си- 
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туациях. Так что, думаю, после приведенного краткого описания можно по- 
смотреть, как подобный алгоритм реализован`в приложении. Должен сразу 
оговориться, что приведенный ниже код далеко не самый компактный. Не- 
трудно было бы его свернуть. Но хитросплетения индексации затруднили бы 
понимание сути выполняемых операций. Поэтому некоторые участки кода, 
которые можно было бы представить циклами, я оставил развернутыми. 

Ниже представлен код, являющийся частью рассмотренной ранее функ- 
ции ВСгежеСПсК главной формы приложения Гогтз. 


У01Я __Еаз®са11 ТЕоги1: :ВСгеасеС11сКк (ТОБ)есЕ *бепаег) 
{ 

эсгееп->Сагзог = схНочгС1а$$; 

НВСМ МуВеа1оп, МуВКед1оп2; 

МуБеад1опт = 0; 

1Е (ВаЯ1обгопр2->ТеешТпаех == 0) 

{ 


} // конец ВКа41обгоир2->ТеЕетГпаех = 0 
е15е 

// вариант контурного изображения 

{ 

// для поиска контура 

// типы ячеек: М№пе - неизвестен, Тгапз - прозрачный, 
// МТгапз - непрозрачный, ВоипА - граница, 

// СопЕ - предыдущая точка контура 

епиш Тбе]11 {№пе, МТгкапз$, СопЕ, Тгапз$, Воцпа}; 

Т5е11 А[3] [3]; // массив ячеек | 


// Заполнение массива А значениями М№пле 
петзеф (А, М№опе, 9); 


ТРо1пЕ *Р = №11; // массив угловых точек региона 
10е 1парР = 0, // число элементов в массиве Р 
10 = 0, 70 = 0; // координаты предыдущей точки - 


//центра области А 
// поиск первой точки контура 
Боо1 Тгапз0 = Тмаае1->Сапуаз->Р1хе1$[0] [0] == Со1огТгапз; 


Бог (106 1 = 0; 1 < Гтааде1->Нелаве; 1++) 
// цикл по строкам 
{ 
Рог (106 7} = 0; 1 < Тпадет->и1аев; 3++) 
// цикл по пикселам строки 
{ 
1Е ( (Ттмаде1->Сапуа$->Р1хе1$[7] [1] == Со]огТгапз) != Тгапз0) 
{ 
// точка найдена 
Р = (ТРо1пЕ *)тма11ос ($12еоЕ (ТРо1п®)); 
// занесение точки с непрозрачным цветом 
1Е (Тгапз0) 


РГО] = Ро4пе (3 , 1); 
е15е 
Р[О] = Ро1пЕ (50, 10); 
1паРрР++; 
// заполнение массива А 
А[1] [1] = МТгхапз; 
1Е(Р[0].х == 0) 
А[0][0] = А[ 1] [0] = А[2][0] = Воцпа; 
1Е(Р[0О].х == Тмаде1->изаев - 1) 
А[0] [2] = А[1] [2] = А[2][2] = Воапа; 
ЗЕ(Р[О].у == 0) 
А[ 0] [0] = А[ О] [1] = А[ 0] [2] = Вочпа; 
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1Е(Р[0].у == Тмаде1->Нелаве - 1) 
А[2] [0] = А[2] [1] = А[2] [2] = Воцпа; 
ЬгеаК; | 
} . 
-е15е 
{ 
10 = 1; 
30 = 3; 
} 
} // конещ цикла по 7 - по пикселам строки 


// прерывание. цикла, если в Р занесена точка 
1Е(Р) ргеаК; 
} // конец цикла по 1 - по строкам 


50 = Р[1пар-1].х; 
10 = Р[1парР-1].у; 


// цикл по контуру 
Чо 
{ 
// заполнение в массиве А элементов неизвестного типа (№пе) 
Рог (116 1 = 0; 1 < 3; 1++) 
Бог (10% м = 0; шп < 3; п++) 


{ 


1Е(А[1] [м] == М№опе) | 
1Е (Ттаде1->Сапуа$->Р1хе1$[710+м-1] [10+1-1] == Со1огТгап$) 
А[1] [м] = Тгапз; 
е]1 зе 
А[1] [ш] = МТгапоз; 
} 
А [1] [1] = СорЕ; 
106 110 = -1, п = -1; // индексы новой точки контура 


// поиск следующей точки контура 


// проверка верхнего ряда 


1Е((А[0] [0] == МТгап$) && ((А[0] [1] == Тгапз) || 
(А[0] [1] == Вочпа))) 

{ 

п = 90 - 1; // новая точка контура 

ап = 10 - 1; 

| 
е1зе 1Е(((А[О] [0] == Тхгапз) || (А[0][0] == Воцпа)) && 

(А[О] [1] == МТхаплз$)) 

{ 

п = 70; // новая точка контура 

11 = 10 - 1; | 

} 
е1зе 1Ё((А[0] [1] == МТхгап$) && ((А[0][2] == Тгапз$) || 

(А[0] [2] == Вочпа) )) 

{ 

п = 70; // новая точка контура 

10 = 10 - 1; 

} 

е1зе 1Е(((А[0][1] == Тхгап$) || (А[0][1] == Вочпра)) && 

(А[0][2] == МТгапз)) 

{ 

п = 90 + 1; // новая точка контура 

10 = 10 - 1; 


// проверка нижнего ряда 
е1зе 1Е((А[2] [0] == МТгап$) && ((А[2] [1] 


== Тгап$) || 
(А[2] [1] == 


Войпа) ) ) 
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{ 


п = 90 - 1; // новая точка контура 
10 = 10 +1; 
} 
е]1зе 1Е(((А[2] [0] == Тхапз$) || (А[2][0] == Воипа)) && 
(А[2] [1] == МТгапз)) 
{ 
п = 70; // новая точка контура 
11 = 10 +1; 
} 
е1зе 1Е((А[2] [1] == МТгап$) && ((А[2][2] == Тгапз) || 
(А[2] [2] == Воппа))) 
{ | 
эп = 90; // новая точка контура 
11 = 10 + 1; 
} 
е1зе 1Е(((А[2] [1] == Тгап$) || (А[2][1] == Вопра)) && 
(А[2] [2] == МТгапз)) 
{ 
п = 90 + 1; // новая точка контура 
11 = 10 +1; 
}. 
// проверка первого столбца 
е1зе 1Е((А[0] [0] == МТгап$) && ((А[1][0] == Тгапз) || 
| (А[11[0] == Воипа) )) 
{ 
п = 90 - 1; // новая точка контура 
11 = 10 - 1; 
} 
е1зе 1Е(((А[0] [0] == Тхгапз$) || (А[0][0] == Воцпа)) && 
(А[1] [0] == МТгапз)) 
{ 
уп = 70 - 1; // новая точка контура 
11 = 10; 
} 
е1зе 1Е((А[1] [0] == МТгап$) && ((А[2][0] == Тгапз) || 
(А[2][0] == Воцпа))) 
{ 
эп = 70 - 1; // новая точка контура 
11 = 10; 
} 
е1зе 1ЁЕ(((А[1] [0] == Тгапз) || (А[1][0] == Воцпа)) && 
(А[2] [0] == М№МТгапз)) 
{ 
п = 30 - 1; // новая точка контура 
11 = 10+1; 
} 
// проверка последнего столбца 
е1зе 1Е( (А[0] [2] == МТгкап$) && ((А[1][2] == Ткапз) || 
(А[1] [2] == Воппа))) 
{ 
п = 70 + 1; // новая точка контура 
11 = 10 - 1; 
} ь 
е1зе 1Е(((А[0][2] == Тгапз) || (А[0] [2] == Вочзпа)) && 
(А[1] [2] == МТгапз)) 
{ | 
п = 70 + 1; // новая точка контура 
11 = 10; 
} 
е1зе 1Е((А[1] [2] == МТгап$) && ((А[2][2] == Тгапз) || 


(А[2] [2] == Воппа))) 
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{ 


эп = 90 + 1; // новая точка контура 
11 = 10; 

} 

е1зе 1Е(((А[1] [2] == Тгап$) || (А[1][2] == 

(А[2] [2] == МТгапз)) 

{ 

п = 70 + 1; // новая точка контура 
11 = 10 + 1; 

} 

1Е(1п.>= 0) 


// точка найдена 
ТЕ (1пАР > 1) 
// проверка, не лежит ли новая точка 
// на одной прямой с предыдущими 
1Е((1п - Р[1пар-1].у) * 
(Р[1пар-1].у - Р[1пар-2].у) * 
// исправление последней точки 
Р[1пар-1] = Ро1п®(7)п, 11); 
е1зе 
// занесение новой точки 


{ 
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Воцпа)) && 


// если точек в Р не меньше 2 


(Р[1пар-1].х - Р[1парР-2].х) == 
(4п - Р[ПпарР-2].х)) 


если точек в Р не меньше 2 


Р = (ТРо1пЕ *)геа11]ос (Р, ++1пар * $з17теоЕ (ТРо1п®)); 
Р[1пар-1] = Ро1пё (п, 11); 

е1зе // занесение новой точки, 

{ 

Р = (ТРо1пЕ *)геа11ос (Р, ++1паР * $з127еоЕ (ТРо1п®)); 
Р[1пар-1] = Ро1п®(7п, 11); 


} 


// переформирование массива А 
1Е (10 > 10) // точка сместилась вниз 
// сдвиг А вверх 


{ 


Бог (10 1 = 0; 1 < 2; 1++) 
Бог (1106 7) = 0; 71 < 3; 13++) 
А[11 [2] = А[1+11 [3]; 
1Е(1п == Тмаде1->Незаре - 1) 
А[2][0] = А[2] [1] = А[2][2] = Воцпа; 
е1 зе 
{ | 
1Е()п == 0) 
А[2] [0] = ВоцпяЯ; 
е1зе А[2] [0] = №пе; 
А[2] [1] = №пе; 
1Е()п == Тпаде1->изаеь - 1) 
А[2] [2] = Воапа; 
е1зе А[2][2] = №те; 


} 
} 
е1зе 1ЁЕ(1п < 10) 


// сдвиг А вниз 
{ 
Бог (10 1 =2; 1 > 0; 1--) 
Рог (1106 7 = 0; ) < 3; 3++) 
А[1] [53] = А[1-1] [5]; 
1Е (10 == 
А[0] [0] = А[ О] [1] = А[0][2] = Воцпа; 
е1 зе 
{ 
1Е()п == 0) 
А[0] [0] = Воола; 
е1зе А[0][0] = №пе; 


// точка сместилась вверх 
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А[0] [1] = №пе; 
1Е(]п == Тмаде1->мтаев - 1) 
А[0] [2] = Воцпа; 
е1зе А[0] [2] = №пе; 
} 
} 
1Е()п > 30) // точка сместилась вправо 


// сдвиг А влево 
{ 

Рог (1106 3 = 0; 7 < 2; )++) 
Рог (106 1 = 0; 1 < 3; 1++) 


А[1] [3] = А[1] [3+1]; 
1Е(]п == Шпаде1->имтаев - 1) 

А[0] [2] = А[1] [2] = А[2][2] = Вочпа; 
е15е 
{ | 

1Е (ап == О0) 

А[0] [2] = Воопа; 

е1зе А[0] [2] = №пе; 

А[1] [2] = №тпе; 

1Е(1п == Тмаде1->Нелайе - 1) 

А[2] [2] = Вовпа; 

е1зе А[2] [2] = М№лпе; 


} 
} 
е1ъе 1ЁЕ()п < 730) 
// сдвиг А вправо 
{ 
Бог (108 } =2; 3 > 0; 3--) 
Бог (1106 1 = 0; 1 < 3; 1++) 


// точка сместилась влево 


А[1] [3] = А[ 1] [9-1]; 
1Е(п == 0) 
А[0] [0] = А[1] [0] = А[2] [0] = Воцпа; 
е]1 зе 
{ 
ТЕ (10 == 0) 
А[ О] [0] = Воцпа; 
е15е А[0] [0] = №тпе; 
А[1] [0] = №пе; 
1ЁЕ(1п == Тиаде1->Неланве - 1) 
А[2] [0] = Вочпа; 
е15е А[2] [0] = №пе; 
} 
} 
10 = 11; 
30 = )п; 
} 
е1зе 


ЗПомМеззасде ("Тупик"); 
БгеаКк; 

} 

} 


// проверка, не замкнулся ли контур 
\мр11е ((Р[1пар-1].х != Р[0].х) 
// Формирование региона 
МуВКед1оп = Сгеа®еРо1уаопВоп (Р, 
Егее (Р); 

} 


// создание формы заданного типа 
Арр11са&1оп->Сгеа%еКоги (__с1а5$1а (ТГогм2), 


1паР, АТТЕВМАТЕ); 


&РГогм2); 


} 


|| (Р[1парР-1].у != Р[0].у)); 
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Начинается код с объявления перечислимого типа ТЗей и массива А. Мас- 
сив заполняется с помощью функции тете значениями М№опе. Объявляется 
также указатель Р на будущий массив угловых точек контура региона. Пере- 
менные тР, 10, 10 будут соответственно хранить число точек в массиве Р 
и координаты предыдущей точки контура. Булевой переменной Тгап$0 задает- 
ся значение фгие, если цвет левой верхней точки изображения равен Со]ог- 
Тгап$, и Рае в обратном случае. 

После этих подготовительных операций начинаются вложенные циклы 
поиска первой точки контура. Она лежит на границе между областями пиксе- 
лов прозрачного и непрозрачного цветов. После того как такая граница найде- 
на, принадлежащая ей точка с непрозрачным цветом заносится в массив Р. 
Эта точка делается центральной в А. Проверяется, не являются ли точки, при- 
легающие к записанной в Р, граничными. Если являются, то они помечаются 
в А как точки типа Воип4. Тип остальных точек остается равным М№опе. Коор- 
динаты запомненной точки заносятся в переменные 10 и }Ю0. 

Далее следует цикл 40 ... ме по контуру. Для тех точек массива А, тип 
которых неизвестен, определяется цвет соответствующего пиксела и в соответ- 
ствии с этим их тип становится равным Тгап$ или МТгап$. Тип средней точки, 
уже включенной в контур, задается равным Сопф. Далее поочередно анализи- 
руются верхний и нижний ряд А, и левый и правый столбцы (эту часть кода 
можно записать более компактно). Как только где-то обнаруживается точка 
типа М№Тгап$, соприкасающаяся с точкой типа Тгап$ или Воип@, эта точка за- 
поминается как новая точка контура в переменных щш и т. Поиск новой точки‘ 
прерывается, и решается вопрос о занесении ее в массив Р. Если эта точка ле- 
жит на одной прямой с двумя предыдущими, то новая точка заменяет в масси- 
ве Р предыдущую и размер массива не увеличивается. Это позволяет в случаях 
регионов с прямолинейными участками границ существенно уменьшить раз- 
мер массива, определяющего будущий регион. 

После того как новая точка контура найдена, производится сдвиг инфор- 
мации массива А вверх, вниз (эта ситуация была подробно рассмотрена ранее), 
вправо или влево. Отмечу, что эту часть кода тоже можно существенно сокра- 
тить. Далее, если контур не замкнулся, начинается новый цикл поиска конту- 
ра. Если же контур замкнут, то с помощью функции СгежфеРо]угопВоп по 
массиву Р формируется регион и его дескриптор заносится в переменную 
МуВеФ10оп. Затем массив Р уничтожается. Дальнейшие операторы функции 
ВСгезж{еСПсК были рассмотрены ранее. | 


5.2.3 Буксировка компонентов и форм 


Иногда надо предоставить пользователю возможность буксировать компо- 
ненты по площади окна формы. Например, вы хотите разрешить пользовате- 
лю перестраивать в каких-то пределах компоновку окна. Еще чаще такая воз- 
можность требуется в различных задачах конструирования, когда пользовате- 
лю надо скомпоновать некое устройство или схему, перемещая панели с от- 
дельными фрагментами. Бывают также случаи, когда требуется перемещать 
по экрану форму, буксируя ее не за заголовок окна, а за любую ее точку. На- 
пример, окно может быть вообще без полосы заголовка или при непрямоуголь- 
ной форме (см. разд. 5.2.2) заголовок может быть не виден. 

Простейший вариант решения подобных задач следующий. Сошлитесь 
в событиях ОпМоизеро\мп всех оконных компонентов, которые вы хотите бук- 
сировать, на следующий универсальный обработчик: 
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Ве1еазеСаркоге (); 
((ТСопЕго1 *) 5епаег) ->РегЕогм (ИМ 5У$СОММАМОР, 0хЕ012, 0); 


Этот обработчик освобождает курсор мыши и посылает методом Регогт 
сообщение \У/1т94о\з$, соответствующее буксировке. 

Можете ссылаться на подобный обработчик в событиях панелей, кнопок, 
списков, окон редактирования. Все подобные компоненты пользователь смо- 
жет буксировать, перестраивая, таким образом, интерфейс приложения. Если 
вы сошлетесь на подобный обработчик в событии формы, то пользователь смо- 
жет перемещать ее по экрану, взявшись за любую ее точку, а не только за точ- 
ку в заголовке окна, как это принято в обычных окнах \У/ш4о\мз. 

Такая безусловная буксировка может создать сложности при работе, на- 
пример, в окнах редактирования, поскольку в них буксировка мышью исполь- 
зуется при работе с текстом. Так что, вероятно, разумнее осуществлять букси- 
ровку, если одновременно нажата какая-то вспомогательная клавиша, напри- 
мер, А{Н. В этом случае обработчик события ОпМоизеВомт может иметь вид: 

Уу01А __ЕазЕса11 ТЕГогп1: : РосмМоцзеромп (ТОЮ)ес® *5епаег, 

ТМочзеВа® оп ВаеФфоп, 
ТУН1ЕЕ5аке $51, 1пЕ Х, 116 У) 


{ 
1Е (551Е%.Сопфалп$ ($5$А1+) ) 


{ 
Ве1еазеСар+иге (); 
((ТСопёго1 *) бепаег) ->РегЕогм (ИМ 5УЗСОММАМО, 0хЕО12, 0); 
} 
} 


В случае буксировки формы можно также проанализировать координаты 
курсора Х и У, чтобы буксировать только за определенную область формы. 

Рассмотренный способ буксировки вы можете увидеть в форме РГогт1 
в примере РМоше в каталоге Моше на приложенном к книге диске. Этот способ 
имеет определенный недостаток, связанный с тем, что буксировать можно 
только оконные компоненты. Пусть, например, требуется буксировать изобра- 
жение, помещенное в компонент Ппаре. Это неоконный компонент, так что 
с помощью описанного приема это сделать нельзя. Тут возможны различные 
решения. Пожалуй, наиболее простое: поместить компонент Ппафе на панель 
Рапе|. Размер панели можно сделать большим, чем размер Ппаре. Тогда пере- 
мещение будет возможно при буксировке за край панели, выступающий 
из-под изображения. Впрочем, это не очень красиво и удобно. Более удачное 
решение — в обработчике события ОпМопзе ом компонента ГПпабе переадре- 
совать событие родительской панели, на которой помещен Гпаде. В этом слу- 
чае размеры панели и изображения делаются одинаковыми, а обработчик со- 
бытия ОпМоцзедо\мп компонента Ттазе1, помещенного на панели Рапе1, мо- 
жет иметь вид: . 

У01А __ЁЕаз®са11 ТЕогм1 ; : Ттаде1Мочзеромпт (ТОБ]есЕ *5епаег, 

ТМоцзеВвВаЕ оп ВаЕеоп, ТУВЕ бабе 5УВ1ЕЕ, 116 Х, 110 У) 


{ 
Рапе11->ОпМоцзеромпт (Рапе11, Ваееоп, ЗБ1ЕЕ, Х, У); 


} 


Другая возможность буксировки изображений — рисовать их не в компо- 
ненте Ппарге, а на канве, связанной с панелью. Этот вариант рассмотрен 
в разд. 5.3.1. А в разд. 5.5 показано, что можно получать изображения непо- 
средственно на поверхности панели, не прибегая к помощи Нпафе или канвы. 
Ноу этих подходов, как вы увидите, есть свои недостатки. 
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Рис. 5.7 ЭВ. Буксировка оконных компонентов. | 
Окно формы Рогпп1 приложения Потянуе мышью при нажатой клавише АЙ любой оконный 
РМо\уе в исходном виде (а) компонент этой Формы или саму Форму за любую ее - 
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Кроме Ппаге, имеются и другие неоконные компоненты, которые невоз- 
можно буксировать рассмотренным методом. Например, он не обеспечивает 
буксировку меток. Этих недостатков лишена буксировка с помощью техники 
Огая&Ооск. В примере РМоше в каталоге Моуе на приложенном к книге диске 
этот способ буксировки вы можете увидеть в форме Еогт2, аналогичной по 
виду рис. 5.7, только с измененными надписями. Для осуществления букси- 
ровки с помощью техники ПОгаё&Ооск надо установить в форме свойство 
РосЕ5Це равным фгае, а в перемещаемых компонентах установить свойства 
ОгахКат@ в АЕОоск и свойства ОгаМоде в 4тАщотайЯс. Это надо сделать, по 
крайней мере, в двух компонентах. Если перемещаемым будет только один 
компонент, описываемый метод не сработает. В начале работы приложения 
надо выполнить для одного из перемещаемых компонентов методы 
Мапиа!]1оа{ и МаппаШоск, назначив приемником в МапипаШосК форму. Для 
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этого можно вставить в обработчик события формы ОпСгеже, например, сле- 
дующие операторы (в них предполагается, что один из перемещаемых компо- 
нентов — изображение Ттаге1): 
Тпадче1->Мапоа1Е1оа* (Вес® (Гоги1->.еЕ+Ттаде1->1еЕ\, 
Гоги1->Тор+Тмаде1->Тор, 
Рогм1 ->ЪеЕе+Тмаде1->ЪеЕ&+Тмаае1->\1аеь, 
Гогп1->Тор+Ттаде1->Тор+Ттааче1->Не1ав{)); 
Тпадче1->Мапаа1Роск (ЕГогм1 , МОЪЬ, а1 ЪеЕ®); 


И это все. Вам не надо писать никаких обработчиков событий компонен- 
тов. Вы получили приложение, в котором пользователь может перемещать 
мышью ваши компоненты, включая метки и изображения, по площади формы 
(точнее, те компоненты, в которых вы установили значение ОгаМоде равным 
ЧтАщюотайс). При этом в процессе буксировки перемещается только контур 
изображения в виде утолщенной рамки. Сам компонент перемещается на но- 
вое место только в конце буксировки. Если хотите, то можете в обработчик со- 
бытия ОпЕпаОоскК внести оператор 


((ТСоп®го1 *) бепаег) ->Вг1паТоЕкопЕ (); 


Он обеспечит в момент переноса размещение компонента поверх других. Но, 
конечно, оконные компоненты всегда будут расположены выше неоконных. 

Рассмотренный метод универсальнее предыдущего, так как разрешает. 
буксировать неоконные компоненты. Недостатком рассмотренного метода яв- 
ляется то, что если вы разрешили перетаскивать кнопки, то они перестанут 
работать, так как нажатие мыши над ними будет восприниматься как начало 
перетаскивания. Неприятности могут возникнуть также в окнах редактирова- 
ния и в других компонентах, в которых имеются стандартные реакции на на- 
жатие кнопки мыши. Это легко предотвратить, если в подобных компонентах 
разрешать буксировку только при нажатии какой-то вспомогательной клави- 
ши. Например, если буксировка, предположим, кнопок ТВиЙоп, должна на- 
чинаться, только если в этот момент нажата клавиша А\, то для этих кнопок 
надо задать следующие обработчики событий ОпКеу)о\мт и ОпКеу Ор: 

у01А __ Еазса11 ТЁГогм1: : Вис боп1Кеуромп (ТОБ]есе *5епаек, 


ИОВО &Кеу, Т5р1 ЕЕ 5бабе $В1Еф) 
{ 
1Е (Кеу == УК _МЕМО) 
РгачМоае = дпАифопа®1с; 
} . 


\у01Я _ Еаз®са11 ТРогт1: : Вик оп1КеуЧр (ТОБЗесЕ *Зепаек, 
МОВО &Кеу, Т5Р1 ЕЕ баке $В1Е%) 
{ 
1Е (Кеу == УК_МЕМО) 
ОгачМоае = аАпМапца1; 
} 


При нажатии клавиши А! в кнопке задается свойство ОгахМоде = 4тАл- 
фотайс, а при отпускании этой клавиши свойство ОгахМоде устанавливается 
в 4тМапоиа|. Так что если в момент нажатия кнопки мыши клавиша А! не на- 
жата, буксировки не будет. 

В С+-+Ви|!аег 2006 реализация техники Ога&ОосКк несколько отличается 
от реализации в С++Ви!Паег 6 и в более ранних версиях. Причем, это отличие 
не документировано. В результате описанный выше подход к буксировке с по- 
мощью Огая&ОосК срабатывает в С+-+ВиПаег 2006 не совсем полноценно, как 
вы сможете заметить, если опробуете приложение РМоье. Так что 
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в С+-+ВиПаег 2006 следует использовать описанный ранее подход, основанный 
на В@еазеСар{аге, или подход, описанный далее. - 


Во всех рассмотренных выше методах в процессе буксировки перемещает- 
ся только прямоугольная рамка, соответствующая размерам буксируемого 
объекта. Само изображение переносится в новую позицию только в момент от- 
пускания кнопки мыши. Такая буксировка имеет свои достоинства и свои не- 
достатки. К достоинствам следует отнести отсутствие какого-то дрожания изо- 
бражений как перемещаемого объекта, так и тех компонентов, над которыми 
рамка перемещается. Но бывают ситуации, в которых такой тип буксировки 
нежелателен. Например, в задачах конструирования, когда пользователю 
надо скомпоновать некую схему, перемещая изображения отдельных фраг- 
ментов. В этих задачах часто местоположение объекта надо выбрать так, что- 
бы какие-то его линии совпали с линиями другого объекта. Это трудно сде- 
лать, если само изображение объекта не буксируется. Другой случай, когда пе- 
ремещение рамки нежелательно — буксировка непрямоугольных окон 
и форм, создание которых описано в разд. 5.2.2. В этих случаях перемещаемая 
прямоугольная рамка не соответствует видимой форме объекта. 

Перемещение изображения во время буксировки любого визуального ком- 
понента и самой формы можно осуществить так (см. форму Еогт3 в проекте 
РМоше в каталоге Моше на приложенном к книге диске). Задайте для всех ком- 
понентов, которые желательно буксировать, и для самой формы следующие 
обработчики событий, связанных с мышью: 


10 ХО, У0; // начальные координаты курсора 
Боо1 ТМоуе Ёа1зе; // флаг буксировки 


У01Аа __Еазеса11 ТКГогм3: : КогиМоцзеромт (ТОБ]есе *5епаек, 
ТМонзеВи оп Ва Ебоп, 
, ТЕ бабе $Б1ЕЕ, 1пЕ Х, 1пЕ У) 
// начало буксировки, запоминание координат и установка флага 
{ 
1Е (ОП1ЕЕ.СопЕа1п$ ($$А1+)) 
{ 


1Мохе = Егае; 
ХО = Хх; 
УЙ = У; 


у01А __Еаз6са11 ТРГоги3: : КогиМочзеМотхе (ТОБ)ес® *5епаег, 
1561 ЕЕ Збабе $5В1ЕЕ, 
10 Х, 110 У) 
// продолжение буксировки, изменение координат 
| | 
1Е (ТМохе) 
{ 
ТВесе В = ((ТСопфго1 *) Зепаег) ->ВоппазВесе; 
В.ТеЕЕ += Х - ХО; 
К.ВК1ане += Х - ХО; 
В.Тор += У - У0; 
К.Воееом += У - У0; 
((ТСопЕго1 *) Зепаег)} ->ВоцпазВесе = В; 


Уу01А __ГазЕса11 ТЕогм3: :КогиМочзеОр (ТОр)есЕ *5епаег, 
ТМочзеВа оп Вае®оп, 
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Тор Ебббаее $01ЕЕ, 1п0Е Х, 11 У) 
// окончание буксировки, сброс флага 


{ 


ТМохуе = Еа1зе; 


} 


В приведенном коде вводятся глобальные переменные ХО и У0, в которых 
запоминаются начальные координаты курсора. Глобальная переменная Г.Моуе 
является флагом, значение которого показывает, происходит ли буксировка, 
т.е. надо ли изменять положение компонента при перемещении курсора 
мыши. Комментарии в коде поясняют процесс буксировки. При нажатии 
кнопки мыши проверяется, нажата ли одновременно клавиша А. Если нажа- 
та, то запоминаются координаты курсора, и устанавливается флаг буксиров- 
ки. Этот флаг сбрасывается при отпускании кнопки мыши. А при перемеще- 
нии мыши и установленном флаге координаты компонента изменяются. Стоит 
только пояснить, почему изменение координат не осуществляется проще, на- 
пример, операторами: 


((ТСопЕхго1 *)бепаег) ->ЦеЕ += Хх - ХО; 
((ТСопбго1 *) бепаег) ->Тор += У - У0; 


Эти операторы осуществляют перемещение и перерисовку компонента 
дважды: при изменении свойства Ге, и при изменении свойства Тор. Так что 
дрожание изображения гораздо заметнее по сравнению с однократным измене- 
ние свойства Воипа$Весё. 

Достоинства рассмотренного метода буксировки уже были указаны ранее. 
А его недостаток — дрожание изображения объекта во время его буксировки, 
и дрожание изображений компонентов, над которыми перемещается объект. 


5.2.4 Окна компонентов с изменяемыми размерами 


В разд. 5.2.3 рассмотрены варианты создания перемещаемых окон. Одна- 
ко можно разрешить пользователю не только их перемещать, но и изменять их 
размеры, потянув курсором мыши за любой край окна. 

Способность изменять размер в ответ на действия пользователя определя- 
ется бордюром окна. Установить характеристики бордюра уже созданного 
окна можно функцией: 


ТОМСс 5ееМ1паомЬопа (ТМ НИМР БИпа, ТМ 116 пТпаех, ТМ ГОМС АмМемГопа); 


Параметр В\У/п@4 — это дескриптор окна, параметр пех определяет, ка- 
кая группа характеристик окна задается, а параметр 4мМемТ.опх является со- 
вокупностью флагов, задающих характеристики. Функция возвращает стиль 
окна, который был до вызова этой функции. 

Для решения поставленной задачи изменения бордюра окна в вызове 
Зер\т4ЧомГ.опй надо задать п4ех = СУТ, ЗТУГЕ, а в параметре 4мМем- 
Гопй добавить к текущему стилю флаг М$_ТШСКЕКАМЕ (можно использо- 
вать вместо М5 ТШСКЕКАМЕ флаг \5_$Т2ЛЕВОХ.) — окно с изменяемым 
размером. Однако прежде, чем добавлять в окно стиль \$_ТНТЛСКЕВАМЕ, 
надо узнать текущий стиль окна. Это можно сделать функцией Се У1т94ом- 
Гопр: 


ТОМС СееМ1пЧомЪопа (ТМ НИМО Б\па, тм 106 птпаех); 


Параметры В\У’п4 и пШшдех идентичны функции Зе \Утдо\Г.опо, а воз- 
вращаемое значение в этом случае содержит текущий стиль окна. 
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Таким образом, если вы хотите разрешить пользователю изменять, напри- 
мер, размер панели Рапе]1, это можно сделать оператором: 
ЗееИ1паомЪопа (Рапе11->Напа]1е, СИШ ЗТУЦЕ, 


беЕИ1пдомЪопа (Рапе11->Нап@1е, СИГ $ТУГЕ) | 
И$_ТНТСКЕВАМЕ); 


‚ Однако изменив стиль бордюра, надо обеспечить немедленное отображе- 
ние окна с новым типом бордюра. Для этого окну надо послать сообщение 
\ММ_МССАГСЬГАЕ, которое извещает его об изменении размера. Впрочем, 
проще всего не посылать это сообщение явным образом, а воспользоваться для 
этого функцией Зе \Ут9домРоз: 

ЗеЕ\И1паомРо$ (Рапе11->Напа1е, О, 0, 0, 0, 0, 


ЗИР ЕКАМЕСНАМСЕР | $ИР МОМОУЕ | 
ЗМР №0512Е.| $МР МО7ОБРЕВ); 


Последний параметр в вызове функции Зе \Ут@4омРо$ содержит ряд фла- 
гов, Из них для нашего случая главным является $5\УР_ЕКАМЕСНАМСЕЮ, 
обеспечивающий посылку в окно сообщения \М_МССАЕГСЗУТАЕ об изменении 
бордюра. Остальные флаги означают, что окно не надо сдвигать (5\УР_МО- 
МОЕ), что его размер не меняется (5\Р_МОЗТАЕ), и что его положение 
в /-последовательности также не меняется (5\УР_МО2ОВЬЕК). Благодаря 
этим флагам все параметры в вызове Зе \т4омРо$, кроме первого и послед- 
него, можно задать равными нулю, так как они игнорируются. 

Рассмотрим тестовый пример, который вы можете найти на диске, прило- 
женном к книге, в каталоге Моуе в проекте Р52еМооше. Его вид приведен 
на рис. 5.8. На форме размещены различные оконные компоненты: Рапе|, 
ЕЦ, Г1$%Вох, Мето, Тгее\У1ечу, СпесКВох, ЗфайсТех&. На форме имеется так- 
же компонент контекстного меню РорирМепи, в котором заданы два раздела: 
Перемещаемое окно (его имя в приведенном далее коде ММоуе) и Изменяемый 
размер (имя М$12е). В обоих разделах установлены в фгие свойства АщоСТеск. 
Это обеспечивает автоматическое переключение свойства СВесКе@ раздела, 
и появление в заголовке раздела индикатора, показывающего, установлено 
значение данного раздела, или снято. Во всех оконных компонентах формы 
в свойствах РорирМепи заданы ссылки на этот компонент РорирМепи1. 


=151х! 


О————— м ———_——- 


Рис. 5.8 


Пример с перемещаемыми | Любой компонент на этой форме можно с помощью _ 
окнами изменяемых размеров 


контекстного меню перевести в режим 
перемещаемого и в режим изменяемого размера 
(кроме этой метки ЗЗайсТеж) 


(1 Перемещаемые окна с изменяемь 


——- ———— 


ыы еч 


—— 


==. 


__ | о 
[Ее Рапей | | Г СвескВох 


Список 115\Вох 


Окно Мето |= Ттее\Мем 


5.2 Оформление окон 315 


При щелчке правой кнопкой мыши на любом компоненте можно выбрать 
из контекстного меню соответствующую команду и делать окно этого компо- 
нента перемещаемым, с изменяемыми размерами, или опять превращать его 
в обычное окно. При выборе раздела Изменяемый размер бордюр окна изменяет- 
ся (вы видите это изменение в окне Мето на рис. 5.8), и пользователь может 
изменять его размеры, потянув курсором мыши за любую границу окна. Ис- 
ключение составляет компонент ЭфайеТехф, который, хотя и является наслед- 
ником ТУ\УтСоп®`о]1, но задание бордюра, обеспечивающего изменение разме- 
ров, не воспринимает. | 

Ниже приведен код этого примера. 


у01А _ Еазеса11 ТКогм1 : :М$12еС11ск (ТОр]есе *бепаег) 

{ 
// обработка раздела меню "Изменяемый размер" 
НИМО Н =( (Т\№1пСопЕго1 *) РорирМепа1->РорорСопропеп®) ->Напа1е; 
ОМС 01а5&у1е = бееМ1паомЬопа (Н, СМЬ $ТУЪЕ); 
1Е (М51ге->Сртескея) 
{ 

// установка стиля И5_ ТНТСКЕКАМЕ 

зеЕИ1паомГопа (Н, СМЬ ЭТУБЕ, 01а5$у1е | М5 ТНТСКЕВАМЕ); 

((ТСопего1 *)РорярМепа1->РорирСотропеп®) ->Тадз = 1; 
} 
е15е 
{ . 

// удаление стиля И$ ТНТСКЕКАМЕ 
зеЕе\1паомЬопа (Н, СМЬ ЭТУЬЕ, 014956 у1е & - М5 ТНТСКЕВАМЕ); 
((ТСопёго1 *) РорирМепоа1->РорирСоптропеп+) ->Тад = 0; 

} 
// перерисовка окна с новым стилем бордюра 
зеЕИ1паомРоз (Н, О0, О0, О0, 0, 0, $5ИМР ЕВАМЕСНАМСЕР | 5ИР МОМОУЕ | 

ЗИР_МОЗТАЕ | 5МР_МО2ОВОЕВ); 


У01Аа __Еаз®са11 ТЕГогп1 : :ММоуеС11ск (ТОБ]есЕ *5епаег) 
{ 
// обработка раздела меню "Перемещаемое окно" 
1Е (ММоуе->Срескея) 
((ТСопбго1 *) РорирМепа1->РорирСопропеп®) ->Сигзог = сгЕ512еА11; 
е1зе ((ТСопЕго1 *) РорирМепоа1->РорирСотропеп®) ->Сиагзог = 
сгреЕац1*; 


У01А _ Еаз®са11 ТГогм1: : Рапе11Мопзеромт (ТОр)]есЕ *5епаек, 
ТМоцзеВа оп Вабоп, Т5Р1ЕЕбЕаее $ЗРТЕЕ, 1106 Х, 1106 У) 
{ 
// обработчик события ОпМоизероип всех компонентов 
1Е( ((ТСопЕго]1 *)бепаег) ->Сагзог == сгЕ512еА11) 
{ 
Ве1еазеСарфакге (); 
((ТСопёго1 *) бепаек) ->РегЕоги (ИМ 5У$СОММАМО, 0хЕ012, 0); 


У01Я __Газ®са11 ТЕогм1 : : Е а1*1СопфехЕРорчур (ТОБ]есЕ *5епаег, 
ТРо1зпЕ &МоцзеРо$, Роо1 &Напа1ед) 
{ 
// обработчик события ОпСопЕехЕРорир всех компонентов 
// настройка меню 
ММоуе->СвескеЯя = (((ТСопЕго1 *)3Зепаег) ->Сигзог == сг512еА11); 
М512е->СрескКеа = (((ТСопЕго1 *) бепаег) ->Таа == 1); 
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Функция М$1хеСИсК является обработчиком щелчка на разделе Изменяе- 
мый размер всплывающего меню. В переменную Н заносится дескриптор ком- 
понента, при щелчке на котором было вызвано меню. Этот компонент опреде- 
ляется свойством РорирСотропеп компонента РорирМепи1. В переменную 
01а5{Яе вызовом функции де т94омТ.опе заносится текущий стиль окна 
компонента. Затем по свойству СВесКе4 раздела меню М5127е определяется, ус- 
тановлен ли или сброшен данный раздел. Если установлен, то вызывается 
функция Зе \тдомТ.опг, обеспечивающая добавление в стиль флага 
\5_ТНТСКЕКАМЕ. При этом свойство Тай компонента устанавливается в 1. 
В этом свойстве запоминается, задан ли в окне бордюр, обеспечивающий изме- 
няемые размеры. Если раздел меню М$12е не устанавливается, а сбрасывает- 
ся, то с помощью вызова той же функции Зеё \УтдомГТопе флаг \$5_ТНТСК- 
ЕКАМЕ удаляется из стиля окна, а в свойство Тай заносится 0. 

После изменения стиля бордюра вызовом Зе \Ут4омРо$ окно перерисо- 
вывается, чтобы пользователь мог изменять размеры окна. 

Функция ММоучеСПеК является обработчиком щелчка на разделе Переме- 
щаемое окно всплывающего меню. В зависимости от того, устанавливается этот 
раздел, или сбрасывается, курсору компонента задается стиль сг512еАП или 
сгре! аи. 

Функция Рапе|!1 МоизеВомт является общим для всех оконных компонен- 
тов формы обработчиком события ОпМоцзеромп. Если курсор компонента, 
в котором произошло событие, равен сг512еАЦ, значит, надо осуществлять 
буксировку окна. Операторы, которые обеспечивают буксировку, рассмотрены 
в разд. 5.2.3, так что не имеет смысла их повторно обсуждать. 

Функция Е9\1Сощех(Рорир является общим для всех оконных компо- 
нентов формы обработчиком события ОпСощех{Рорир. Операторы этого обра- 
ботчика настраивают разделы меню (задают состояния их индикаторов) в за- 
висимости от того, установлена ли для окна возможность буксировки (прове- 
ряется по стилю курсора), и задан ли бордюр с изменяемым размером (прове- 
ряется по значению свойства Тайх компонента). | 

Выполните это приложение и убедитесь, что пользователь получает широ- 
кие возможности по перемещению компонентов и изменению их размеров. Ко- 
нечно, хотелось бы дать пользователю возможность запоминать в подобном 
приложении сделанные изменения положения и формы компонентов, чтобы 
в следущем сеансе работы ему не приходилось повторять настройку заново. 
Реализация подобной возможности рассмотрена в разд. 6.13. 


5.2.5 Мигание заголовка окна и пиктограммы приложения 


Иногда требуется, чтобы свернутое приложение известило пользователя 
о том, что оно завершило какую-то работу. Наиболее мягким способом такого 
извещения является мигание пиктограммы приложения в полосе задач. Орга- 
низовать мигание можно функцией Нав У т9ом: 


ВООГЬ Е1азВИ1паом (ТМ НМИМО ВБ\па, тм ВОО БТпуег*); 


Параметр В\/п4 является дескриптором окна, а параметр ЫТпуег& определя- 
ет режим переключения окна. При значении ЫМпуегё = фгое заголовок окна при 
каждом вызове Е1а5 В \У/шт4о\ один раз мигнет и останется в подсвеченном со- 
стоянии. При Ыпуегф = 7а15е окно переходит в подсвеченное состояние. Если 
первым параметром функции указан дескриптор приложения, то мигание отно- 
сится не к заголовку окна, а к пиктограмме приложения в полосе задач. Функ- 
ция возвращает предыдущее состояние окна: фгие, если окно было активно. 
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Таким образом, для реализации мигания поместите на форму приложения 
компонент Типег, задайте в нем значение Пщфегуа|! равным, например, 2000 
и значение Епае4 = #а15е. Напишите обработчик события ОпТипег таймера: 


Е1азБИ1паом (Арр11са®1оп->Напа1е, Егое); 


Этот оператор обеспечивает мигание пиктограммы в полосе задач. Если вы 
хотите, кроме того, обеспечить мигание заголовка окна, вы можете добавить 
в обработчик оператор: 


Е] аз И1паом (Еоги1->Напа1е, гие); 


Впрочем, это вряд ли целесообразно. 
Когда в приложении произошло событие, о котором вы хотите известить 
пользователя, выполните оператор: 


‚1Е (! Арр11са®1оп->Асетуе) 
Т1пег1->Епаб]еа = Егаое; 


Это обеспечит мигание в случае, если в данный момент приложение неак- 
тивно (для активного приложения вряд ли стоит включать мигание). А если 
вы хотите, чтобы при активации мигающего окна мигание прекратилось, вве- 
дите в приложение компонент АррПеаНопЕуеп{$ и в обработчике его события 
ОпАсйуже напишите оператор: 


_Тиег1->Епар1еа = Еа15е; 
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Нередко возникают задачи разработки графических редакторов, в кото- 
рых изображение должно создаваться, в частности, из каких-то стандартных 
примитивов. Такими примитивами могут быть изображения компонентов при 
проектировании электронных схем или систем управления, изображения 
предметов мебели, станков и другого оборудования при планировании их раз- 
мещения в цехе или офисе, изображения элементов схем финансовых потоков 
и т.п. Подобные примитивы пользователь должен иметь возможность созда- 
вать, перемещать по площади редактора, копировать в итоговый рисунок, уда- 
лять и выполнять с ними ряд других операций. 

Объекты таких графических примитивов можно создать множеством раз- 
личных способов. В данном разделе обсуждаются два варианта, выбранные по- 
тому, что они иллюстрируют некоторые приемы, рассмотренные в предыду- 
щем разд. 5.2. 


5.3.1 Объекты на основе панелей 


5.3.1.1Пример графических объектов и редактора на их основе 


Перемещаемые графические объекты можно строить на основе компонен- 
тов Гпарйе. В разд. 5.2.3 показано, как можно организовать их перемещение 
пользователем. Использование Ппаге имеет то преимущество, что рисунки 
объектов можно делать прозрачными — это требуется в некоторых случаях. 
С другой стороны, если использовать оконные объекты, их легко перемещать 
с помощью захвата мышью, как описано в разд. 5.2.3. Так что мы остановимся 
на оконных компонентах — панелях или формах. 
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Вариант с формами мы обсудим в разд. 5.3.2. А пока рассмотрим исполь- 
зование панелей. К, сожалению, в панели отсутствует канва, на которой легко 
рисовать. Правда, в разд. 5.5 будет показано, что на панелях, как и на любых 
оконных компонентах, можно рисовать без канвы. Но все-таки это не очень 
удобно. Так что лучше присоединить к панели канву класса ТСопего!Сапуа$ 
и рисовать на ней. 

Тестовые приложения, реализующие редакторы с графическими объекта- 
ми на основе панелей, имеются на приложенном к книге диске в катало- 
ге СтОБ в проектах СОРапе 1, СОРапе[2, СОРапе!3. Рассмотрим сначала более 
простое из этих приложений СОРапе!Ш. Его вид во время выполнения показан 
на рис. 5.9. В приложении предусмотрено 4 типа объектов: прямоугольник, 
эллипс, треугольник, рисунок. Естественно, это просто абстрактные примеры 
объектов, и их состав просто призван показать некоторые особенности объек- 
тов разных конфигураций. В реальном приложении вы легко сможете заме- 
нить эти объекты теми, которые вам нужны. 


Рис. 5.9 | { „Графические объекты на основе Панайея т > хе .., 
Редактор на основе панелей: Файл Объекты Рисунок 
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параметров объекта (6) 0 
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Меню Файл главного окна содержит традиционные разделы Открыть, Со- 
хранить, Выход. Меню Объекты главного окна приложения содержит разделы 
Новый, Копировать в рисунок и Вырезать в рисунок. Раздел Новый создает новый 
объект. Это объект прямоугольника, точнее, квадрата со сторонами по 50 пик- 
селов. Одновременно с созданием объекта открывается окно настройки его па- 
раметров, показанное на рис. 5.9 6. В нем из выпадающего списка Форма поль- 
зователь может выбрать любой из доступных типов: прямоугольник, эллипс, 
треугольник, рисунок. Форма графического объекта при этом изменится. Все 
эти типы объектов вы можете видеть на рис. 5.9 а. Список Цвет позволяет за- 
дать цвет, которым рисуются три первых вида объектов. Окна Ширина и Высота 
позволяют задать размеры объекта. Для рисунка задание одного из размеров 
автоматически изменяет пропорционально другой размер, чтобы пропорции 
рисунка не исказились. 
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Радиокнопки внизу позволяют выдвинуть объект на передний план, или от- 
нести его на задний план. Это требуется использовать для перекрывающихся 
объектов. Например, в домике, изображенном на рис. 5.9, труба выдвинута на 
первый план по отношению к крыше, а окна — по отношению к стене домика. 

Окно настройки параметров объекта всегда расположено поверх главного 
окна редактора. Но пользователь может выходить из него в главное окно и осу- 
ществлять в нем любые действия, в частности, вводить новые объекты. Вы- 
звать окно настройки для любого объекта можно двойным щелчком на этом 
объекте. 

Щелчок правой кнопкой мыши на объекте вызывает его контекстное меню 
с разделами: На задний план, Удалить, Копировать в рисунок, Вырезать в рисунок. 
Смысл первых двух из них очевиден. Два последних, содержащиеся также 
в меню Объекты полосы главного меню, позволяют перенести изображение из 
объекта на полотно рисунка. При этом раздел Вырезать уничтожает сам объект, 
а раздел Копировать оставляет объект неизменным, так что его можно передви- 
нуть в другое место и занести в рисунок еще раз. 

Меню Рисунок полосы главного меню содержит два раздела: Копировать из 
рисунка и Вырезать из рисунка. При выборе любого из них пользователь может 
обвести рамкой фрагмент рисунка (конечно, если до этого в рисунок были пе- 
ренесены изображения объектов). В результате создастся новый объект, в ко- 
торый перенесется выделенный фрагмент. Если был выбран раздел Вырезать из 
рисунка, то из рисунка этот фрагмент удалится. С созданным новым графиче- 
ским объектом фрагмента можно выполнять основные операции, предусмот- 
ренные для предопределенных объектов: перемещать (момент перемещения 
фрагмента с домиком вы можете видеть на рис. 5.9 а), копировать или выре- 
зать в рисунок, масштабировать, удалять. 

Рассматриваемое тестовое приложение состоит из трех модулей: ЕРапеШ, 
содержащего описание класса графического объекта, ОРГРагатз1, содержаще- 
го описание формы настройки параметров объекта, и ОГМат1, содержащего 
описание главной формы приложения. Начнем рассмотрение проекта с модуля 
ЕРапе1. 

Ниже приведен основной текст заголовочного файла ЕРапеШ.Л: 


#1ЕпаеЕ ЕРапе11Н 
#+АеЕ1пе ЕРапе11нН 


#1пс1аае <С1аззез.Врр> 
#1пс1аае <Соп&го1$.Прр> 
#1пс114е <56аСег1$.Прр> 
#1пс1о4е <РГогм$.Прр> 
#1ос1аае <Мепраз.Врр> 
#1пс1аае "ОЕРагам$1.В“" 


// тип изображения в объекте: Весеапд - прямоугольная рамка, 


// Е]1]11рз - эллипс, окружность 
// Тг1апд - треугольник 
// Е19 - рисунок 


епим Т5рар {Кескапа, Е111р$з, Тг1апа, Е1а}; 
// класс объекта 
с1аз$ ТЕ1лаиаге : руаб11с ТРапе1 


{ 


рг1уа%е: 
ТСопЕго1Сапуаз *ЕСапуаз; // канва 
ТбВар Е5варе; // тип изображения в объекте 
ТСо1ог ЕСо1Тог; // цвет пера 


Сгарр1сз$: :ТВ16тар *ЕВ1$тар; // картинка в объекте 


320 Глава 5. Окна и графика 


СгарЮ1с5: :ТВзЕмар *ВМВ; // полная картинка объекта 
`Боо1 Егадтепе; // создан ли объект из фрагмента 
ргобесфеа: 


// установка поля ЕВ1Етар - картинки в объекте 

Уу01А __Еаз®са11 ЗеЕВ1®тар (Сгарр1с$: :ТВ16мар *В1®тар); 

// установка поля ЕСо]1ог - цвета пера 

у014 __Еаз®са11 5ееСо1ог (ТСо1ог Со1ог); 

// установка поля Е5Наре - типа изображения в объекте 

у014 _ Еаз®са11 беебраре (Т5Пар 5Варе); 

// установка размеров 

Уу01А __ГЕаз®са11 $еф512е (1106 МемМ1аАер, 1пе МемНе19р*); 

// указатель на текущий активный объект 

зфаф1с ТЕ1аиге * Ти; 

// канва контейнера, в котором рисуются изображения объектов 

зфае1с ТСапуаз *Рагеп®Сапуаз; 

раЬ]11с: 

// конструктор 

__Фаз©са11 ТЕ1даге (ТИ1пСопего1* Омпег, ТСапуа$ *Сапуаз); 

// деструктор 

__Фаз&са11 -ТЕ1даге (уо1а); 

// прорисовка изображения на канве объекта 

у01А _ ЕазЕса11 Огам (уо19а); 

// свойство ВлЕтар - картинка в объекте 

_ _ргорегеу Сгарв1сз::ТВ1Емар *В1етар = {геаа=ЕВ1& пар, 

мг1се=бееВ1Етар, АеЕац1*=егае}; 
// свойство Со]ог - цвет пера 
__ргорегеу ТСо1ог Со1ог = {геаа=ЕСо]1ог, мг16е=бееСо1ог, 
ЧеЕац1+=Егае}; 
// свойство 5рВаре - тип изображения в объекте 
_ ргорегеу Т5Вар 5паре = {геаа=Е5раре, мг1%ке=беебраре, 
ЧеЁаз1+=$гае}; 
// обработчик события ОпМоизероип 
РУМАМТС у0о14 __Еаз®са11 Моцзерочт (ТМоцзеВа® оп Виебоп, 

С1аззез: : Т5В1ЕЕ бабе $Р1ЕЕ, 11% Х, 1106 У); 

// обработчик события ОпрЬ1С11ск 

РУМАМТС \01А _ Еаз&са11 0р1С11сК(\о1а); 

// обработчик события ОпРа1пЕ 

У1г6иа1 уо1а __Еаз$са11 Ра1п® (уо19а); 

// создание нового объекта с диалоговым заданием 

// размера, цвета, изображения 

$сае1с уо1а Е1аСгеа&е (ТМ1пСопего1 *5бепаег, ТСапуаз *Сапуаз); 

// создание нового объекта из фрагмента рисунка 

5$афе1с уоза Е1аСгеаке (ТМ1пСопего1 *бепаег, ТСапуаз *Сапуаз, 

ТВесЕ бочгсе, Боо1 Саф); 

// копирование или вырезание изображения объекта в рисунок 

$фае1с \уо1А ТоСапуаз$ (Ъоо1 Саф); 

// дружественный класс 

Ег1лепа с1аз$ ТЕ1аРагамз; 


}; 


и инициализация статических переменных 

ТЕ1заиге * ТЕ1зааге:: Ша = №11; 

ТСапуаз * ТЕ1аиге: :РагепеСапуаз = МОТ; 

Этот файл, не привязанный к какой-либо форме, содержит объявление пе- 
речислимого типа ТЭВар, включающего идентификаторы типов изображений 
в объектах, и объявление класса графических объектов ТЕахиге. Директива 
шее подключает заголовочный файл формы настройки параметров ОЁРа- 
гатз1.й, в котором объявлен класс этой форма ТЕ1еРагапа$. А последняя стро- 
ка объявления класса ТЕ1гиге содержит указание на то, что ТЕ1Рагатзб явля- 
ется дружественным классом. Таким образом, классы ТЕ аге и ТЕшРагат$ 
могут взаимно использовать элементы друг друга. | 
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Класс ТЕ1гаге наследует классу панелей ТРапе!. Назначение всех элемен- 
тов класса ТЕшоиге поясняется комментариями. Так что ограничимся кратким 
обсуждением основных элементов. Поле ЕСапуа$ является указателем на кан- 
ву класса ТСошго!Сапуа$, которая присоединяется к панели и на которой ри- 
суются изображения. Поле ЕВЁйтар содержит указатель на битовую матрицу 
изображения, отображаемого в объектах типа рисунка при значении поля 
ЕЗВаре = Её. Поле ВМР содержит указатель на битовую матрицу, в которой 
запоминается полное изображение на поверхности объекта любого вида. Это 
поле используется для быстрой перерисовки испорченных изображений объ- 
ектов. Булево поле Егастепф равно фгоие, если объект содержит не предопреде- 
ленное изображение, а загруженный в объект фрагмент рисунка. 

Раздел ргоесёе@ класса содержит объявления ряда функций записи за- 
крытых полей класса. Кроме того, в разделе объявлена статическая перемен- 
ная Пи — указатель на объект этого класса. Поскольку переменная объявлена 
со спецификатором $4аЙс, класс содержит ее единственный экземпляр, неза- 
висимо от числа созданных объектов класса. В каждый момент Га будет ука- 
зывать на тот экземпляр объекта, который в данный момент активен и с кото- 
рым ведется работа. Еще один статический элемент, общий для всех объектов, 
это РагепСапуа$ — канава, на которой создается рисунок, на которую зано- 
сятся изображения объектов и из которой формируются изображения фраг- 
ментов. 

Свойства и методы раздела риб\е прокомментированы в коде и в дополни- 
тельных пояснениях, пожалуй, не нуждаются. 

После объявления класса следуют два оператора, инициализирующие ста- 
тические переменные. 

Ниже приведен код файла ЕРапеШ.срр, реализующего класс ТЕйхаге. 


#1пс1аае "ЕРапе]11.1В" 


__Еаз®са11 ТЕ1диге: :ТЕ1даге (ТМ1пСопЕго1* Омпег) 
: ТРапе]1 (Омпег) // конструктор по умолчанию 
// конструктор 
{ 
// создание панели 
ТРапе1: :ТРапе]1 (Омпег); 
// создание канвы 
ЕСапуаз = пем ТСопЕго1Сапуаз; 
ЕСапуа$->Соп®го1 = +1513; 
ЕСапуаз->ВгоазВ->Со1ог = с1\Б1е; 
Сагзог = сгНапаРо1п&; 
// создание объекта, хранящего изображение 
ЕВ1$тар = пем СгарВ1сз: : ТВ1 тар; 
Ебваре = Вес*апа; 
ВМР = пем СгарН1с$: : ТВ1Емар; 
ЕСо1ог = Сс1]В1асКк; 
// задание свойств панели 
Незаре = 50; 
Итаев = 50; 
Веуе1Оцфег = Бу№\№опе; 
Рагепе = Омпег; 
Н1пе = "Можете переместить объект, скопировать его или вырезать"; 
РориорМепи = Е1дРагат$->РорорМепи1; 
// заполнение окон диалога задания параметров Е1дРагатз 
Е1аРагат$->СопроВох1->Т$етТпаех = 5Баре; 
Е1аРагат$->Е91{1->Техе= М1а6р; 
Е1аРагат$->Е4а162->ТехЕ = Не1апе; 
Е1аРагапз->КаЯа1о0оСгойпр1->ТЕешТпаех = 0; 
Е1аРагам$->Со1огВох1->5е1есфеа = с1В1асК; 
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__Еазса11 ТЕ1даге;: : “ТЕ1доге (у0194) 


—— 


// деструктор 
ЕСапуаз->Ггее (); 
ЕВ1кмар->Егее (); 
ВМР->Егее (); 


у01А __ЕазЕса11 ТЕ1даге: :Огам () 
{ 
// прорисовка изображения на канве объекта 
1Е(! Тм) гебоагп; 
ВМР->М1Аеи = Мафв; 
ВМР->Не1айе = Не1аре; 
ВМР->Сапуаз->Реп->Со1ог = ЕСо1ог; 
ВМР->Сапуаз->Вгизп->Со1ог = с1МБ1е; 
ВМР->Сапуаз->Е111Кес® (С11еп®Вес*); 
$м16ср (Е5Баре) 
{ 
сазе Весфапа:ВМР->Сапуаз->Кесфкапа1е (С11еп Вес®); 
Бгеак; | 
сазе Е111р$: ВМР->Сапуа$->Е111рзе (ВКес® (1, 1, Млаей, Не190%)); 
Ьгеак; 
сазе Тг1апа: { 
ТРо1пЕ ро1пе$[3]; 
ро1п&$[0] = Ро1п® (Изаев / 2, 0); 
ро1пе5 [1] Ро1п+ (И1аен, Не1аЬ*-1); 
ро1пе$ [2] Ро1пе (0, Не1лаве-1); 
ВМР->Сапуа$->Ро1удоп (ро1пЕ$, 2); 
} 
Ьгеак; 
сазе Е1ч4: ВМР->Сапуаз->5ЕгеесВОгам (С11епВКесе, ЕВ1®мар); 
} 
1Е (Егадтепф) 
{ 
ВМР->Сапуаз$->СоруМо4ае = стбгсТпуеге; 
ВМР->Сапуаз->ОгамГосизВесе (1т->С11епЕВес®); 
ВМР->Сапуа$->СоруМо4е = спибгсСору; 
о 
ЕСапуаз->Огам (0, 0, ВМР); 


Уу01А __ Еаз®са11 ТЕ1аоге: :Моцзеромт (ТМоцзеВие оп Виаефоп, 
С1аззез: :Т5р1ЕЕбфафке $В1ЕЕ, 116 Х, 116 У) 
{ 
// занесение значений параметров объекта в окно диалога 
Е1аРагаптз->СотЬоВох1->Т+етмТпаех = заре; 
Е1аРагатз->Еа1%1->Техе= Млаей; 
Е1аРагапз->Еа1е2->ТехЕ = Не1оаре; 
Е1аРагат$->Каа1оСсгоир1->ТеемТпаех = 0; 
Е1аРагап$->Со1огВох1->5е1есфеа = Со1ог; 
// запоминание в Тт указателя текущего объекта 
Ти = 6018; | 
// перетаскивание объекта 
Ве1еазеСареаге (); 
&51$->РегЕогм (ИМ 5У5СОММАМР, 0хЕО12, 0); 


Уу01А __ЕазЕса11 ТЕ1даге: : 0Ь1С11сК (\0194) 
{ 


// вызов диалога задания параметров объекта 
Р1аРагатз->5По\м (); 
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у01А __Еаз®са11 ТЕ1даге:; :Ра1п® (\%о019а) 
{ 
// обработчик события ОпРалпЕ 
ТЕ (Тм) 
ГЕСапуаз->Огам (0, 0, ВМР); 


// задание цвета пера 


1Е(! Тм) гебагп; 

ЕСо1ог = Со1охг; 

Огам (); 

} 
Ииннннннннннннннннн--н========================-==-=- 


\01А __Еаз®еса11 ТЕ1ааге;: : 5е Варе (Т5Вар 5таре) 
{ 


// изменение изображения объекта 


1Е(! Тм) гебогп; 

Ебраре = 5раре; 

Огаи (); 

} 
ИЕН ------------ 


У01А __ Раз®са11 ТЕ1диге: : $5е В1Е мар (СгарН1сз: :ТВ1етар *В1мтар) 


// задание рисунка объекта 


1Е(! Тм) гебагп; 

ЕВ1$пар->Азз1адп (В1фтар); 

Огам (); 

} 

Инна --------------------- 


\у01А __Еаз®са11 ТЕ1даге;: : бе 512е (116 МемИ1аЕи, 1пе МеиНе1ате) 
{ | 

// задание размеров объекта 

ИтаЕв = МеммМ1аер; 

НезапЕ = МемНе1апе; 

Ргам (); 


У01А ТЕ1ааге : : ЕлаСгеа%е (ТИ1пСопего1 *беп4аег, ТСапуа$ *Сапуаз) 
{ 

// создание нового объекта с диалоговым заданием 

// размера, цвета, изображения 

Тм = пем ТЕ1дааке (бепаег); 

Ти->Рагеп®Сапуа$ = Саптаз; 

Ти->ЕРЕгасшепЕ = Еа1$е; 

Тт->рхгам (); 

Р1аРагапт$->5Пом (); 


\У0о1А ТЕ1даге: : ЕлаСгеа®е (ТИ1пСопЕго]1 *бепаег, ТСапуаз$ *Сапуаз, 
ТВесе бойгсе, БРоо]1 Саф) 
{ 
// создание нового объекта из фрагмента боигсе канвы Сапуа$ 
// СаЕ - надо ли удалять фрагмент с канвы 
Ти = пем ТЕ1доаге (бепаег); 
Рагеп®Сапуа$ = Сапуаз; 
Ти->Егадиеп® = $гае; 
Ти->ЕРбваре = Е19; 
Та->ВоцпазВесе = боцгсе; 
Ти->ЕВ16тар->Незаре = Тиа->Не1апе; 
Ти->ЕВ1емар->И1аЕей = Га->мтаен; 
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Ти->ЕВ1 Смар->Сапуа$->СоруВес® (Тм->С11епЕВесе, Сапуаз, боигсе); 
1Е (Саб) Сапуаз->Е111Вес® (боигсе); 
Ти->Огам (); 


%01Я ТЕ1диге: :ТоСапуаз (Боо1 Саф} 


{ 
// копирование или вырезание изображения на канву 
1Е (Тм) 
| | 
1Е (Ти->Егаатеп®) 
{ 
// стирание рамки 
Ти->ВМР->Сапуа$->СоруМо4ае = ст5бгсТпуеге; 
Ти->ВМР->Сапуа$->ОгамРоса$Вес* (Ти->С11епЕКВесЕе); 
Ти->ВМР->Сапуа$->СоруМоае = стбгсСору; 
} 


Рагеп*Сапуаз->СоруВес® (Ти->Воипа$Весь, 
Ти->ВМР->Сапуаз, 
| Ти->ВМР->Сапуаз->С11рВес®); 
1Е(Саф) Тм->Егее(); | 
е1зе 1Е (Тм->Егаатеп®) 
{ 
Тп->ВМР->Сапуаз->СоруМоае = стбгсТпуег&; 
Ти->ВМР->Сапуаз->ОгамРосазКес® (Тт->С11епЕВесе); 
Ти->ВМР->Сапуаз->СоруМоае = сибгхсСору; 
} 
} 
} 


Функция ТЕгиаге является конструктором класса. В качестве параметра 
конструктор воспринимает владельца компонента Омпег. Сначала вызывается 
конструктор базового класса ТРапе]. Затем создается объект канвы класса 
ТСошго!Сапуа$ и присоединяется через свойство Соп@го] к данному объекту. 
Курсор объекта задается равным сгНапаРошф, что будет свидетельствовать 
о возможности перетаскивать объект. Затем создается объект ЕВЁтар, кото- 
рый будет хранить изображение или фрагмент рисунка, отображаемый объек- 
том. Создается также объект ВМР, в котором будет храниться изображение 
всей поверхности объекта. Задаются параметры панели объекта: размеры, бор- 
дюр, родительский компонент, подсказка Н1ш\ф, контекстное меню. Объект 
контекстного меню создан на форме ЕиРагатз, поскольку модуль реализации 
класса ЕРапе.срр не имеет формы. На этот объект контекстного меню и дает- 
ся ссылка в свойстве РорирМепи. | 

Последние операторы конструктора заносят в форму настройки парамет- 
ров (она будет описана далее) текущие значения параметров объекта. При за- 
несении индекса выпадающего списка, определяющего форму изображения, 
учитывается, что последовательность строк в этом выпадающем списке соот- 
ветствует последовательности перечисления значений в типе ТЗВар (см. опи- 
санный выше файл ЕРапеШ.й). Поэтому индекс может задаваться присвоением 
ему значения свойства ЭВаре. 

Функция -'ТЕ7цгаге является деструктором класса ТЕ1хиге. В ней освобожда- 
ется память, выделенная в конструкторе под объекты ЕСапуа$, ЕВЁитар, ВМР. 

Функция Огам осуществляет заданное изображение на поверхности объек- 
та. Но сначала это изображение формируется на канве объекта ВМР. Размеры 
этого объекта задаются равными размерам самого графического объекта. Мето- 
дом ЕШЖес& поверхность канвы заливается белым цветом, указанным для кис- 
ти канвы. Затем следует структура змЦеВ, заносящая на канву объекта ВМР то 
или иное изображение в зависимости от заданного значения Е5Варе. 
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Для прямоугольника и эллипса изображение рисуется соответственно ме- 
тодами Вефап е и ЕШрзе. Для треугольника формируется массив ро, за- 
полняемый координатами вершин треугольника, после чего изображение фор- 
мируется методом Ро]угоп. Для рисунка изображение заносится методом 
5 {гесВОгау из объекта ЕВ &тар, куда оно ранее должно быть занесено. Если 
изображение является фрагментом рисунка (Ега’теп& = фгае), то по его пери- 
метру методом ОгамЕосизВесё рисуется рамка из точек. Предварительно ре- 
жим копирования задается равным стЭгетуегф, что обеспечит в: последствие 
возможность стереть рамку. 

В заключение изображение из ВМР копируется на канву ЕСапуа$ графи- 
ческого объекта методом Огам. 

Функция Моизеро\уи является обработчиком события, связанного с нажа- 
тием кнопки мыши над графическим объектом. В начале функции так же, как 
в описанном ранее конструкторе, заносятся в компоненты формы Е1Рагатз 
текущие значения параметров объекта. Таким образом, если в данный момент 
окно диалога Е17Рагатз открыто, то в нем сразу отобразятся параметры объ- 
екта. Затем обработчик запоминает в переменной Пи указатель на текущий. 
объект, т.е. регистрирует этот объект как активный. После этого реализуется 
способ буксировки объекта, описанный в разд. 5.2.3. 

Функция БЫСПеК является обработчиком двойного щелчка на графиче- 
ском объекте. В этом обработчике так же, как в описанном ранее конструкто- 
ре, заносятся в компоненты формы ЕшРагатз текущие значения параметров 
объекта, после чего методом ЭВо\ открывается эта форма. Форма открывается 
не как модальная, так что пользователь может выходить из нее в окно главной 
формы. Но в свойстве формы Е1Рагатз свойство Еогт5{Яе задано равным 
55$ауОпТор. Благодаря этому окно главной формы не заслоняет окно формы 
настройки параметров. | 

Функция Раш является обработчиком события ОпРашф, позволяющим 
восстановить изображение графического объекта в случае, если оно испорчено 
какими-то перекрывающими его окнами. В этом обработчике изображение из 
объекта ВМР копируется на канву ЕСаптуаз. 

Функции Зе Соог, Зе ЗВаре, Зе ВЁ тар, 5е{5$12е заносят в объект но- 
вые значения соответственно цвета пера, типа изображения, рисунка и раз- 
меров. В конце каждой из этих функций вызывается описанная ранее функ- 
ция Огау, обеспечивающая перерисовку изображения в соответствии с новы- 
ми параметрами. 

Первый вариант функции Е1оСгезже создает новый объект предопределен- 
ного типа. В функцию передаются в качестве параметров Зеп4дег — контейнер, 
в котором будет размещаться объект, и внешняя канва Сапуа$, на которую мо- 
жет копироваться изображение объекта. Сначала вызывается конструктор объ- 
екта, в него передается значение Зепфег, и указатель на созданный объект зано- 
сится в переменную Па. Таким образом, объект регистрируется как активный. 
Далее в РагепСапуа$ запоминается указатель на внешнюю канву Саптаз, 
и в объекте устанавливается Егабтепф = Ёа15е, свидетельствуя о том, что объект 
создается не для фрагмента рисунка. Далее вызывается функция Огам, рисую- 
щая изображение, и пользователю показывается форма Е1Рагатз. 

Второй вариант функции Е1Сгезжфе создает новый объект с изображением, 
формируемым из фрагмента рисунка, имеющегося на внешней канве, указатель 
на которую передается в функцию параметром Сапуа$. Помимо параметров, 
имевшихся в предыдущем варианте функции, в данном случае фигурируют па- 
раметры Зоигсе — область рисунка, которая должна быть перенесена в объект, 
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и параметр Саф, который указывает, должна ли эта область удаляться из исход- 
ного рисунка. Первые операторы функции не отличаются от рассмотренных ра- 
нее. Далее размер объекта Воипд$Весй задается равным размеру области 
Зоигсе. Затем заданный фрагмент копируется с указанной канвы на канву объ- 
екта ЕВитар. Если параметр Саф равен фгае, то область на внешней канве 
Сапуа$, из которой проводилось копирование, стирается методом ЕШКВес%. 

Функция ТоСапуа$ копирует на внешнюю канву изображение из объекта. 
Если объект хранит фрагмент рисунка, то сначала в объекте ВМР стирается 
рамка, обрамляющая изображение. Затем изображение из ВМР копируется на 
внешнюю канву. Если параметр Саф равен фгие, то объект уничтожается мето- 
дом Егее. В противном случае, если объект содержит фрагмент рисунка, во- 
круг него опять рисуется рамка. 

Теперь рассмотрим модуль формы настройки параметров ИЁРРагатз$1. Эта 
форма во время выполнения показана на рис. 5.9 6. Список СошфоВох1 осуще- 
ствляет выбор типа изображения, компонент Со]огВох1 позволяет задать цвет 
пера, окна редактирования ЕЧИ1 и ЕЗИ2 определяют соответственно ширину 
и высоту объекта. Группа радиокнопок Ка41юоСгопр1 позволяет переместить 
объект на передний или задний план. Помимо видимых компонентов на форме 
расположен объект контекстного меню РорирМепи1, который привязывается 
к объекту в конструкторе, рассмотренном ранее в описании класса ТЕ1хаге. 

Ниже приведен основной код файла ИЕРагатз1.срр. 


Сгарр1с$: :ТВ16мар * Е1аВпр; 


у01А _ Еазса11 ТЕ1аРагамз: : ЕогиСгеаке (ТОБ)]есе *5епаег) 
{ 

// загрузка изображения в Е1аВтр 

Е1аВшр = пем Сгарр1с$: :ТВ16 мар; 

Е1аВир->ГоааЕгопЕ11е ("си$1.Бтр"); 


у01А __ЕазЕса11 ТЕ1аРагамз: : Гоги )езекоу (ТОБ)]ес® *5епаег) 
[ 

// удаление Е1аВтр 

Е1аВпр->Егее (); 


у01А __ЕазЕса11 ТЕ1аРагатмз : : СопроВох1Спапае (ТОБ)]есе *5епаег) 
{ 
// задание вида изображения 
зм1Еср (СошроВох1->ТеЕешТпаех) 
{ . 


сазе 0: ТЕ1аиге: : Тт->5раре = Вескапд; 
Ргеак; 

сазе 1: ТЕ1даге;: :Ти->5Паре = Е111рз; 
Бгеак; 

сазе 2: ТЕ1даге: :Ти->5Варе = Тгтапа; 
БгеаК; 


сазе 3: ТЕ1даге: : Ти->ИтаЕев Е1аВпр->Мтаей; 
ТЕ1аиге: : 1и->Незаве = Е1лаВпр->Не1аре; 
ТЕ1доге: : Тт->В16тар = ЕлаВптр; 
Еа1%1->ТехЕ = ТЕ1даге: : т->Итаен; 
Еа1$2->Техе = ТЕ1аиге: : Тит->НетарЕ; 
ТЕ1аиге: :Ти->бБаре = Е1ча; 
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\01А _ Еаз®са11 ТЕ1аРагамз: :Ка@1обгопр1С11сКк (ТОБ)есе *бепаег) 
{ 
// перемещение объекта на передний или задний план 
$м16ср (Каа1оСбгоир1->Т$емТпаех) 
{ 
сазе 0: ТЕ1даге: : Тт->Вг1паТоЕгопе® (); 
Бгеак; 
сазе 1: ТЕ1даге: : Ти->бепаТоВаскК(); 


У01А __Еазфса11 ТЕ1аРагамз: :Со1огВох1Спапде (ТОБ)]ес® *5бепаег) 


// изменение цвета пера 
ТЕ1аиге: :1и->Со1ог = Со1огВох1->5е1ес%еа; 


\01А _ Еаз®са11 ТЕ1аРагамз: :Еа161Ех1® (ТОБ]есе *5епаег) 
{ . 
1Е(! Еа11->Моа1Е1леа) гебагп; 
Еа1{1->Моа1Е1еа = Еа1зе; 
// ширина объекта 
116 И = ЗЕГТотТае (Еа11->Тех®); 
// если $5Варе = Е19, то пропорциональное изменение высоты 
1Е (ТЕзааге: :Ти->браре == Е19а) 
Еа12->ТехЕ = ТпЕТоЗх ( 
ТЕ1даге: : Ти->Не19не * М / ТЕ1доге; : Ти->М1аев); 
// высота объекта 
10 Н = ЗЕгТотТп® (Еа12->Тех®); 
// установка размеров 
ТЕ1аоге: : Ги->5е65127е (И, Н); 


\01А __Еаз&са11 ТЕ1аРагатз: :Е9161Кеуромп (ТОБ)ес® *5епаег, 
ИОВР &Кеу, Т5В1ЕЕ5фаее $11Е%) 


{ 


// при ЕпЕегк уход на установку размеров 
1Е(Кеу == УК_ВЕТОВМ) 
Еа11Ех1 (Зепаег); 


\01А __Еаз®са11 ТЕ1аРагамз: :Е4162Ех1 (ТОБ)есе *5епаег) 
{ 
1Е(! Еа162->Моа1Е1еа) гебагп; 
Еа1*2->Моа1Е1еа = Еа1$е; 
// высота объекта 
11 Н = ЗЕгТотре (Еа1&2->Тех®); 
// если $5Варе = Е19, то пропорциональное изменение ширины 
1Е (ТЕ1даге: :Тп->5Варе == Е19) 
Еа11->ТехЕ = ТпЕТобек ( 
ТЕ1аиге: : Ти->Итаер * Н / ТЕ1ааге: : Ти->Не198®); 
// ширина объекта ` 
1пЕ МИ = ЗЕсТоТпЕ (Еа11->Тех®); 
// установка размеров 
ТЕ1аиге: : Ги->5ееб12е (И, Н); 


У01А __Еаз®са11 ТЕ1дРагамз : :Е91Е2Кеуромп (ТОБ)]есе *Зепаег, 
_МОВО &Кеу, Т5П1ЕЕ5фаее $11Е%) 


// при ЕпЕегк уход на установку размеров 
1Е(Кеу == УК_ КЕТОВМ) 

Еа1$2Ех1* (бЗепаег); 
} 
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Уу014 _ Еаз®са11 ТЕ1дРагамз: :№1С11сК (ТОБ)есе *бепаег) 
{ 


// Раздел меню "На задний план" 
ТЕзаиге: : Ти->бепаТоВаск (); 


Уу01А __Еаз®са11 ТЕ1аРагамз: :№2С11сК (ТОБ)есе *Зепаег) 
{ 


// Раздел меню "Удалить" 
ТЕ1аоге;: : Ти->Егее(); 


\У01А __Еаз®са11 ТЕ1дРагамз: :№3С11сК (ТОБ)]есе *5епаег) 
{ 


// Раздел меню "Копировать в рисунок" 
ТЕ1аиге: :ТоСапуа$ (Ёа1зе); 


} 


уо1а __ Фазкса11 ТЕ1аРагкамз : :№4С11сК (ТОБ)]есЕе *5епаег) 
{ 


// Раздел меню "Вырезать в рисунок" 
ТЕ1диге: :ТоСапуаз (Е гце); 


} 


Код достаточно простой и особых пояснений не требует. В заголовочном 
файле этого модуля имеется ссылка на файл РРапеШ.й. Так что в модуле мож- 
но использовать объявленный там тип ТЗВаре и класс ТЕ1хиге. Вся работа ве- 
дется с активным графическим объектом, т.е. с тем, указатель на который за- 
писан в переменной Пи. В модуле объявляется глобальная переменная 
Е1©Вшр, в которую при созданиями формы загружается файл рисунка, ис- 
пользуемого в объекте при ЭВаре = Е!1х. 

Функция СошБоВох1СПВапре является обработчиком события ОпСВапге 
списка СотБоВох1. В зависимости от выбора пользователя в функции задает- 
ся свойство ЭВаре объекта. Если пользователь выбрал тип объекта "рисунок", 
то изображение из Е1Вшр переносится в элемент ВЁ_тар объекта, а в окна 
ЕЗДИТ и ЕЗН2 заносятся размеры изображения. Функция ВаФюоСгопр1СПеК 
обеспечивает при щелчке пользователя на кнопках ВаФоСгоир1 перемещение 
объекта на передний или задний план. Функция Со]огВох1СВапое обеспечива- 
ет передачу в объект цвета, выбранного пользователем в списке СоогВох1. 
Функции ЕЧИЛЕхц и ЕЧИ2ЕхЫ являются обработчиками событий ОпЕх& окон 
редактирования. Если пользователь покидает окно редактирования и данные 
в нем изменены, то считывается новое значение размера. При ЭВаре = Е1х зна- 
чение другого размера изменяется пропорционально, чтобы не исказить пропор- 
ции рисунка. Затем новые размеры передаются в объект методом 5е{5$17е. Ана- 
логичные операции выполняются, если пользователь, находясь в окне редакти- 
рования, нажал клавишу Ещег (функции Е 1Кеу)омп и Е Ц2Кеуромт). 
Функции М№1СЦеКк, М2СНск, МЗСПеК являются обработчиками щелчков на 
разделах контекстного меню. | 

Нам осталось рассмотреть модуль (ЕГМат!1 главной формы приложения. 
Эта форма содержит компонент меню МашМепи1, диалоги открытия и сохра- 
нения графических файлов ОрепР1сеёиге 1а]1о51 и ЗауеР1е ге 1а1о51, полосу 
состояния Эф абазВаг1, и компонент пабе], занимающий всю клиентскую об- 
ласть формы. Модуль обеспечивает только несколько простейших операций, 
необходимых для иллюстрации работы с графическими объектами: создание 
нового объекта предопределенного типа, копирование или вырезание изобра- 
жения объекта на канву Ппаре1, создание нового объекта с рисунком, скопи- 
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рованным или вырезанным из канвы Ппабе1, простейшие операции с файла- 
ми. Попутно решается вспомогательная задача выделения фрагмента рамкой. 

Ниже приведен код этого модуля, в заголовочном файле которого имеется 
ссылка на файл ЕРапе М.П. 


Боо1 ВВед1п = Еа1зе, // флаг операции выделения фрагмента 


ВСаф, // флаг операции вырезания фрагмента. 
ВРгер = Ёа1зе; // флаг начала выделения фрагмента 
10 ХО, У0; // начальная точка рамки фрагмента 


ТВесе В; // текущая область рамки фрагмента 


у01А __Еаз®са11 ТГогм1: :№1С11сК (ТОБ]есе *5епаег) 

{ 

// создание нового объекта (раздел меню "Объекты | Новый") 
ТЕ1диаге: : РГлаСгеаее (РГогм1, Ттаде1->Сапуаз$); 


у014 __ Еазеса11 ТЕогш1: :№2С11сК (ТОр]ес® *5епаег) 

{ 

// копирование на канву 

// (раздел меню "Объекты | Копировать в рисунок") 
ТЕ1ааге; :ТоСапуа$ (Ёа1$е); 


} 


\01А _ Еаз®са11 ТРоги1 : :№3С14 ск (ТОБЗесе *бепаег) 
{ 
// вырезание изображения на канву 
// (раздел меню "Объекты | Вырезать в рисунок") 
ТЕ1ааге: :ТоСапуаз (&гае); 


у01А _ Еаз®са11 ТРГогш1:; :№4С11сКк (ТОБ)ес® *5епаег) 
{ 
// раздел меню "Рисунок | Копировать из рисунка" 
// переход в режим копирования фрагмента в объект 
ВКРгер = &гае; 
ВСае = Еа15е; 
// задание режима копирования . 
Тпаче1->Сапуаз->СоруМоае = стбгсТпуеге; 
ЗЕаса$Ваг1->5$1тр1еТехе = 
"Укажите мышью первый угол копируемого фрагмента"; 


У01А __ Еаз®са11 ТКогм1: :№5С11сК (ТОр)есЕ *5епаег) 
{ 
// раздел меню "Рисунок | Вырезать из рисунка" 
// переход в режим вырезания фрагмента в объект 
ВРгер = ВСае = Егае; 
// задание режима копирования 
Тпаче1->Сапуаз->СоруМо4е = стбгсТпуегЕ; 
ЗЕабазВаг1->51тр1еТехЕ = 
"Укажите мышью первый угол вырезаемого фрагмента"; 


У01А __Газ®са11 ТГогм]1 : : Ттаде1Мочзеромп (ТОБ)есе *бепаег, 
ТМоцзеВвВиа оп Воееоп, Т$5Р1ЕЕбфбафе $5В1ЕЕ, 11% Х, 116 У) 

{ 

1Е(! ВРгер) гебагп; 

// ввод начальной точки рамки фрагмента 

ВРгер = Еа15е; 

ВВеч1п = Егие; 

ЗфабизВаг1->$51тр1еТехе = "Проведите мышью рамку фрагмента"; 
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// запоминание начального положения курсора мыши 

ХО =хХ; 

УО = У; 

// формирование начального положения области фрагмента 
ВК.Тор = Х; 

К.Воебом = Х; 

В.ТеЕе = У; 

В.В1аре = У; 

// рисование рамки 

Тпмаче1->Сапуаз->ОгамРГосизВес® (К); 


у01А __Еа$®са11 ТКогм1; :; Гпаде1МочзеМоуе (ТОБ)]есе *5епаег, | 
Т5В1 ЕЕ бабе $Р1ЕЕ, 1пЕ Х, 11 У) 

{ 

1Е(! ВВед1п) гебоагп; 

// перемещение мыши при рисовании рамки фрагмента 

// стирание прежней, рамки 

Тпмаде1->Сапуаз->ОгамРосазВес® (В); 

// Формирование области В 

1Е(Х0 < Х) {В.ТеЕЕ = ХО; В.В1арЕ = Х;} 

е1зе {К.ЦеЕЕ = Хх; К.В1аре = Хо;} 

1Е(%У0 < У) {В.Тор = У0; КВ.Вобеом = У;} 

е1зе {К.Тор = У; В.Воебом = У0;} 

// рисование новой рамки 

Тпаде1->Сапуа$->РгамРосоазВес® (В); 


\01А __Еаз®са]11 ТГоги1:; : Ттмаде1Моцзе Ор (ТОБ)есе *5епаег, 
ТМопзеВае оп ВаеФоп, 
Т501ЕбЗбаее $Р1ЕЕ, 1пЕ Х, 1106 У) 


1Е(! ВВед1п) гебагп; 

// завершение формирования рамки фрагмента 

// стирание рамки 
Тпадче1->Сапуа$->ргамГосазВесё (В); 
Тпадче1->Сапуаз->СоруМоае = ст5гсСору; 

ВВед1п = Еа15е; 

// создание графического объекта 
ТЕ1аоге: : Р]аСгеаее (Гогм1, Ттаде1->Сапуаз, В, ВСие); 
ЗсабизВаг1->51тр1еТехе = ""; 


} 


\01А __Еаз®са11 ТКогш1: :№8С11сК (ТОБ}]есЕ *5епаег) 
{ 
// раздел меню Файл | Сохранить 
1Е (бауеР1сеигер1а1о91->Ехесие ())} 
Тпадче1->Р1сфиге->бауеТоЕ11е (бЗауеР1секоаге01а1091->Е11еМапе); 


Уу01А _ Еаз®са11 ТГогм1: :М№9С11сК (ТОБ]есе *5епаег) 
{ 
// раздел меню Файл | Открыть 
1Е (ОрепР1сеигер1а1о31->Ехесиее ()) 
Тиаде1->Р1скиге->ГоаЧаЕгомЕ11е (ОрепР1сеигер1а1о091->Е11еМапе); 


// раздел меню Файл | Выход 
С1озе (); 
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В приведенном коде заслуживают обсуждения, вероятно, только функции, 
обеспечивающие выделение фрагмента рамкой. Впрочем, это достаточно ру- 
тинные операции, реализованные в простейшем виде. Они подробно описаны 
в книге [1]. Так что ограничусь достаточно кратким пояснением. 

Если пользователь выбрал в меню раздел вырезания или копирования 
фрагмента в объект (функции М№4СПеК и №5СПсК), то флаг ВРгер, указываю- 
щий, что начинается процесс формирования рамки фрагмента, устанавливает- 
ся в фгие. Одновременно устанавливается в &гие флаг ВСиф, если выделенный 
фрагмент в дальнейшем должен быть вырезан, т.е. стерт на канве Ппазе1. Ре- 
жим копирования канвы устанавливается равным стЭгетуегё. Это обеспечи- 
вает возможность стирания рамки фрагмента, если ее повторно нарисовать на 
том же месте, на котором она была ранее нарисована. 

В обработчике Ппаге1Моизедо\мп события, связанного с нажатием кноп- 
ки мыши, проверяется флаг ВРгер. Если он равен фгие, значит, в этот момент 
пользователь указал координаты первого угла будущего фрагмента. Эти коор- 
динаты запоминаются в переменных ХО и У0, флаг ВРгер сбрасывается 
в Ра[5е, флаг ВВегт, свидетельствующий о начале формировании рамки, уста- 
навливается в фгие, в переменной В формируется текущее значение координат 
рамки, и рамка рисуется методом ОгамЕоси$ Вес. 

Функция Ппаре1 МопзеМоуе является обработчиком событий, происходя- 
щих при перемещении курсора мышти. Если при этом ВВер1т = фгие, то снача- 
ла применяется метод ОгамЕоси$Весф, повторно рисующий рамку при преж- 
нем значении В. Это обеспечивает стирание прежней рамки. Затем в соответст- 
вии с текущими координатами курсора производится переформирование об- 
ласти В. При этом обеспечивается правильное соотношение координат: левая 
грань области должна иметь координату меньше правой, а верхняя — коорди- 
нату меньше нижней. Затем рисуется новая рамка фрагмента. 

Функция Ппабе1 МоизеОр является обработчиком события при отпуска- 
нии пользователем клавиши мыши. Если при этом ВВегшт = фгие, значит, 
пользователь закончил формирование рамки фрагмента. Тогда методом Огам- 
РЕосизВес& стирается прежняя рамка, режим копирования возвращается к зна- 
чению по умолчанию ет$геСору, флаг ВВехт сбрасывается в #а|зе, и вызыва- 
ется метод Е1Сгезфе, обеспечивающий создание графического объекта с фраг- 
ментом, указанным областью В, в режиме, указанном флагом ВСиф. 

Конечно, в реальном графическом редакторе надо было бы предусмотреть 
еще ряд возможностей, связанных с рисованием, сохранением изображений 
в буфере обмена, заданием палитры, инструментария и т.п. Но все это никак 
не связано с темой данного раздела. Подробнее о разработке графических ре- 
дакторов и о способах реализации методов рисования вы можете посмотреть 
в книге [1]. 


5.3.1.2 Использование регионов 


Одним из недостатков рассмотренных в разд. 5.3.1.1 графических объек- 
тов является несоответствие их изображения и формы. Точнее, с прямоуголь- 
никами и прямоугольными рисунками все в порядке. А вот с треугольниками 
и эллипсами возникают некоторые проблемы. Поскольку, независимо от изо- 
бражения, все объекты построены на прямоугольных панелях, то при наложе- 
нии треугольника или эллипса на какое-то изображение часть этого изображе- 
ния закрывается белым прямоугольником, выходящим за пределы соответст- 
вующей фигуры. Хотелось бы, чтобы панель, несущая изображение треуголь- 
ника, была сама треугольной, а панель, несущая эллипс — эллиптической. 
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Это можно сделать с помощью регионов, рассмотренных в разд. 5.2.2. На 
диске, приложенном к книге, подобный вариант графических объектов реали- 
зован в каталоге СгОБ}] в проекте <ОРапе[2. Отличий этого проекта от рассмот- 
ренного ранее немного, кроме, конечно, других имен модулей. Коснулись они 
только двух методов: Огам и ТоСапуа$. Функция Огам теперь не только фор- 
мирует изображение на поверхности графического объекта, но и изменяет 
форму объекта, задавая для него регион. Ниже приведен код новой реализа- 
ции функции Огам. 


у01А __Еаз®са11 ТЕ1даге::Огам () 

{ 

// прорисовка изображения на канве объекта 
1Е(! Тм) гебагкп; 

ВМР->ИлаЕен = ИзаЕен; 

ВМР->Не19пе = Незаве; 
ВМР->Сапуаз->Реп->Со1ог = ЕСо1ог; 
ВМР->Сапуаз->Вгазв->Со]1ог = СМ е; 
ВМР->Сапуаз->Е111Кесь (С11епЕВес®); 

// прямоугольный регион по размерам панели 
НАСМ Вед1оп = СгеафеВесеВоп (0, 0, ИЛаеЕр, Нездье); 


$м16ср (ЕбБаре) 
{ 
сазе Весфапд:ВМР->Сапуаз->Кес®апа1е (С11епеВес®); 
Бгеак; | 
сазе Е111рз: ВМР->Сапуаз->Е1]1рзе (Вес® (1, 1, Илаей - 2, НелоавЕ - 2)); 
// эллиптический регион 
Вед1оп = Сгеа®еЕ111рЕ1сВап (0, 0, И"ЗаеЕвк, НездЪе); 
Ьгеак; 
сазе Тг1апа: { 
ТРо1пЕ ро1пЕ$[3]; 


ро1пЕ$[0] = Ро1п (Мтаев /д, 2); 
ро1пе$[1] = Ро1пЕ (М1аев-2, Незав*-2); 
ро1п6$[2] = Ро1п6 (2, Не1анЕ-2); 


ВМР->Сапуаз->Ро1удоп (ро1пёз, 2); 

// треугольный регион 

Ро1п*$[0] = Ро1п (ИЗАаеь / 2, 0); 

ро1лпЕ$ [1] Ро1п& (И1Ааев ,Не1оаье); 

ро1пз [2] Ро1п* (0,Неззаье); 

Вед1оп = СгеавеРо1удопВап (ро1пез, 3, АГТЕВМАТЕ); 

} 

Бгеак; . 
сазе ЁЕ1д: ВМР->Сапуа$->5ЕгефсИОгам (С11еп ВесЕе, ЕВ1®тар); 


} 

1Е (Ргаатеп®) 

{ 
ВМР->Сапуаз->СоруМо4е = стбгсТпуеге; 
ВМР->Сапуа$->ОгамГосазВес® (Ти->С11епВес®); 
ВМР->Сапуаз$->СоруМоае = смбгсСору; 

} 

// установка региона 

ЗеЕ\И1п4омВодп (Напа1е, Вед1оп, &гае); 

ЕСапуаз->Пгам (0, 0, ВМР); 

} 


В приведенном коде отмечены жирным шрифтом отличия от аналогичной 
функции, рассмотренной в разд. 5.3.1.1. Эти отличия сводятся к следующему. 
Перед прорисовкой изображений (перед структурой змЦеВ) создается в пере- 
менной Кег1оп регион, охватывающий всю поверхность графического объек- 
та. Это регион будет далее использоваться для прямоугольных графических 
объектов. Затем в структуре м еВ рисуются изображения, а при типах объек- 
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та Е5Варе, равных ЕШр$ и Ттапе, формируются непрямоугольные регионы. 
Для эллипса регион формируется функцией СгежеЕШриеВгт. Для треуголь- 
ника создается массив из трех точек, по которому полигон формируется функ- 
цией СгеафеРо]угопВ оп. Для непрямоугольных регионов надо иметь в виду, 
что граница региона может несколько ломаться. Так что линия, проведенная 
по самому краю региона, может прерываться. Поэтому лучше рисовать на по- 
верхности региона, отступя от границы на 1-3 пиксела. Это и сделано в приве- 
денном коде при рисовании эллипса и треугольника. 

После окончания прорисовки поверхности графического объекта сформи- 
рованный регион задается ему функцией Зе У т@домВоп. 

Теперь рассмотрим изменения в функции ТоСапуа$, переносящей изобра- 
жение из объекта в рисунок на внешней канве. Эти изменения связаны со сле- 
дующим. Ранее (см. в разд. 5.3.1.1) функция копировала методом СоруВес+ 
изображение из объекта ВМР на внешнюю канву. Но теперь это приведет 
к тому, что скопируется прямоугольная область без учета региона, так что все 
наши старания по созданию регионов для треугольников и эллипсов пойдут 
насмарку. Значит, надо переносить на канву изображение не из ВМР, а с кан- 
вы ЕСапуа$, контур которой изменен регионом. Ниже приведен код новой реа- 
лизации функции ТоСапуа$, в котором жирным шрифтом выделены изменен- 
ные или добавленные операторы. 


\01А ТЕ1аиге; :ТоСапуа$ (оо1 Саф) 

{ 

// копирование или вырезание изображения на канву 
1Е (Тм) 

{ 

1Е (Ти->Егадтеп®) 

{ 

// стирание рамки 
Тт->ВМР->Сапуа$->СоруМо4е = ст5гсТпуеге; 
[и->ВМР->Сапуаз->РгамКоси$Вес® (Тм->С11еп Весь); 
Ти->ВМР->Сапуаз->СоруМоае = ст5гсСору; 
Тт->ЕСапуаз->Огам(0, 0, Тм->ВМР); 

} 

РагепЕСапуаз->СоруВес* (Тт->ВопцпазВесе, 
Ти->ЕСапуаз, 
Тт->ВМР->Сапуаз->С11рВес®); 

1Е (Са®) Ти->Егее(); 
е1зе 1Е (1м->Егадшеп®) 

{ 

Тп->ВМР->Сапуаз->СоруМоае = стбгсТпуеге; 
Ти->ВМР->Сапуа$->ОгамРосизКесф (Ти->С11епВес®); 
Ти->ВМР->Сапуаз->СоруМоае = ст$гсСору; 
Тп->РСапуаз->О0гам (0, 0, Тм->ВМР); 

| 

} 

} 


Первая часть кода, как и раньше, в случае фрагмента стирает рамку во- 
круг него в объекте ВМР. Но поскольку использоваться далее будет изображе- 
ние не из этого фрагмента, а с канвы ЕСапуа$, то добавляется оператор, пере- 
носящий методом канвы Ога\м изображение из ВМР на ЕСаптаз. Далее мето- 
дом СоруКесё изображение с канвы ЕСапуа$ копируется на канву Рагепф- 
Сапуа$. Размеры области копируемого изображения берутся из ВМР. Однако 
так как ЕСапуа$ канва ограничена регионом, в действительности копируется 
только то, что расположено внутри области региона. Далее, если объект хра- 
нит фрагмент, и был задан режим копирования, а не вырезания, восстанавли- 
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вается рамка в объекте ВМР и изображение вместе с рамкой переносится мето- 
дом Огам на канву ЕСаптуа$. 

Больше никаких изменений в проекте СОРапе[2 по сравнению с проектом 
СОРапе[3 нет. 


5.3.1.3 Вращение объектов 


В некоторых приложениях требуется иметь возможность поворачивать 
графические объекты. В разд. 5.5 показано, как можно осуществить преобра- 
зование координат, связанное с поворотом изображения. Обсудим, как мож- 
но добавить вращение объектов в рассмотренный выше редактор. Такой ва- 
риант редактора вы найдете в проекте СОРапе[3 в каталоге СтОб}] на диске, 
приложенном к книге. На рис. 5.10 показано это приложение во время выпол- 
нения. Как видите (рис. 5.10 а), объекты могут наклоняться под любыми уг- 
лами. При этом наложение объектов друг на друга, в частности, наложение 
треугольников и эллипсов, не приводит к стиранию части изображения бе- 
лым прямоугольником, выходящим за пределы соответствующей фигуры. 
Это осуществляется за счет рассмотренных в разд. 5.3.1.2 регионов, обеспе- 
чивающих непрямоугольную форму объектов. 


‚. Графические объекты на основе панелей — 


файл Объекты Рисунок 


Рис. 5.10 а) 
Редактор на основе панелей 

с регионами: главное окно (а) 

и окно настройки параметров 

объекта (6) | 


Форма 


рисунок * | _ 20 
Цвет Высота 


| [И сВ!аск "| 


На вспомогательной форме настройки параметров (рис. 5.10 6) введено до- 
полнительное окно ЕЯЦЗ, в котором пользователь может задавать угол накло- 
на объекта. Собственно, к этому сводится внешнее изменение проекта по срав- 
нению с предыдущим. Однако описание класса объекта существенно измене- 
но. Рассмотрим некоторые проблемы, которые требуется решить, чтобы обес- 
печить возможность вращения объектов. 

Основная проблема связана с тем, что при вращении прямоугольной фигу- 
ры вокруг ее центра ее контуры выходят за пределы начальной прямоугольной 
области. Если стороны прямоугольника равны У и Н, то ее диагональ О опре- 
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деляется соотношением О? = \\? + Н2. При вращении диагональ может прини- 
мать как горизонтальное, так и вертикальное положение. Значит, чтобы при 
вращении все точки исходного прямоугольника отобразились в области, на ко- 
торой рисуется фигура, ширина и высота этой области должны быть равны О. 
Таким образом, если ранее размеры панели объекта и изображения на ней сов- 
падали друг с другом, то теперь надо вводить в класс объекта поля, соответст- 
вующие размерам изображения, а размер панели вычислять, исходя из разме- 
ров изображения и угла поворота. Это нетрудно сделать. Но для упрощения 
кода и его большей прозрачности в приведенном примере панель делается 
квадратной со стороной, равной О. Это гарантирует возможность любого пово- 
рота, правда, несколько ухудшая внешний вид графического объекта при его 
перемещении. 

Задание размеров панели, превышающих размеры изображения, делает 
еще более необходимым использование регионов. Иначе даже для прямоуголь- 
ников будет получаться окружающая их пустая область, загораживающая 
другие объекты. 

Ниже показано новое объявление класса объекта ТЕ1хиге, в котором жир- 
ным шрифтом выделены объявления элементов, отсутствовавшие в классе, 
описанном в разд. 5.3.1.1. 

с1аз$ ТЕ1зааге : руб11с ТРапре1 


{ 


рг1уаее: 
ТСоп+го1Сапуаз *ЕСапуаз; // канва 
Тбрар Е$Ъаре; // тип изображения в объекте 
ТСо1ог ЕСо1ог; | // цвет пера 
Сгарр1с$: :ТВ16 мар *ЕВ16мар; // картинка в объекте 
Сгарр1сз: :ТВ1Етар *ВМР; // полная картинка объекта 
роо1 Егаамепе; // создан ли объект из фрагмента 
116 ЕНезаье, ЕИаеь; // размеры изображения 
ЯозЬ1е ЕАпа1е; // угол 

ргофесееа: | 
// установка поля ЕВ1Етар - картинки в объекте 


Ууо1а __Еазеса11 5еЕВ1Етар (бгарп1сз: :ТВ1емар *В1емар); 
// установка поля ЕСо1ог - цвета пера 
у01А __Еазса11 5ееСо]1ог (ТСо1ог Со1ог); 
// установка поля Е5раре - типа изображения в объекте 
У01А __ЕазЕса11 5ее5Таре (Т5рВар 5варе); 
// установка размеров 
Уо1Аа _ Еазеса11 5ее512е (1пе МемИ1аев, 1пе МемНе190®); 
// установка и чтение угла 
у01А __Еаз&са11 З5ееАпда1е (Ч4очЬ1е МемАпате); 
дочЬ1е_ __#аз%са11 СееАпа1е (уо14); 
// указатель на текущий активный объект 
$фае1с ТЕ1диге * Тм; 
// канва контейнера, в котором рисуются изображения объектов 
$фае1с ТСапуаз *Рагеп&Сапуаз; 
рур11с: 
// конструктор 
__Еаз®са11 ТЕ1адаге (ТИ1пСопЕго1* Омпег, ТСапуаз *Сапуаз}); 
// деструктор 
__Еаз®са11 -ТЕ1ааге (\%0о14а); 
// прорисовка изображения на канве объекта 


Уу01А __ЁЕазеса11 Огам (уо1а); 
// свойство В1Етар - картинка в объекте 
_ ргорекЕу СгарВ1сз$::ТВ1& мар *В1етар = {геаЯ=ЕВ1® тар, 


иг1се=бееВ16 тар, ЧеЕац1%*=6 гие}; 
// свойство Со]ог - цвет пера 
_ ргорег®у ТСо1ог Со1ог = {геаа=ЕСо1ог, мг1®е=5ееСо1ог, АаеЕац1%=6 гие}; 
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// свойство 5Варе - тип изображения в объекте 
__ргорегеу Т5рар 5Варе = {геаЧ9=Е5Паре, мг1®е=бее5раре, 
ЧаеЁац1+=Ехое}; 
// свойство Апд1е - угол поворота объекта 
__ргорегеу аозЬ1е Апд1е = {геад=бееАпа]е, мчг1Ее=5е%Апо1е, 
еёаз1+=%Егое}; 
// обработчик события ОпМоизероип 
РУМАМТС уо0о1а __Еаз®са11 Моцзеромп (ТМопзеВие®оп ВаеФоп, 
| С]аззез: :Т5$61Е& бабе $В61ЕЕ, 11% Х, 11% У); 
// обработчик события ОпрЬ1С11ск 
РУМАМТС уо14а _ Еаз®са11 0Ю1С11сК(\о1а); 
// обработчик события ОпРа1пЕ 
У1г6ца1 уо1а _ Еаз®са11 Ра1п® (уо1а); 
// создание нового объекта с диалоговым заданием 
// размера, цвета, изображения 
зфаф1с уо1а Е1аСгеае (ТИ1пСопЕго1 *бепаег, ТСапуаз$ *Сапуаз$); 
// создание нового объекта из фрагмента рисунка 
$$аф1с уо1а Е1аСгеа*е (ТМ1пСопего1 *бепаег, ТСапуаз *Сапуаз, 
ТВесЕе боигсе, Боо1 Са); 
// копирование или вырезание изображения объекта в рисунок 
$фаф1с уо1аА ТоСапуаз$ (Ъоо1 Са%); 
// дружественный класс 
Ег1лепа с1аз$ ТЕ1аРагамз; 


}; 


В закрытый раздел класса добавлены поля ЕНеасВ$ и Е\1О, в которых 
хранится высота и ширина изображения. Добавлено также поле ЕАп ще, в ко- 
тором. хранится угол поворота изображения в радианах. Поскольку пользова- 
телю удобнее задавать угол в градусах, в класс введено свойство Апе, ис- 
пользующее функции чтения и записи СбефАп]е и Зеё Ап ]е. Эти функции 
осуществляют взаимный пересчет градусов и радиан. 

Ниже приведены коды реализации тех функций-элементов класса, кото- 
рые отличаются от рассмотренных в разд. 5.3.1.1 и 5.3.1.2. Как и раньше, 
жирным шрифтом выделены введенные в код изменения. 


__Баз®са11 ТЕ1адиге: : ТЕ1даге (ТИ1пСоп®го1* Омпег) 
: ТРапе1 (Омпег) // конструктор по умолчанию 
// конструктор 
{ 
// создание панели 
ТРапе] : :ТРапе]1 (Омпег); 
// создание канвы 
ГСапуаз = пем ТСопфго]1Сапуаз; 
ГСапуаз->Соп®го1 = %11$; 
ЕСапуа$->ВгизВ->Со1ог = с1ИВ1е; 
Сигзог = сгНапаРо1пЕ; 
_/И/ создание объекта, хранящего изображение 
ГВ1$тар = пем Сгарр1сз: :ТВ1Етар; 
Ебораре = ВКесфапсд; 
ВМР = пем СгарВ1с$: : ТВ1емар; 
ЕСо1ог = С1В1асКк; 
РИЗАаеь = ЕНезаье = 50; 
// задание свойств панели 
Незаье = 50 * заг* (2) + 2; 
ИзАаЕВ = Незаье; 
ЕАпа1е = 0; 
Веуе1Оцеет = БуМопе; 
Рагепе = Омпег; 
Н1пЕ = "Можете переместить объект, " 
"скопировать его или вырезать"; 
РорирМепи = Е1аРагатз->РориарМепу1; 
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// заполнение окон диалога задания параметров Е1дРагат5х 


Е1аРагап$->СотроВох1->Т+етТпаех = 5Зраре; 
Е1чРагатз->ЕА1+1->Техе = ЕРИЗафь; 
Е1дРагатз->Е41+2->Техе = ЕНе1дье; 


Е1дРагатз->ЕЧ1+3->ТехЕ = Апд1е; 
Е1аРагат$->Каа1о0оСгопр1->Т+етТпаех = 0; 
Р1аРагапт$->Со]1огВох1->5е1есееа = 


с1В1аск; 


// прорисовка изображения на канве объекта 


1Е(! Тм) гебоагп; 

ВМР->И1Ааен = Изаен; 

ВМР->Не1апе = Не1аве; 
ВМР->Сапуаз->Реп->Со1ог = ЕСо1ог; 
ВМР->Сапуаз->Вгозв->Со]1ог = Се; 


ВМР->Сапуаз->Р111Вес+ (С11еп Вес); 


// прямоугольный регион по размерам панели 


НАСМ Вед1оп = СгеавеВесЕеВоап (0, 0, Мтаеь, 


ЗеЕИ1паомВоп (Напа1е, Вед1оп, &гае); 


НезаЪ*); 


// поворот осей координат на угол ЕАпа1е 


ЯЧочЬ1е з = з14п (ЕАпд1е); 

4озЬ1е с = соз (ЕАпа1е); 

12% х0 = МЗафь / 2: 

10% у0 = Незаье / 2; 

1п%е ах = (Маеь - ЕМЗаеь) / 2-1; 
176 Ау = (НезЗье - ЕНездаь*) / 2-1; 
ХРОВМ хЕогт; 

хЕогм.еМ11 = хРога.ем22 = с; 
хЕогт.емМ12 = 3; 

хЕогм.емМ21 = -3; 


= х0 - х0О * хЕогм.ем11 - у0 * 
хЕога.еру = у0 - хО * хЕога.ем12 - у0 * 
Зе СгарН1сзМоае (ВМР->Сапуаз->Напа1е, СМ 


хЕогтм.еМ21; 
хЕогта.еМмМ22; 
АПБУАМСЕО); 


Зе+Мог1АТгапзЕ ога (ВМР->Сапуаз->Нап41е, &хЕогт); 


//задание коодинат прямоугольного региона с учетом угла ЕАпд]1е 


ТРо1пЕ ргед1оп [4]; 


ргедлоп [0] = 
Ро1п* (х0 + (ЕИ1аь +2) / 2 *с- 
У0 + (ЕМ1а+2) /2 *3з 
ргед1оп [1] = 
Розпе (х0 - (Ра +2) / 2 *с- 
У0 - (Ра +2) /2*$5 
ргедлоп[2] = 
Ро1п+ (х0 - (ЕМаеь+2) / 2 *с 
У0 - (Р\1а+2) / 2 *з 
ргедлоп [3] = 
Ро1пе (х0 + (ЕМ:а&р+2) / 2 *с 
У + (21а +2) / 2 *з 
зм1Еср (ЕР5варе) 


{ 


сазе Весфапсд:ВМР->Сапуаз->Весфапа1е (Вес® (4х+1, ау+1, 
Ах + РИЗАаерв-1, Ау + ЕНе1аь*-1)); 
Вед1оп 


Ьгеак; 
ВМР->Сапуаз->Е] 11рзе (Вес® (4х+1, а4у+1, 


сазе Е]111рз: 


(ЕНезаье+2) 


+ (ЕНезаье+2) 


(ГНезар*+2) 


+ (ЕНезаье+2) 


+ (ЕНезаь++2) 


(ЕНе19В*+2) 


(ЕНетаь*+2) 
(ЕНезаь*+2) 


= СгеафеРо1удопВап (ргед1оп, 4, 


16 (ЕАпа1е == 0) 


// эллиптический регион 


АГТЕВМАТЕ); 


``. —.`-. —.`-. `` `-<. 


№ № 


Ах+ЕИз1аев-1, ау+ЕНе1аь*-1)); 


Ведлоп = СгеавеЕ111рЕ1сВап (ах, ау, 
ах + РЕМ1аеь+2, ау + ЕНе13ь++2); 
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// прямоугольный регион 
е]1зе Ведлоп = СгеафеРо1удопВоап (ргедлоп, 4, 
АГТЕВМАТЕ); 
БгеаКкК; 
сазе Тг1лапа: { 
ТРозпе ро1пе$ [3]; 
ро1пе$ [0] = Ролп®(х0, ау + 2); | 
ро1пе3з[1] = Ро1зпе (ах + РЕИЗАаеь, Ау + ЕНелдь®); 
ро1п*$[2] = Ро1п® (ах + 2, ау + ЕНе13Ъ+); 
ВМР->Сапуа$->Ро1удоп (ро1пе$, 2); 
// треугольный регион 
ргед1оп[2] = Розпе(х0 + (ЕНе19ь*+2) / 2 * 3, 
у0 - (ЕНе13ь*+2) / 2 * с); 
Ведлоп = СгеафеРо1удопВоап (ргед1оп, 3, 
АГТЕВМАТЕ); 
} 
ргеаКк; 
сазе Г1а: ВМР->Сапуаз->5&геесВОгам (ТВес® (ах, ау, ах + 
ЕИЗАаеь, ау + ЕНеЛзоаье), ЕВ1етар); 
Вед1оп = СгеавеРо1удопВап (ргед1оп, 4, 
АТТЕВМАТЕ); 
.} 
// восстановление координат 
хЕогм.еМ11 = хЕогт.ем22 = 1; 
хЕогм.еМ12 = хЕогт.ем21 = хЕогт.ерх = хога.еру = 0; 
ЗеЕМог]1АТгапзЕоги (ВМР->Сапуаз->Напа1е, &хЕогтм); 
1Е (Егаатеп®) 
{ 
// рамка фрагмента 
ВМР->Сапуа$->СоруМо4ае = смбгсТпуегЕ; 
ВМР->Сапуаз->О0гамГосазВес® (Вес® (ах, Ау, ах + Е\МЗае, 
Чу + ЕНе1ав*)); 
ВМР->Сапуаз->СоруМоае = смзгсСору; 
} 
// перенос изображения на ЕСапуа$ 
ЕСапуаз->Огам (0, 0, ВМР); 
// установка региона 
ЗеЕ\1паомКап (НапЯ1е, Вед1оп, гие); 
} 
Инне н----------------------=----- 


у01А _ Еаз&са11 ТЕ1даге: : Ор1С11сК (\%о1а) 


{ 


// занесение начальных значений параметров объекта 
// в окно диалога 

Р1аРагам$->СотроВох1->Т$етшТп4аех = 5раре; 
Е1чРагатз->ЕА1+1->Техе= ЕМЗаек; 
Е1дРагатз->ЕЧ1{2->Тех® = ЕНе1здь*; 
Е1дРагатз->Еа1е3->ТехЕ = Апа]1е; 
Е1аРагат$->КаЯ1оСбгопр1->Т$етТпаех = 0; 
Е1аРагапт$->Со1охВох1->5е1есееа = Со1ог; 

// вызов диалога задания параметров объекта 
Е1аРагап$->5ПВом (); 


\у01А __Еаз®са11 ТЕ1даге; : Зее 512е (116 Меми1аен, 1пЕ МемНелаве) 
{ о. 
// задание размеров объекта 

ЕИЗАаеь = Мемизаеь; 

ЕНе1запе = МемНе1аье; 

ИМЗАаеЬ = загсе (РИЗАаеь * ЕИЗаеь + ЕНездаье * ЕНезоаь®) + 2; 
Незаве = изаен; 

Огам (); 
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Уу01Аа __Еа5&са11 ТЕ1диге: : 5е 5Баре (Т5Вар 5Варе) 
{ 

// изменение изображения объекта 

1Е(! Тм) гебогп; 

Ебваре = 5,аре; 

1Е (ЗВБаре == Е193) 

ЗеЕ51хе (РИЗаЕрь, ЕНелдаЬе®); 

Ргам (); 


} 


уо1А ТЕ1диге: : Ел аСгеаке (ТИ1пСопЕго1 *бепаег, ТСапуа$ *Сапуаз, 
ТВесЕе $оогсе, Боо1 Саф) 

{ 
// создание нового объекта из фрагмента 5оигсе канвы Сапуа$ 
// СаЕ - надо ли удалять фрагмент с канвы 
Ти = пем ТЕтаоге (бепаег); 
Рагеп&Сапуаз = Сапуаз; 
Ти->Егадиеп® = ф$гае; 
Ти->Ебраре = Е1ч; 
Тм->ЕМТАев = Зойхгсе.Изаев (); 
Тм->ЕНезаье = боигсе.Не1аВ*(); 
Тт->И1АаЕев = загсе (Та->ЕИЗАаеь * Ти->РИЗаЕр + 

Тт->ЕНезаье * Тм->ЕНе1ав®) + 2; 
Тт->НезаВе = Га->Итаец; , 
Ти->Геё+ = $оигсе.ТеЕЕ - (Ти->ИзаеЕв - Тт->ЕИЗаеь) / 2; 
Тт->Тор = боигсе.Тор - (Ти->Незаье - Тт->ЕНезаь*) / 2; 
Ти->ЕВ1 Смар->Незаье = Тт->ЕНе1аь*; 
Тм->ЕВ1 мар->И1АеВ = Га->РИЗЛАеЬ; 
Тм->ЕВ1 мар->Сапуаз->СоруКес® (Тм->ЕВ1тар->Сапуаз->С11рВес®, 
Сапуаз, Зоцгсе); 

1Е (Са®е) Сапуаз->Е111Вес® (боигсе); 
Ти->Огам(); } 


\01А ТЕ1доге: :ТоСапуа$ (роо]1 Саф) 
{ 
// копирование или вырезание изображения на канву 
1Е (Тм) 
{ 
1706 ах = (Та->изаеь - та->ЕИЗаеь) / 2-1; 
10% ау = (Па->Незаье - Тп->ЕНе1аь*) / 2 - 
1Е (1п->Егадмеп®) 
{ 
// стирание рамки фрагмента 
Тп->ВМР->Сапуаз->СоруМоае = стбгс1ТпуегЕ®; 
Ти->ВМР->Сапуаз->ОгачРосазКес* (Вес (ах, ау, ах + Тт->Е\ЗАеь, 
Ау + Ти->ЕНе1аь+)); 
Ти->ВМР->Сапуаз->СоруМо4ае = сп$гсСору; 
Тп->ЕСапуаз->0гам (0, 0, Тм->ВМР); 
} 
// копирование изображения 
Рагеп*Сапуаз->СоруВес® (Тт->ВоппазВесЕ, Тм->ЕСапуаз, 
Тм->С131епЕВес®); 


1; 


1Е(Са®) Тм->Егее(); // режим вырезания 
е]1зе 1Е (Тм->Егаацщеп®) 
{ // режим копирования 


// рисование рамки фрагмента 

Ти->ВМР->Сапуа$->СоруМоае = смбгсТпуегЕ; 

Тм->ВМР->Сапуаз->ргамГосазВес* (Кес® (ах, ау, ах + Тт->ЕИЗаеь, 
Ау + Тм->ЕНе1а5+)); 

Ти->ВМР->Сапуаз->СоруМоае = стёгсСору; 

Тт->ЕСапуаз->0гам (0, 0, Тм->ВМР); 
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у01А _ Еа5%са11 ТЕ1даге: : бе ёАпд1е (4осЬ1е МемАпда1е) 


{ 
ЕАпа1е = МемАпа1е * МРТ / 180.; 
Огам(); 


дочЬ1е __Еаз&са11 ТЕ1даге: : СеёАпд1е (уо19) 
{ 


} 


Рассмотрим изменения, внесенные в код. В конструкторе значение разме- 
ра по умолчанию 50 задается теперь не параметрам панели, а полям ЕЖЕ 
и ЕНехВ, характеризующим размер изображения. Панель задается квадрат- 
ной со стороной, равной диагонали изображения плюс 2 пиксела. Эти два пик- 
села — запас, необходимый для того, чтобы при поворотах крайние точки изо- 
бражения отступали от границы региона. Иначе из-за возможных искажений 
наклонных сторон региона эти точки могут потеряться. В конструкторе зада- 
ется также нулевое по умолчанию значение угла поворота. 

При заполнении окон формы диалога Е1еРагатз в окна ЕЯИ1 и ЕЯ пе- 
ресылаются размеры изображения Е\1 и ЕНех В, а в окно Е 3 — свой- 
ство Ап е. Поскольку передается свойство, в этот момент сработает функция 
чтения де Ап ]е, которая переведет значение поля ЕАп]е в градусы. 

Серьезные изменения внесены в код функции Огам, обеспечивающей изо- 
бражение графического объекта. После ряда операторов, которые были в этой 
функции ранее, в объекте устанавливается регион, охватывающий всю его по- 
верхность. Затем следует ряд операторов, обеспечивающих поворот системы 
координат на заданный угол ЕАпе. Предварительно вычисляются координа- 
ты центра х0 и у0, относительно которых будет производиться вращение. Пре- 
образование координат записывается в структуру хогт. Затем функциями 
Зе Сгар1с;Моде и Зе \ог1ЧТгап$огт осуществляется заданное преобразо- 
вание координатных осей канвы объекта ВМР, на которой будет рисоваться 
изображение. Пояснение всех этих операторов вы найдете в разд. 5.5. Так что 
не будем сейчас на них останавливаться. 

После преобразования координат следует объявление переменной КВеё1оп, 
в которой будет далее формироваться регион. Затем объявляется массив 
ргег1оп точек ТРот\ф, в который заносятся угловые точки будущего региона. 
В нулевой элемент массива заносятся координаты правой нижней точки, 
в первый элемент — левой нижней точки, во второй — левой верхней точки, 
и в третий — правой нижней точки. Но поскольку изображение будет поверну- 
то на угол ЕАпе, то координаты этих точек заносятся с учетом этого поворо- 
та. Например, при ЕАпе = 0 (т.е. при $ = Оие = 1) координаты точки в нуле- 
вом элементе, как вы можете убедиться, равны (хО + Е\Па / 2 + 1, у0 + 
ЕНеоь{ / 2 + 1). Это соответствует правой нижней точке области изображе- 
ния, сдвинутой на один пиксел вниз и вправо, чтобы гарантировать отображе- 
ние точки при искажениях границ региона. А при ЕАпШе, отличном от 0, это 
координаты той же точки, но с учетом поворота координатных осей. 

В структуре змЁЦвеВ в зависимости от типа объекта рисуется соответствую- 
щее изображение на канве ВМР-—>Сапуа$ и формируется регион. Прямоуголь- 
ник рисуется функцией Вефап ]е, а размер прямоугольника задается с запа- 
сом в 1 пиксел. Регион создается из массива ргеглоп, сформированного ранее. 


гееогп ЕАпд]е * 180. / МРТ; 
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Аналогичным образом формируется регион для изображения при ЕЗВаре = 
Е1. Для треугольника требуется преобразование массива ргеб1оп, так как 
первые две точки массива годятся и для треугольника, а третья точка должна 
быть расположена в середине верхней грани области изображения. Эта точка 
с учетом поворота координатных осей заносится в ргег1оп[2], после чего по 
первым трем точкам массива ргез1оп формируется регион. 

Для эллипса проблема формирования региона существенно усложняется. 
Нет функции, позволяющей создать эллиптический регион с осями, наклонен- 
ными под произвольным углом. Можно, конечно, было бы сформировать мас- 
сив точек такого региона и по ним построить регион функцией СгезжеРо]у- 
гопВеп. Но поскольку вряд ли подобный регион часто может встречаться на 
практике, подобное усложнение не хотелось вводить. Поэтому при нулевом 
угле поворота регион формируется эллиптический, а при иных углах задается 
регион, соответствующий описанному прямоугольнику. Это ограничивает 
применение наклонных эллипсов. Они будут нормально изображаться, но при 
наложении подобных эллипсов на другие изображения часть этих изображе- 
ний, попадающая под описанный прямоугольник, будет стираться. 

Так как изображения всех фигур, рисуемых в структуре ме, заносятся 
на канву объекта ВМР, координаты которой трансформированы, все эти изо- 
бражения оказываются повернутыми на заданный угол. Затем нормальное по- 
ложение координатных осей ВМР восстанавливается. Если изображение явля- 
ется фрагментом рисунка, то вокруг этого фрагмента в объекте ВМР рисуется 
рамка. После этого изображение из объекта ВМР переносится методом Огам 
на канву ЕСапуа$. При этом на канве получается повернутое изображение. 
В заключение для графического объекта задается сформированный ранее ре- 
Ггион. 

Функция ЫСПеК отличается от рассмотренной в разд. 5.3.1.1 только тем, 
что в окна ЕЯ и ЕЯЦ2 формы диалога ЕеРагатз пересылаются размеры 
изображения Е\1 В и ЕНее 1, а в окно ЕЯ9ЫЗ — свойство Апе. 

Функция $е{$12е задает новые размеры изображения. Переданные в нее 
размеры задаются значениям полей Е\14® и ЕНехВф, а размеры панели 
УПЧ и Не пересчитываются в соответствии с приведенными ранее соот- 
ношениями. 

Функция Зе Варе отличается от рассмотренной в разд. 5.3.1.1 тем, что 
в случае ЭВаре = Ех надо осуществить изменение размеров изображения 
и объекта, что делается вызовом описанной выше функции Зе $ 1те. 

Существенные изменения внесены в функцию ЕиСгез{е, создающую но- 
вый объект из фрагмента рисунка. Поля ЕМУ и ЕНе15 $ задаются. в соответ- 
ствии с размерами фрагмента. Размеры графического объекта увеличиваются, 
чтобы поместить фрагмент, если пользователь захочет его вращать. Левый 
верхний угол графического объекта сдвигается так, чтобы отображаемый фраг- 
мент отобразился на том же месте, где он размещался на исходном рисунке. 
Размеры объекта ЕВ йтар устанавливаются равными размерам фрагмента, и на 
канву этого объекта копируется методом СоруВес{ заданный фрагмент. Осталь- 
ные операторы функции не отличаются от предыдущего варианта класса. 

Ряд изменений введен в функцию ТоСапуа$, осуществляющую перенос 
изображения из графического объекта на внешнюю канву. Иначе стирается 
и рисуется рамка вокруг фрагмента, так как в данном случае она рисуется 
именно вокруг фрагмента, а не вокруг всего изображения. Так что приходится 
определять область фрагмента, расположенную посередине канвы объекта 
ВМР и имеющую ширину Е\МТа и высоту ЕНе!хВ%. Добавляется также вызов 
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функции Ога\м для занесения изменения рамки в графический объект. Это 
уже обсуждалось в разд. 5.3.1.2. Там же обсуждался способ копирования изо- 
бражения на внешнюю канву из канвы ЕСапуа$. 

Функция Зе Ап ]е пересчитывает угол, заданный в градусах, в радианы 
и заносит полученное значение в элемент ЕАпе. Функция бе Ап е осущест- 
вляет обратное преобразование, возвращая угол в градусах, соответствующий 
значению ЕАп# е. 


В заключение следует сказать, что рассмотренные варианты редакторов 
с графическими объектами на основе панелей носят, конечно, демонстрацион- 
ный характер. В них не введен ряд функций, упрощающих работу пользовате- 
ля с объектами, и не использованы приемы, позволяющие оперировать с изо- 
бражениями более изящно. Но все дополнительные ухищрения сделали бы 
разработанные примеры (и так довольно громоздкие) менее наглядными, так 
как суть выполняемых операций утонула бы в мелочах. С другой стороны, 
в приведенных примерах проводилась работа с такими сложными объектами, 
как треугольники и, особенно, эллипсы. В реальных приложенияк такие объ- 
екты вряд ли встречаются. А если бы дело ограничилось прямоугольниками 
и окружностями, то все намного упростилось бы. 

Думаю, что, разобравшись в приведенных примерах, вы сможете создать 
собственные графические объекты, добавив в описание их классов нужные 
свойства: надписи, какие-то числовые параметры, характеризующие объект, 
и т.д. 


5.3.2 Объекты на основе форм 


В разд. 5.3.1 рассмотрено создание графических объектов на основе пане- 
лей и связанной с ними канвы. В данном разделе рассмотрим решение той же 
задачи, но объекты будем создавать на основе форм. Соответствующий проект 
СОГогт1 имеется на приложенном к книге диске в каталоге СтОБ;. Он повто- 
ряет проект СОРапе] рассмотренный в разд. 5.3.1.1. Модуль главной формы 
ОЕМатЕогт1, за исключением имени, в точности повторяют модуль 
ОЕГМат1, использованный в проекте СОРапе!1. Модуль диалога настройки 
параметров ИРРагатз4 тоже практически полностью повторяет модуль 
ОЕРагатз1, использованный в проекте СОРапеШ. Только в данном случае 
в модуле изменено имя класса графического объекта, на который имеются 
ссылки в коде, и отсутствует компонент РорирМепи и все связанные с ним об- 
работчики событий, поскольку выпадающее меню реализуется в модуле гра- 
фического объекта. Таким образом, внешний вид данного приложения во вре- 
мя выполнения не отличается от показанного на рис. 5.9. 

Однако модуль описания класса графического объекта, имеющий в дан- 
ном проекте имя ЕРогт1, не похож на тот, который был рассмотрен 
в разд. 5.3.1.1. Модуль реализован в виде обычной формы. На нее помещен 
компонент РорирМепи, тождественный тому, который ранее помещался на 
форме диалога настройки параметров. В свойстве формы Ни\ задан текст "Мо- 
жете переместить объект, скопировать его или вырезать", который раньше за- 
давался программно в конструкторе объекта. Больше на форме ничего нет. Но 
при желании вы могли бы поместить на ней что угодно: метки, отображающие 
какие-то параметры объекта, списки, компонент Ппарфе, который позволил бы 
рисовать на поверхности объекта. Так что форма предоставляет вам возможно- 
сти без труда реализовать сколь угодно сложный вид и поведение графическо- 
го объекта. 
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Форма графического объекта исключается командой Ргоес! | ОрнНопз из чис- 
ла автоматически создаваемых, поскольку объекты будут создаваться про- 
граммно. 

Ниже приведен код заголовочного модуля формы, содержащий описание 
класса. 


#10с1оАе "ОЕРагат$4.1" 


// тип изображения в объекте: `’Весёапу - прямоугольная рамка, 


// Е111рз - эллипс, окружность 
// Тг1апд - треугольник 
// Е19 - рисунок 


епом Тбрар {Кесбапа, Е1]11рз, Тг1лапа, Е1а}; 


с1азз ТЕ1даге : риб11с ТЕогм 
{ 

__ручЬ11зпвеа: 

ТРороарМепа *РорирМёпи1 ; 

ТМепоТеем *№2; 

ТМепаТеем *М№1; 

ТМепоТеем *№3; 

ТМепоТеем *№4; 

\01А __Еаз®са11 ЕогпСгеаее (ТОр)]ес®& *5епаег); 
\01А __Еаз6са11 Гогпрезегоу (ТОБ]ес® *$епаег); 
У01А _ Еаз®са11 ЕогпМочзеромп (ТОБ)ес® *5епаег,. 

ТМочзеВое оп ВаеФоп, 
Торт ЕЕ бабе $В1ЕЕ, 10 Х, 110% У); 
%у01А __Еазса11 Когтор1С11сКк(ТОР)]есе *5епаег); 
\01А __Еаз®са11 ГогшРа1п* (ТОБ]есе *5епаег); 
\01А __Еаз®са11 ЕГогпКеуромп (ТОр]ес® *5еп4ег, МОВО &Кеу, 
ТортЕЕфафке $01Е%); 

// Раздел меню "На задний план" 

\01А __Еаз®са11 №С11сКк (ТОБ)]есе *$епаег); 

// Раздел меню "Удалить" 

Уу01А _ Еаз®са11 М№2С11сКк (ТОр)ес® *5епаег); 

// Раздел меню "Копировать в рисунок" 

У01А __Еаз®са11 М№3С11сК(ТОБ)есе *5епаег); 

// Раздел меню "Вырезать в рисунок" 

\01А _ Еаз®са11 №С11сКк{ТОр)есе *5епаег); 


рг1уа*е: 
Тбрар Ебраре; // тип изображения в объекте 
ТСо1ох ЕСо1ог; // цвет пера 
Сгарр1сз: :ТВ16тар *ЕВ1Етар; // картинка в объекте 
Юоо1 Егкаадтеп*; // создан ли объект из фрагмента 
СгарВ1с$: :ТВ1Е тар *ВМР; // полная картинка объекта 


// указатель на текущий активный объект 

зЕае1с ТЕзааге * Тм; 

// канва контейнера, в котором рисуются изображения объектов 

з6аЕ1с ТСапуаз *Рагеп®Сапуаз; 

// установка ЕВ1Етар - картинки в объекте 

\01Аа _ Еаз®кса11 5ееВ1® мар (бгарН1сз: :ТВ1тар *В1емтар); 

// установка ЕСо]ог - цвета пера 

\01А _ Еазеса11 5ееСо1ог (ТСо1ог Со1ог); 

// установка Е5бВаре - типа изображения в объекте 

\у01А __ЁЕаз6са11 5ее5Паре (Т5Вар 5варе); 

// установка размеров 

\01Аа _ Еаз®са11 5еЕ$12е (116 МемИ1аАаей, 1пе МемНе1аве); 
руч11с: 

__Еаз&са11 ТЕ1даге (ТСотропеп®* Омпег); 

// прорисовка изображения на форме 

у01А __Еаз®са11 ПОкам(); 
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// свойство В1Етар - картинка в объекте 
__ргорег®у СгарП1с$::ТВ1&мар *В1®тар = 

{ геаа=ЕВ1Етар, мг1%е=бееВ1Етар, ЧеЁац1+=Егае}; 
// свойство Со]ог - цвет пера 
__ргорег®у ТСо1ог Со1ог = 

{геаа=ЕСо1ог, мг1®ке=бееСо1ог, АеЁЕац1е=егае}; 
// свойство 5$Варе - тип изображения в объекте 
__ргорегеу Т5вар $Варе = 

{геаа=Ебраре, мг16е=беебваре, аеЁал1%=%гиае}; 
// содание нового объекта с диалоговым заданием 
// размера, цвета, изображения 
з$аЕ1с \уо1а Е1лаСгеате (ТМ1пСопЕгоф *5епаег, ТСапуа$ *Сапхаз); 
// содание нового объекта из фрагмента рисунка 
зфаЕ1с уо1а ЕлаСгеаее (ТМ1пСопего]1 *бепаег, ТСапуа$ *Сапуаз, 

| ТВесЕ бочгсе,Боо]1.Са®); 

// копирование или вырезание изображения объекта в рисунок 
5са®е1с \о1А ТоСапуаз (роо1 Саф); 
// дружественный класс 
Ег1лепа с1аз5 ТЕ1аРагатз; 


}; 


// инициализация статических переменных 
ТЕзаиге * ТЕ1ааге;: :Та = М; 
ТСапуаз * ТЕ1аиге: :РагепЕСапуаз = МОШ; 


Если вы сравните это описание класса формы с классом графического объек- 
та, приведенным в разд. 5.3.1.1, то увидите, что они довольно похожи. Но данное 
описание проще, поскольку использует стандартные обработчики событий, легко 
создаваемые в процессе проектирования формы. Причем это могут быть достаточ- 
но экзотические события, что позволяет при желании существенно обогатить 
функциональные возможности графического объекта. А в классе, рассмотренном 
в разд. 5.3.1.1, приходилось вручную перегружать обработчики базового класса, 
что не всегда просто. К, тому же, на форме имеется канва, так что не приходится 
вводить ее специально и привязывать к графическому объекту. 

Ниже приведен код файла реализации данной формы. 


ТЕзаиге *Е1доге; 


\у01А _ Газ®са11 ТЕ1даге;: : ГогиСгеа*е (ТОБ)]есе *бепаег) 
{ 

Ебпаре = Вескапд; 

ЕВ1Стар = пем СгарП1сз$::ТВаЕмар (); 

ВМР = пем Сгарп1с3: :ТВ1Е тар; 

Незапе = 50; 

Итаен = 50; 

ТеЕЕ = 0; 

Тор = 0; 

Сапуа$->Вга$в->Со1ог = Сс1\1е; 

РСо1ог = Сс1В1аск; 

Веуе1Оцеег = Бу№опе; 

Тм = %Р1$; 

Г1аРагам$->СопроВох1->Т+ешТпаех = &51$->5,аре; 
ЕГ1аРагат$->Еа1*1->Техе= &51$->М1аеВ; 
Е1аРагат$->Еа1*2->Тех® = &р1$->Не1аве; 
Е1аРагат$->КаА1оСгопр1->ТфешГпаех = 0; 


ЕВ1емар->Егее (); 
ВМР->Егее (); 
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у01А __Еаз®са11 ТЕ1диге: :Огам () 
{ | 
// прорисовка изображения на форме 
ВМР->И1Аен = Мзаев; 
ВМР->Не1аНе = Незайе; 
ВМР->Сапуаз->Вгазп->Со1ог = с1М1%е; 
ВМР->Сапуаз->Е111Вес® (С11епеВесе); 
ВМР->Сапуаз->Реп->Со1охг = ЕСо]1ог; 
зм16сВ (Е5варе) 
{ 
сазе Весфапа: ВМР->Сапуаз->Весфапа1е (0, 0, 
С11епИ1аАей, С11епеНезав®); 
Ьгеак; 
сазе Е111рз: ВМР->Сапуа$->Е]111рзе (С11епВес®);; 
Бгеак; 
сазе Тг1апа: { 
ТРо1пЕ ро1п*$[3]; 


ро1п&$[0] = Ро1п® (Илаев / 2, 0); 
ро1пе$[1] = Ро1пЕ (М1аЕр, Не1зав®-1); 
ро1п65$[2] = Ро1пф (0,Не1ар*-1); 
ВМР->Сапуаз->Ро1удоп (ро1пф5$, 2); 
} 
Ьгеак; 
сазе ЁЕ1д: ВМР->Сапуа$->56 гессИОгам (С11еп Весе, ЕВ1®мар); 


} 

1Е (РГгаадтеп®) 

{ 

ВМР->Сапуаз->СоруМо4е = см5гс1Тпуеге; 
ВМР->Сапуаз->ОгамГосизВес® (Ти->С11епКес®); 
ВМР->Сапуаз->СоруМо4е = ст5$гсСору; 

} 

Сапуаз->ОРгам (0, 0, ВМР); 


\01А __Еаз®са11 ТЕ1диге: : 5е В1® тар (бгарп1с5::ТВ1®тар *В1®мар) 
{ 

// установка ЕВ1Етар - картинки в объекте 

ЕВ1тар->А$51ап (В1®мар); 

Огам (); 


\01А __Еаз®са11 ТЕ1диаге: : 5е Со1ог (ТСо1ог Со1ок) 
{ 

// установка ЕСо]ог - цвета пера 

ЕСо1ог = Со1ог; 

Ргам (); 


уо1а _ Еаз®са11 ТЕ1доге: : бес брваре (Т5Вар 5варе) 


// установка Е$Варе - типа изображения в объекте 
Ебпаре = 5Ппаре; 
Огам (); 


\01А _ Еаз®са11 ТЕ1диге: : 5её512е (116 МемИ1аеь, 1пе МемНе19ье) 
{ 

// задание размеров объекта 

ИтАаер = МемИтафеь; 

НезапЕ = МемНе1аВе; 

Огам (); | | 

} 
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Уу01А _ Еазфса11 ТЕ1даге: : КогиМочзеромпт (ТОБ)есе *5епаег, 
ТМопзеВа оп ВаЕбоп, Т5Б1ЕЕббаЕе $5И1ЕЕе, 1пЕ Х, 1106 У) 


// начало буксировки 

//занесение начальных значений параметров объекта 
// в окно диалога 

Ве1еазеСареаге (); 

&11$->РегЕогм (ИМ 5УЗ$СОММАМР, 0хЕ012, 0); 

Тм = $©51$; 

Е1аРагат$->СопбоВох1->Т6емТпаех = %11$->5браре; 
Е1аРагатз->Еа1*1->Тех®= %01$->М1аеЦ; 
Е1аРагат$->Еа1$2->Техе = Е01$->Незаве; 
Е1аРагам$->ВаЯ1о0оСгоир1->Тфет1паех = 0; 
Е1аРагат$->Со1огВох1->5е1есееа = &101$->Со1ог; 
ЗеЕЕРосиз$ (); 


// вызов диалога задания параметров объекта 
Е1аРагапз->5Пом (); 


// перерисовка формы 
Сапуаз->Огам (0, 0, ВМР); 


у01А __ГазЕса11 ТЕ1даге: : ГогиКеуро\мт (ТОБ)есе *5епаекг, 
| МОВР &Кеу, Т$В1ЕЕ$фафе $н1Е%) 
{ 
// удаление объекта при нажатии ЕпЕег 
1Е (Кеу == УК ОЕЪЕТЕ) 
№2С11сК (5епаег); 


%01А ТЕ1диге: : Е1аСгеафе (ТМ1пСопЕго1 *бепаег, ТСапуаз *Сапуаз) 
{ 

// создание нового объекта с диалоговым заданием 

// размера, цвета, изображения 
Арр11са®1оп->Сгеа®еКогим (__с1а5514 (ТЕ1диаге), &Е1аиге); 
Е1ааге->РагепЕ = 5епаег; 

Е1аиге->РагепЕСапуаз = Сапуаз; 

Е1аиге->5ром (); 

Е1ааге->Та = Е1доге; 

Ти->ЕгадтепЕ = ЕГа15$е; 

Ти->ркгам (); 

Е1аРагап$->5Пом (); 


уо1Аа ТЕ1ааге: : Е1аСгеафе (ТМ1пСопего1 *беп4ег, ТСапуаз *Сапуаз, ТВес® 

соигсе, Роо1 Саф) 

{ | 

// создание нового объекта из фрагмента 5оигсе канвы Сапуа$ 

// СаЕ - надо ли удалять фрагмент с канвы 

Арр11са&1оп->Сгеа®еГогм (__с1а$5$14 (ТЕ1даге), &Е1диге); 

Е1доге->Рагепфе = 5епаег; 

Е1даге->Рагеп®Сапуаз = Сапуаз; 

Е1даге->ВоипазВесе = боогксе; 

” СгарЬ1сз$::ТВ1Емар *В16тарЕтр = пем СгарЮ1сз: :ТВ1етар (); 
В1Етар®пр->НезапЕ = Е1аиге->Не1аре; . 
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В1Етарепр->М1аЕр = Е1даге->Илаек; 
В1пар®пр->Сапуаз->СоруВес* (Ти->С11епЕВКесе, Сапуа$, Зоцгсе); 
Е1аиге->ЕВ16тар- >А5519п (В1Емар®пр); 

В1Емар®пр->Егее (); 

1Е (Саф) РагепЕСапуаз->Е1118Вес+ (зоигсе); 

Е1даге->Ти = Е1даге; 

ТЕ1аиге: :1и->5раре = Е1а; 

Ти->Егадчтеп® = фгае; 

Е1аиге->бПВом (); 


У01А ТЕ1даге: :ТоСапуаз$ (Ъоо1 Саф) 
{ 
// копирование или вырезание изображения на канву 
1Е (Тм) 
{ 
1Е (Ти->Егадсиепьф) 
{ 
// стирание рамки 
Ти->ВМР->Сапуа$->СоруМоае = стбгсТпуег%; 
Ти->ВМР->Сапуаз->ОгамиГосоазВесЕ (Ти->С11еп Е Вес®); 
Ти->ВМР->Сапуа$->СоруМоае = стбгсСору; 
} 
РагепЕСапуаз$->СоруВес® (Тт->Воцпаз$Весе, | 
Ти->ВМР->Сапуаз, Ти->ВМР->Сапуаз->С11рВес®); 
1Е (Са) Ти->С1о5е(); 
е1зе 1Е (Тм->Егадиеп®) 
{ 
Ти->ВМР->Сапуаз->СоруМоае = стбгсТпуеге; 
Ти->ВМР->Сапуаз->ПгамГоса$ВесЕ (Ти->С11епЕКВес®); 
Ти->ВМР->Сапуа$->СоруМоае = ст5гсСору; 


\01А __Еазеса11 ТЕ1ааке: :№1С11сК (ТОр]ес®е *5епаег) 


// Раздел меню "На задний план" 
бепаТоВаск (); 


%у01А _ Еаз®са11 ТЕ1даге: :№2С11сКк (ТОр)]есе *5епаег) 
{ 


// Раздел меню "Удалить" 
Егее (); 
Тм = МО; 


\01А _ Еазеса11 ТЕ1даге: :;№3С11ск (ТОр)ес® *бепаег) 


// Раздел меню "Копировать в рисунок" 
ТоСапуаз$ (Ра15зе); 


\01А _ Еаз®са11 ТЕ1даге: :М№4С11сКк (ТОБ)]есе *5епаег) 


// Раздел.меню "Вырезать в рисунок" 
ТоСапуаз$ (&гае); 


} 


За исключением некоторых деталей, коды идентичных по назначению 
функций данного приложения и приложения, рассмотренного в разд. 5.3.1.1, 
совпадают. Так что достаточно указать соотношение между соответствующи- 


348 Глава 5. Окна и графика 


ми функциями. Функция ЕогтСгезжфе (обработчик события ОпСгезже формы) 
аналогична конструктору ТЕ!хаге в классе разд. 5.3.1.1. Функция РЕогтОез- 
фгоу (обработчик события Оп)е$&гоу формы) аналогична деструктору -ТЕ1ги- 
ге. Функции Огам, Зе В Цтар, Зе Со]ог, Зе Варе, 5е{$12е, Е1еСгеже, То- 
Сапуа$ аналогичны в обоих классах. Функции ЕогтМоцзедомп, ЕогтОЪ]- 
Спек, ЕогтКеу)бомп, ЕогтРашё — обработчики событий формы, также 
имеющие аналоги в прежнем проекте. Ну, а обработчики щелчков на соответ- 
ствующих разделах меню ранее были во вспомогательной форме диалога. Так 
что комментировать в этом коде, пожалуй, нечего. Сравнив данный класс 
с рассмотренным в разд. 5.3.1.1 вы легко найдете немногие незначительные 
отличия, связанные просто с разными формами доступа к свойствам и методам 
графического объекта. 

В силу аналогии между рассмотренными классами, варианты с регионами 
и вращением ‘форм не рассматриваются. Они в целом подобны рассмотренным 
в разд. 5.3.1.2 и 5.3.1.3. 
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5.4.1 Пиктограммы файлов | 

В ряде случаев требуется получить пиктограммы, содержащиеся в том или 
ином исполняемом или библиотечном файле. Для решения этой задачи суще- 
ствует ряд функций. | 

Функция Ехёгаеё АззосафедТсоп возвращает дескриптор пиктограммы 
с указанным номером в указанном файле. Ее объявление в модуле ЭйецАРГ.й: 


З5НЗТОАРТ (НТСОМ) ЕхёгасА$5ос1акеаТсоп (НТМ5ТАМСЕ ПТпзе, 
.РЗТВ 1рТсопРаЕВ, ГРМОВО 1р1Тсоп); 


Параметр №156 является дескриптором приложения, параметр ШГеоп- 
Ра — полное имя файла, из которого желательно получить пиктограмму, 
]рИеоп — переменная, указывающая индекс пиктограммы. В большинстве 
версий У\п4о\з параметр фПеоп не влияет на результат. А поскольку индек- 
сы пиктограмм начинаются с 0, то практически всегда переменной 1рИсоп 
можно присваивать значение 0. 

Функция ищет пиктограмму в указанном файле. Если пиктограмма нахо- 
дится, функция возвращает ее дескриптор. Если в файле нет пиктограммы, но 
с файлом связан другой исполняемый файл, обрабатывающий его как доку- 
мент (например, \Уога для файлов .40с), то функция возвращает пиктограмму 
из этого связанного файла. Если пиктограмма так и не нашлась, возвращает- 
ся 0 (впрочем, не всегда). Если пиктограмма нашлась, ее идентификатор, со- 
гласно документации, сохраняется в фИсоп. Но это делается тоже далеко не 
во всех версиях У\У/т4о\з. 

Таким образом, доступ к пиктограмме функцией Ехгас$Аззосафе Тсоп 
можно оформить следующим образом: 

НТСОМ Тсоп; 

1Е (Орепр1а1о391->Ехесиее ()) 

"Ала вЕЕ1 па 5 = Орепр1а1о91->Е11еМаме;. 

Тпаае1->Сапуаз->ЁЕ111Весь (Ттаде1->С11епеКес®); 

МОВО 1 = 0; 

Тсоп = Ехбгас®АззостафеаТсоп (Напа1е, $.с_з%к(), &1); 
ОХгамТсоп (Тмаде1->Сапуа$->Напа1е, 10, 10, Тсоп); 


} 
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Здесь объявляется переменная Шсоп типа Шсоп, затем вызывается диалог 
открытия файла ОрепП1а10о21, и если пользователь выбрал в нем файл, то де- 
скриптор пиктограммы этого или связанного с ним файла передается в Теоп. 
В заключение пиктограмма рисуется на канве компонента Ппахе1 функцией 
Огачсоп, о которой подробно рассказано в разд. 5.4.3. Предварительно канва 
очищается методом ЕШВес+. 

Получение дескриптора пиктограммы можно оформить и иначе: 


1Е (Орепр1а1о0о91->Ехесиее ()) 
{ 
Тпаче1->Сапуаз->Е111КВес® (Тмаде1->С11еп Вес); 
ТТсоп *Тсоп = пем ТТсоп ; 
МОВО 1 = 0; 
Тсоп->Напа]е = Ехегас*Аззос1аееаТсоп (Напа1е, 
РСВаг (Орепр1а1091->Е11еМаме.с_$%6г()), &1); 
Тпаде1->Сапуаз->Огам (10,10,Тсоп); 
1Е (ЗауеР1сЕагер1а1о31->Ехесоаее ()) 


Тсоп->бауеТоЕ11е (бауеР1сеигер1а1оа1->Е11еМапе); 
Тсоп->Егее (); 


} 


В данном примере дескриптор пиктограммы загружается в дескриптор 
объекта типа ТШсоп — стандартного класса С++ВиПдег. Далее пиктограмма. 
рисуется на канве компонента Ппабе1 ее методом Огаум, и в заключение поль- 
зователю предлагается сохранить пиктограмму в указанном им файле. Подоб- 
ным образом вы можете создать себе библиотеку различных пиктограмм и ис- 
пользовать ее далее в своей работе. 

Если вам надо просто отобразить пиктограмму в компоненте Ппазе1, то 
все это можно сделать еще проще, не вводя промежуточного объекта ТГеоп: 

1Е (Орепр1а1о91->Ехеса*е ()) 


Тмаче1->Р1сбаге->Тсоп->Напа1е = ЕхегасЕТсоп (Напа1е, 
РСраг (Орепр1а1091->Е11еМаме.с_з%г()), 0); 


Еще одна функция, позволяющая извлекать пиктограммы из исполняе- 
мых файлов и библиотек ОШ, — Ехегас_ соп. Она извлекает пиктограммы 
только из исполняемых файлов, ОШ, и файлов пиктограмм .4с0. Но зато она 
позволяет извлечь все пиктограммы, содержащиеся в файле. Функция объяв- 
лена в модуле ЭйеЦАРГ.Й следующим образом: 


ЗН5ТРАРТ (НТСОМ) Ехекас®Тсоп (НТМ5ТАМСЕ РТпзе, 
.РСЗТВ 1рз2ЕхеЕ11]1еМате, ОТМТ пТсопТпаех); 


Параметр В11$ — дескриптор приложения, вызывающего функцию. Па- 
раметр р52ЕхеЕ!еМате — полное имя файла, из которого извлекаются пикто- 
граммы. А параметр Шсопт4дех может в зависимости от ситуации трактовать- 
ся по-разному. Если Шеопа@4ех = -1, то функция возвращает число пикто- 
грамм в данном файле. А если Шеоши4ех — неотрицательная величина, то 
она воспринимается как индекс затребованной пиктограммы, и тогда функция 
возвращает дескриптор этой пиктограммы. Если файл не является исполняе- 
мым, ОШ, и файлом 4со, то возвращается 1. Если в файле нет пиктограмм, воз- 
вращается 0. 

Таким образом, получение пиктограмм функцией Ехёгае_Мсоп можно 
оформить следующим образом: 

НТСОМ Тсоп,пТсоп ; 


1Е (Ореп)01а1о391->Ехесиее ()) 


{ 
Таре11->Сар*1оп="Файл: " + Орепр)1а1о31->Е11еМапе; 
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Тпадче1->Сапуа$->Е111Вес® (Тмаде1->С11епКесф); 
пе 1 = -1; 
пТсоп = ЕхегасЕТсоп (Напа]1е, 
РСВаг (Орепр1а1091->Е11еМаме.с_-$%г()), 1); 


Еог (1=0; 1< (106) пТсоп ;1++) 
{ 


Тсоп = ЕхсгасЕТсоп (Напа]е, 


РСпак (Орепр{а1091->Е11еМаме.с_з%к()), 1); 
РгамТсоп (Тпадче1->Сапуа$->Напа1е, 
10 + 60 *(1 % 10) , 20 + 60*( (1+1) / 10) ‚, Тсоп); 


} 


Если пользователь выбрал файл, то вызывается функция Ехёгае _ соп 
с Шеопа4ех = -—1. В результате возвращается число пиктограмм в файле 
пеоп. Затем все пиктограммы в цикле рисуются на канве компонента Ппасе1. 
Так как пиктограмм может быть много, они рисуются по 10 в ряд. 
Приведенный выше код реализован на приложенном к книге диске в ката- 
логе [сопз в проекте Рас. Результат выполнения этого проекта представлен 
на рис. 5.11. На нем показаны пиктограммы, извлеченные из файла р/таг.аИ, 
который обычно имеется в подкаталоге зуз{ет32 каталога У/Итш4омз. 
Рис. 5.11 > Получение пиктограмм из испояняемын файлов о. 
Получение пиктограмм Файл: В \\АНОО\У 5 \зуцет3 2\ритог. И 
из исполняемых 
файлов приложением 
Рис 


Рассмотренное приложение позволяет только посмотреть пиктограммы. 
Хотелось бы большего: иметь возможность сохранить понравившуюся пикто- 
грамму в файле, чтобы использовать ее в дальнейшем в своих проектах. Это не- 
трудно сделать, если хранить пиктограммы в списке ПпареТ 15$ и отображать их 
не в компоненте пабе, ав ОЮгамСг14. Это позволит пользователю указать нуж- 
ную пиктограмму. Подобное приложение показано на рис. 5.12 и имеется 
на приложенном к книге диске в каталоге [сопз в проекте РёсЕ2. Приложение 
содержит компоненты ОрепП1а1о=, ЗауеР1еваге01а1о7х, ПпахеТ15%, ОгамО, 
ВиЙоп, ГаБе]. При щелчке на кнопке пользователь может указать исполняе- 
мый или библиотечный файл, из которого он хочет получить пиктограммы. На 
рис. 5.12 изображены пиктограммы, извлеченные из файла зйеПНЗ2.аИ, который 
содержит многие десятки весьма полезных изображений. Посмотрев извлечен- 
ные пиктограммы, пользователь может сделать двойной щелчок на какой-ни- 
будь из них и сохранить ее в файле с указанным именем. А в последующем он 
может включить эту сохраненную в файле пиктограмму в свое приложение. 


5.4 Пиктограммы, битовые матрицы, формат }РЕС 351 


Рис. 5.12 ‚1 Получение и сохранение пиктограмы 


Приложение Р{2 


Найти... | Файл: О-\\АЛМОО\ 5 \зузет32\ Ве! 32. ЧН 


Рассмотрим код приложения, которое можно найти на приложенном 


к книге диске под именем Р:с{2 в каталоге [сопз. 


у01Аа __ Еаз®са11 ТЕГогм1 : : Ви оп1С11сК (ТОр)]есе *5епаег) 


{ 
НТСОМ пТсоп ру 
ТТсоп *Тсоп = пем ТТсоп; 


1Е (Орепр1а1о0о91->Ехесоке ()) 
{ 


Тафе11->СарЕ1оп="файл: " + Орепр1а1оа1->Е11еМапе; 
Тмадче1$%1->С1еах(); 
101 = -1; 


п1соп = Ех гас®Тсоп (НапаТе, 
РСрВаг (Орепр1а1091->Е11еМаме.с_зек()), 1); 
Рог (1=0; 1< (106) пТсоп ;1++) 
{ 
Тсоп->Напа]1е = Ехегас®Тсоп (Напа]1е, 
РСВаг (Орепр1а1091->Е11еМаме.с_56к()), 1); 
Тпадчет1$%1->АааТсоп (Тсоп); 
} 


Тсоп->Егее (); 
КогиРа1пЕ (бепаег); 


ея ---н--------------- ----------=--- 


РгамСг1а1->ШеЁЕац1%Со1М1аЕ1=42; 
РгамСг1491->реЁа11ВомНе190$=42; 

РгамСг1а1->Со1Соцп Е = 10; 

РгамСг1а1->ВомСоцпЕ = (Тмаде11$&1->Соип® - 1) / 10 + 1; 


} 


\01А _ Еаз®са11 ТЕГогм1; : Огамбг1А1РгамСе11 (ТОр)есе *5епаег, 11% 
АСо]1, 1пЕ АКом, ТКес® &Весе, ТбсглАаргамбфаее Зкафке) 
{ 
Тпачет1$Е1->Огам (РхамСг191->Сапуа$, Вес®.теЕф+5, 
Весе.Тор+5, 
АВом * ОгамСг1а1->Со1СочпЕ + АСо1); 


у01А _ Еаз®са11 ТГогм1 ;: :Огамбг1а10р1С11скК (ТОБЗесЕ *5бепаекг) 
{ 
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10Е 1пА = ОгамСг1а1->Со1 + 10 * Огамбсг1а1->Вом; 
1Е (10а < ГмадеЪ1$%1->Соцпф) 
1Е (ЗауеР1сфеагеО1а1о91->Ехесаее ()) 


{ 
ТТсоп * Тсоп = пем ТТсоп; 
Тпачет1$%1->СееТсоп (11а, Тсоп}; 
Тсоп->бауеТоЕ11е (бауеР1сеигер1а1091->Е11еМапе); 
Тсоп->Егее (); 


01а _ Газ®са11 ТЕоги1: : КокиСгеа®е (ТОБ)]есе *5епаег) 


{ 
Тпазет1$%1->Незайе = 32; 
Ттадет1${1->и1аЕВ = 32; 

} 


Функция ВиЙоп1СИеК является обработчиком щелчка на кнопке Найти. 
Код этого обработчика подобен рассмотренному ранее. Только в цикле деск- 
рипторы пиктограмм передаются во временный объект [Гсоп, а затем с его по- 
мощью заносятся в список ПпазеТ. 1541 методом АЗ9@Тсоп. В конце этого обра- 
ботчика вызывается функция ЕогтРа шт, которая одновременно является об- 
работчиком события формы ОпРашф. В этой функции задаются параметры 
компонента Огам@т1а1. Причина, по которой к этой функции надо обращать- 
ся как к обработчику события ОпРашё заключается в том, что если окно при- 
ложения будет временно перекрыто окном какого-то другого приложения, 
изображение в Огам@ма1 сотрется. Перестройка в обработчике события 
ОпРашЁф параметров таблицы Огам@(г191 вызывает последовательность собы- 
тий ОпОгамСе|, в обработчике которых (в функции ОгамСг191ОгамСе!) изо- 
бражения пиктограмм заносятся в таблицу. 

Функция Огам@та1тРЫсСЦеК является обработчиком двойного щелчка на 
ячейке ОгамСг!1а1. В ней сначала вычисляется индекс пиктограммы этой 
ячейки в компоненте ПпайеТ. 1541. Далее проверяется, не выбрал ли пользова- 
тель пустую ячейку. Такие ячейки могут появиться в конце таблицы, если 
число пиктограмм в файле не кратно 10. Затем следует вызов диалога сохране- 
ния в файле. Пиктограмма извлекается методом @еШМсеоп из списка ПпабеГ! 1541 
во временный объект Геоп. Затем она сохраняется в файле. 

В функции РЕогтСгеже задаются размеры пиктограмм в списке Гтарйе- 
1.1541 (см. разд. 5.4.3). Конечно, можно было бы задать эти размеры во время 
проектирования. Эти операторы включены в пример, чтобы обратить ваше 
внимание на необходимость думать о размерах изображений. Честно говоря, 
стандартный размер 16 х 16 маловат для того, чтобы можно было нормально 
разглядеть многие пиктограммы. 


Достоинством рассмотренной функции Ехй’гас_соп является то, что она 
позволяет получить все пиктограммы файла. А недостатком функции по срав- 
нению с Ехёгае АззосавеЯТсоп является невозможность получить пиктограм- 
му файла, связанного с файлом документа. Впрочем, этот недостаток легко ис- 
править. Ниже приведен эквивалентный код приложения РЕ, но с добавлени- 
ем дополнительных возможностей для пользователя (они выделены жирным 
шрифтом). 

НТСОМ Тсоп, пТсоп ; 

сваг АРсВаг [МАХ РАТН]; 

Апз15г1па 5; 

ПЕ 1; 
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{Е (Орепр1а1091->Ехесике ()) 
{ 


Таре11->Саре1оп="Файл: " + Орепр1а1о31->Р11еМаме; 
‚Тмаде1->Сапуа$->Е111Вес® (Тмаае1->С11епеВес®); 
1 = -1; 
п1соп = Ехегас®Тсоп (Напа? е, 

РСвахг (Орепр1а1091->ЁР11еМаме.с_з&к ()), 1); 
5$= ОрепрО1а1о91->Е11еМаме; 
12 (пТсоп == 0) 


{ 
ЕГ1паЕБхесоваЬ1е ($.с зЕг(), МОГ, АРсьаг); 


1Е (АРсваг != "") 

{ 
1 = -1; 
пТсоп = ЕхёгасЕТсоп (Напа1е, АРсВаг, 1); 
$ = АРсраг; 


} 
} 


Рог (1=0; 1< (116) рпТсой ;1++) 
{ 
Тсоп = Ехегас®Тсоп (НапЯ91е,$.с_з%г(), 1); 
ОПгамТсоп (Тмадче1->Сапуаз->Напа1е, 
10 + 60 *(1 $% 10) ‚ 20 + 60* ((1 + 1) / 10) ‚, Тсоп); 


} 


Как видно, отличия заключаются во введении дополнительного кода на 
случай, если пользователь выбрал неисполняемый файл, а файл, который свя- 
зан с каким-либо приложением. Введены две локальные переменные АРеваг 
и 5. В переменную АРеваг записывается полученный функцией Еш@аЕхеси- 
фае путь к исполняемому файлу приложения. В переменную $ записывается 
путь выбранного файла. Если выбранный файл неисполняемый (документ), то 
псоп = 0, и функцией Еш9Ехесшва Ме извлекается путь к связанному с доку- 
ментом приложению. Далее проверяется, есть ли в данном приложении пикто- 
граммы. Если есть, то определяется функцией Ехгас Иеоп число пиктограмм 
и в переменную 3 заносится путь к исполняемому файлу связанного приложе- 
ния. 

С этим дополнением приведенный код позволяет получать пиктограммы, 
связанные с файлом документа. Например, если пользователь откроет в диало- 
ге файл .4ос, ему будет показано от 8 до 12 пиктограмм, содержащихся в фай- 
ле программы У ога. 

В приведенных примерах полученные пиктограммы просто отображались 
на канве или сохранялись в файлах. Если пиктограммы нужны вам во время 
выполнения, то целесообразно помещать их в компонент типа ТПвареГ1$%, из 
которого их можно далее использовать в кнопках, разделах меню и т.д. Если 
вам требуется такое использование пиктограмм, то целесообразно загружать 
их, как это было описано выше в одном из примеров, в компонент Гоп типа 
Топ. Тогда достаточно выполнить оператор 


ТпаачеЬ1$$1->АааТсоп (Тсоп); 
и пиктограмма будет добавлена в список изображений ПпайеГ!1 $41. 
Имеется еще одна функция, которая облегчает добавление пиктограмм не- 


посредственно в список изображений. Это функция $Нае Ее о, объявлен- 
ная в файле 5йеПАРГ.Й следующим образом: 


354 | Глава 5. Окна и графика 


З5НЗТРАРТ (РМОКВрО_РТК) ЗНсееЕ11етТптЕо (.РСЗТВ рз2Ра®Цц, 
РИОКР ЯмЕ11еА г1Бафез, ЗНЕТЬЕТМРГОА *рзЕт, 
ОТМТ сЬЕ11е1ТтЕо, ОТМТ чЁЕ1ааз$); 


Функция 5Н@е Ее {о дает возможность получить разнообразную ин- 
формацию об объекте файловой системы: файле, папке, диске. Подробнее об 
этой функции см. во встроенной справке С++Ви!Паег или в справке [4]. Но 
в данном случае нас интересует то, что она позволяет получить доступ к спи- 
скам пиктограмм. Параметр р$7Ра{ задает файл, о котором требуется полу- 
чить информацию. Параметр 4мЕЦеА г ще$ определяет атрибуты файла 
и в нашем случае его можно задавать равным 0. В передаваемую по ссылке за- 
пись р$Й типа ТЗНЕПе|\о функция заносит полученную информацию. Пара- 
метр с ЕПе{о задает размер структура рзЁ_. Структура р содержит поля: 


| ад НгИриев 


Га 5211 рауМаше[МАХ _ РАТН] 
`52ТуреМ ате[80}]; 


_ Параметр иЕ1а5$ включает наборы флагов. Для нашей задачи представля- 
ют интерес наборы флагов "ЗНСЕТ_ ЗМАШИЛСОМ | ЗНСЕТ ТСОМ | ЗНСЕТ $У$- 
1СОММОЕХ" и "ЗНСЕГ ГАВСЕГСОМ | ЗНСЕГ ТСОМ | ЭНСЕГ зУ51СОМГУ- 
РЕХ”. При первом из этих наборов флагов функция возвращает дескрипор 
системного списка малых пиктограмм, используемого указанным приложени- 
ем. При этом в поле Цеоп записи заносится индекс, который имеет в этом спи- 
ске пиктограмма приложения, а в поле Шсоп заносится дескриптор этой пик- 
тограммы. При втором из указанных сочетаний флагов функция ведет себя 
аналогично, но возвращает дескриптор списка больших пиктограмм. 

Эта функция представляет интерес в основном при работе в \У/114о\з 9.х. 
В этих версиях У/1ш4о\з в качестве параметра рз2РаёВ можно было задавать 
или имя файла, или шаблон. Поэтому традиционным применением функции 
было следующее: 

ТТмадер1$е *5бта11]тадез$ = пем ТТмадет1$% (Гоги1); 


Т5НЕ11]еТпЁо Е1;. 
Апз15Ег1па $5Е11е ="*.*и; 


Зпа11Ттадез->Напа1е = $НбееЕ11е1тЕо( $Р11е.с э6г(), 0, &Е4, 
312е0Е (&Е1), ЭНСЕТ ЗМАБЬТСОМ | 
ЗНСЕТ_ТСОМ | ЗНСЕТ 5УЗТСОМТМРЕХ); 


В результате выполнения этого кода в созданный список Эта Штаге$ за- 
носились системные пиктограммы всех файлов, и вы получали широкие воз- 
можности работать с любыми пиктограммами. К сожалению, в У\У/1194о\з 
МТ/2000/ХР задавать в функции шаблоны не позволяется. Так что эта функ- 
ция во многом потеряла свое значение. 
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5.4.2 Стандартные пиктограммы и изображения для кнопок 


Получить стандартные системные пиктограммы, используемые в различ- 
ных окнах сообщений, можно функцией Гоа4Гсоп, объявленной в модуле 
И пизег.й следующим образом: 


НТСОМ Гоа@ЯТсоп (ТМ НТМУТАМСЕ ЮТпзбапсе, ТМ ТРСЗТК 1рТсопМапе); 


Функция может загружать пикограмму из ресурса файла, дескриптор ко- 
торого указан параметром Иш$вапсе. Но в разд. 5.4.1 уже рассмотрено не- 
сколько функций, извлекающих пиктограммы из файлов, так что не стоит 
рассматривать еще одну. Функция Гоа4Тсоп интересна тем, что позволяет так- 
же получать дескринторы системных пиктограмм. Для этого параметр ВТ$- 
фапсе надо задать равным 0, а параметр 1р[еопМаште сформировать из иденти- 
фикатора системной пиктограммы. Формируется параметр 1рГсопМате с по- 
мощью макроса МАКЕГМТВКЕЗООСВСЕ, в который передается одна из следую- 
щих констант: ШТ АРРЫСАТТОМ, ШГ_А$ТЕВ1$К, ШТ ЕХСГАМАТТОМ, 
ШТ НАМ, ШГ _ФОЕЗТТОМ, ШТ_МТМГОСО. Как выглядят соответствующие 
пиктограммы в У\Утп4о\з ХР вы можете увидеть на рис. 5.13. Конечно, в раз- 
ных версиях У! ш4о\з и при разных настройках они изменяют свой вид. 


Рис. 5.13 2} Системные пиктограммы ^^ ера 


Системные [1 ВЫЕЗТОМ |1 ММС О60 
пиктограммы 


Если вам надо получить одну из этих пиктограмм, достаточно выполнить 
код вида: | | 
НТСОК Тсоп ; 


Тсоп = Гоа@аТсоп (0, МАКЕТМТВЕЗООВСЕ (ТОТ_АРРЬТСАТТОМ)); 


А дальнейшие манипуляции с пиктограммами, дескрипторы которых по- 
лучены той или иной функцией, подробно описаны в разд. 5.4.1 и дополни- 
тельно будут рассмотрены в разд. 5.4.3. 

Теперь рассмотрим получение пиктограмм стандартных действий, исполь- 
зуемых обычно в разделах меню и в быстрых кнопках. Эти пиктограммы про- 
ще всего получить во время проектирования с помощью компонента АсЙоп- 
115$. Перенесите на форму компоненты ПпахеТ.156 (страница \\/т32), Аей- 
0111$ (страница Зюпаа!) и сошлитесь в свойстве Ппагез$ компонента АсИоп- 
1.15% на компонент ПпадеТ.1$%. Далее откройте двойным щелчком на АсЯоп11$% 
окно редактора действий, выберите из контекстного меню раздел Ме\ми Запдага 
Астоп и добавьте в компонент все стандартные действия. При этом в список 
ГпаеГ.15{ загрузятся пиктограммы множества стандартных действий. Теперь 
можете удалить Ас{10п1[:1$%, если он вам не нужен, так как требуемые пикто- 
граммы у вас уже имеются. Эти пиктограммы вы можете видеть на рис. 5.14 
(проект 5аапаВа{ в каталоге [сопз на приложенном к книге диске). 
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Рис. 5.14 НЕ = Пиктограммы стандар №: 
Пиктограммы стандартных 
действий 


Хх. 
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Из редактора списка ПпазеГ.15{ вы можете сохранить кнопкой Ехрой нуж- 
ные вам пиктограммы в виде файлов .6тр и использовать их в дальнейших 
проектах. Но я бы посоветовал поступить иначе — сохранить этот список 
в библиотеке в качестве шаблона (команда Сотропеп! | Сгесме Сотропеп! 
Тетр!с\е). При этом его стоит пополнить другими изображениями, полученны- 
ми описанными в разд. 5.4.1 способами, дополнить какими-то изображениями 
кнопок, поставляемыми с С++Воа!Паег, в общем — создать почти универсаль- 
ный шаблон Ппабе{. 156 с часто используемыми изображениями. Тогда в новых 
проектах у вас практически не будет возникать проблем с пиктограммами. 
Достаточно будет ввести в приложение ваш шаблон и убрать из него то, что 
вам не потребуется в данном проекте. 

И в заключение еще один совсем не программный способ получения изо- 
_ бражений для кнопок. Если в какой-то программе, с которой вы работаете, 
есть изображения кнопок, которые вы хотели бы применить в своей програм- 
ме, то это можно сделать с помощью редактора изображений, поставляемого 
в составе С++Во!аег 6. Запустите программу, изображение из которой вы хо- 
тите получить. Нажмите клавиши А!|-Рип! 5сгееп. Изображение окна програм- 
мы занесется в буфер обмена. Теперь вызовите Ппабе ЕдЦог (команда Тоо} | 
|паде ЕЧйог) и выполните команду Ее | Мем | Внтар Ме. В открывшемся окне за- 
дайте размер изображения 16 х 16. А теперь нажмите клавиши Сн|-\, чтобы 
скопировать изображение из буфера обмена. Вам остается только сдвинуть 
изображение так, чтобы была видна приглянувшаяся вам кнопка, и сохранить 
пиктограмму в файле командой Не | бауе Аз. 


5.4.3 Изображение и масштабирование пиктограмм 


В разд. 5.4.1 рассказывалось, как получать пиктограммы из файлов 
и ОГ.Г.. Пиктограммы получались или в виде их дескрипторов, или в виде ком- 
понентов типа Топ, или заносились в списки изображений ПпареГ.15$6 (непо- 
средственно, или через Т1соп). Теперь коротко рассмотрим, как получать их 
изображения в приложении. 

Рисовать пиктограммы можно функцией Огам[Теоп, объявленной в модуле 
У тизег.й следующим образом: 


ВООТ ОгамТсоп (ТМ НОС ПОС, ТМ 118 Х,ТМ 1пЕ У, 1М НТСОМ ЮТсоп); 


Параметр ВОС — дескриптор контекста, на котором должна изображать- 
ся пиктограмма. Обычно это дескриптор канвы. Параметры Х и У задают ко- 
ординаты левого верхнего угла изображения, а параметр Шеоп — дескриптор 
пиктограммы. 
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Например, если Геоп — дескриптор пиктограммы, полученной из файла 
или иным путем, то оператор 


РгамТсоп (Тпадче1->Сапуа$->Напа1е, 10, 10, Тсоп); 


изобразит эту пиктограмму на канве компонента Ппаёе1. 

Пиктограммы, в отличие от битовых матриц, не масштабируются, т.е. их 
размеры неизменны. Тем не менее, размер изображения можно изменять. Это 
позволяет делать функция ОгамМеопЕх: 

ВООЪ РгамТсопЕх (ТМ НОС Пас, ТМ 1пе хЬеЕе, ТМ 1пЕе уТор, 

ТМ НТСОМ ВТсоп, ТМ 1пе схи1абр, ТМ 1пе суймтафр, 


ТМ ОТМТ 156ертЕАп1Сиг, ТМ НВВКОЗН ЮрхЕ]11сКегЕгее,кам, 
ТМ ОТМТ а91Е1ааз); 


Параметр ВОС — дескриптор контекста, обычно канвы. Параметры ХиУ 
задают координаты левого верхнего угла изображения, а параметр Шеоп — де- 
скриптор пиктограммы. Параметры сх М1 и су\ 14 — это логическая ши- 
рина и высота изображения пиктограммы. Эти значения могут отличаться от 
ее реальных размеров. Параметр 5%&ерНАшСиг имеет отношение к изображе- 
ниям курсоров и при изображении пиктограмм может быть задан-равным 0. 
Параметр В6гЕПсКегЕгееОгам — дескриптор кисти ВгизВ канвы. Параметр 
4Еа5$ — флаг, определяющий, в частности, размер изображения. Если за- 
дать (Е а2$ = 0, то размеры изображения будут определяться значениями па- 
раметров сх \ 14 и су \1а1. А если значения этих параметров заданы равны- 
ми 0, то размер изображения будет равен истинному размеру пиктограммы. 
Если задать 91 1ай$ = ОГ_СОМРАТ, то значения сх УЛай и су\191 1 будут иг- 
норироваться, и размер пиктограммы будет равен заданным в системе по 
умолчанию. Если задать (Е а$ = ОТ РЕЕАОТТЬТЯЕ, то размеры будут рав- 
ны размерам по умолчанию, даже если сх УЛ и су 14 равны нулю. Ос- 
тальные значения см. в описании функции в гл. 8. 

Рассмотрим примеры. Если !еоп — дескриптор пиктограммы типа 
НТСОМ, то изображения этой пиктограммы на канве компонента Ппабе1 мож- 
но получить следующими операторами: 

РхамТсопЕх (Ттаде1->Сапуаз->Нап@1е, 10, 10, Тсоп, 16, 16, 

О, Тпаде1->Сапуа$->Вхазй->Напа1е, 0); 

РгамТсопЕх (Тмаде1->Сапуаз->НапЧ1е, 100, 10, Тсоп, За, 32, 

О, Тпаде1->Сапуаз->ВгазВ->Напа1е, 0); 


ОРгамТсопЕх (Тмааче1->Сапуа$->Напа1е, 150, 10, Тсоп, 64, 64, 
О, Тмаде1->Сапуаз->ВгизВ->Напа1е, 0); 


Эти операторы дадут 3 изображения одной и той же пиктограммы с разме- 
рами 16х 16, 32 х 32 и 64х 64. 

Функцию Ога сопЕх можно использовать и для масштабированного изо- 
бражения пиктограмм, хранящихся в списках ПпареГ!.156. Методику такого 
изображения иллюстрирует следующий код: 

‚ТТсоп *МуТсоп= пем ТТсоп; 

Тпадчет1$61->СееТсоп (0, МуТсоп); | 

РгамТсопЕх (Тмаде1->Сапуа$->Нап1е, 10, 10, МуТсоп->Напа1е, 32, 32, 0, 


Тпадче1->Сапуа$->Вгазв->Напа1е, 0); 
Му1соп->Егее (); 


В этом коде создается объект МУесоп типа Тсоп, в него методом @ееоп 
загружается первая пиктограмма из списка ПпасеГ,1${1, а затем эта пикто- 
грамма рисуется функцией Рга\у[сопЕх. После этого объект МуГоп уничто- 
жается. 
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Теперь рассмотрим отображение пиктограмм из списков ТПпабеГ1$$. Ото- 
бражение получается методом Огам. Например, следующий оператор отобра- 
зит на канве компонента Ппае1 первую пиктограмму, хранящуюся в Ппаге- 
[1$ 1: 


Тпачет1$61->Огам (Ттаде1->Сапуа$, 10, 10, 0); 


Размер изображения определяется не истинным размером пиктограммы, 
а размерами, заданными в компоненте ТПпахеГ1$%. Например, вы можете соз- 
дать два списка ПпабеГ,1$41 и Ппасе[.1${2, в первом оставить значения Не 
и У\1А по умолчанию (эти значения равны 16), а во втором задать их значе- 
ния равными 32. Если вы заполните эти списки одинаковыми пиктограмма- 
ми, то применение метода Ога\м к первому списку даст изображение 16 х 16, 
а ко второму — 32 х 32. 

Список пиктограмм с измененным размером можно создать и программно. 
Например, так: 

ТТсоп *Тсоп = пем ТТсоп; 

ТТиадет1$Е *Тмадегт$ЕТир = пем ТТмадет1$% (32,32); 

Бог (106 1= 0 ;1< [ГтадеГ1$61->Сооп®;1++)° 

Тпаачет1$%1->СееТсоп (1,Тсоп); 


Ттадер1 з&Тир->АааТсоп (Тсоп); 


Тсоп->Егее (); 

Тпачет1$1->Огам (Тмадче1->Сапуаз, 10, 10, 0); 

ТпазчеГ1 $Тир->Огам (Ттаде1->Сапуа$, 100, 10, 0); 

Гпачер1$ЕТир->Егее ()'; 

Здесь операцией пем создается список Ппазе[1$Ттр с размером изобра- 
жений 32 х 32. Далее в цикле в него переносятся все пиктограммы из 
ГпареГ.15{1. Каждая пиктограмма извлекается из списка ПпайеГ!.1${1 методом 
Се соп и заносится в список ГпасеТ.15Ттр методом А@@ЯГсоп. К сожалению, 
в данном случае нельзя для переноса изображений между списками воспользо- 
ваться методом АЯ4Ттабе$, поскольку в этом случае изображения перенесутся 
вместе со своими размерами. | 

Отметим также, что рассмотренный прием масштабирования работает 
только для пиктограмм. Битовые изображения ТВЁтар невозможно без до- 
полнительных преобразований перенести в список другого размера. 


5.4.4 Работа с изображениями /РЕС 


В ряде задач требуется взаимное преобразование изображений форматов 
ВМР и 4РЕС. Во-первых, в ресурсах исполняемых файлов могут храниться изо- 
бражения в формате 4РЕС (см. разд. 4.1), и их требуется уметь читать и отобра- 
жать. Во-вторых, в ряде случаев полезно преобразовать изображение ВМР в бо- 
лее компактный формат УРЕС. Иногда желательно также в приложении дать 
возможность пользователю нарисовать изображение или отредактировать изо- 
бражение из файла .]рх, а затем сохранить результат в формате УРЕС. 

Для того чтобы иметь возможность работать с форматом УРЕС, достаточно 
подключить к своему модулю файл чурев.йрр. Мы уже использовали это 
в разд. 1.5 и 4.1.4. Подключение этого заголовочного файла обеспечивает воз- 
можность выбора файлов .[рё и рей диалогом ОрепР1ефаге 1а]1о? и чтения их, 
например, в компонент Нпабе. Но для более сложных операций с изображе- 
ниями РЕС в приложении надо создать объект класса ТУРЕСПпабе, объяв- 
ленного в файле Урез.йрр. Например: 
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ТОРЕСТмаде *7]ра = пем ТУРЕСТмасве ();. 


3) 


В отличие от большинства графических объектов, объекты класса ТУРЕС- 
Гпасе не дают непосредственный доступ к изображению. Изображение хра- 
нится во внутреннем компоненте класса ТЛРЕСОащца, к которому нет доступа 
из ТУРЕСПпафе. Не имеет ТУРЕСГпабе также собственной канвы, на которой 
можно рисовать или отображать изображение. Однако этот графический объ- 
ект можно копировать в компоненты, воспроизводящие изображения ВМР. 
Например, следующий оператор копирует в компонент Ппаге1 изображение, 
записанное в компоненте }рг: 


Тпаче1->Р1сбоаге->СгарЬ1с->Азз1ап (7ра); 


Возможно и обратное присваивание — из компонента Ппахе в ТУРЕС- 
Гтабсе: 


)рч->Азз19л (Тмаче1->Р1сбиге->Сгарп1с); 


Изображение в объект ТУРЕСПптазде можно загрузить и из файла .]рЕ или 
„рей: —_ | 
-ра->ГоааЕкомЕ11е ("Му.)рд"); 


Перед загрузкой изображения из файла, когда происходит его декомпрес- 
сия, с помощью свойства РегЁогтапсе объекта ТУРЕСГтахе можно указать, 
что вам важнее — скорость загрузки или качество воспроизведения цветов. 
Если задать Регогтапсее = }рВез 5 рее, то скорость будет высокой, но качест- 
во изображения может несколько пострадать. При Регогтапсе = }рВез$+- 
ОпаПу качество будет высоким, но скорость декомпрессии снижается. 

Скорость загрузки изображения из файла (скорость декомпрессии) можно 
также регулировать свойством Зее. Оно указывает размер отображаемого 
в результате загрузки изображения. Свойство может принимать значения: 
]3Еи$12е — полный размер, 1$На1!, }зОпажег, 15 ЕВ — соответственно по- 
ловина, четверть и одна восьмая размера. Например, значение 1542 А умень- 
птает размер в 8 раз, но во столько же раз повышает скорость загрузки. Ниже 
приведен пример подобной загрузки: | 

7рач->$5са1е = )5Елавец; 

-рч->ГоааЕгомЕ11е ("Му.7ра"); 

Тмаде1->Р1сфаге->СгарВ1с->Азз1ап (70а); 

Конечно, все эти способы ускорения загрузки имеют смысл только для 
больших и сложных изображений. Небольшие изображения загружаются 
и отображаются моментально. 

Перед записью изображения в файл можно задать значение свойства 
Сотшргезз1опОцаШу, определяющее соотношение между качеством изображе- 
ния и размером файла. Значение может лежать в пределах от 1 до 100. Макси- 
мальное значение 100 соответствует наивысшему качеству изображения, но 
и максимальному размеру файла. При значении 1 размер файла существенно 
уменьшается, но качество изображения обычно крайне низкое. Обычно суще- 
ственные искажения возникают уже при Сотргез1оп ца Шу = 80 и ниже. 
Впрочем, все зависит от сложности и многоцветности изображения. 

Изменение значения свойства Сотргез1оп Опа Шу само по себе не приво- 
дит к сжатию. Сжатие осуществляется вызовом метода Сотрге$$ объекта 
ТУРЕСПпафде. | 

При свойстве @Чгауэсае, установленном в фгие, изображение теряет мно- 
гоцветность и отображается оттенками серого цвета. Впрочем, это не просто 
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черно-белое изображение: оно содержит до 255 оттенков серого. Отсутствие 
цвета существенно сокращает размер файла и ускоряет его декомпрессию при 
последующей загрузке изображения из этого файла. 

Мы обсудили наиболее характерные методы и свойства объекта ТУРЕС- 
Гпасе. Остальные свойства достаточно похожи на свойства всех графических 
объектов. Теперь рассмотрим пример, иллюстрирующий работу с ТУРЕС- 
Гпарсе. Этот пример имеется на приложенном к книге диске в катало- 
ге /РЕС_ВМР в проекте УРС_ВМР. Вид приложения во время выполнения 
показан на рис. 5.15. Приложение содержит два компонента Ппабе: Ппахе1 
(слева на рис. 5.15) и Ппабе2. В левое окно с помощью кнопки Открыть (ее имя 
в приведенном далее коде ВОреп) можно загрузить графический файл ВМР 
(см. рис: 5.15 а) или ЗРЕС. Можно и не загружать файл, а что-то нарисовать 
в этом окне (см. рис. 5.15 6) с помощью кнопки Зрее4ВиЦвоп1 (левее кнопки 
Открыть). Разработка сколько-нибудь полноценного графического редактора 
в задачу данного примера не входила. Подобные редакторы подробно рассмот- 
рены в книге [1]. Так что здесь реализовано только простое перо, чтобы пока- 
зать возможность сохранения подобных рисунков в формате УРЕС. 


Рис. 5.15 | 
Приложение ‚Изображение /РЕб--—------------- 
в режиме просмотра | 
изображений /РЕС 


{\ Оттенки серого 


Качество 


У окрыь | Изображение РЕ бе 


Размер 88122 байт _ т м Оттенки серого Размер 2268 байт 


Качество. 


СЕ: 


‚ Сохранить | 


й 
+ 


м/о“ 


В метку ЭбайсТех{ 1, расположенную над компонентом тазе1, заносится 
размер загруженного файла или размер файла, который получится при сохра-. 
нении рисунка в формате ВМР. | 

В панели Изображение /РЕС (СгоирВох1) в правой части окна приложения 
находятся компоненты, позволяющие работать с изображением в формате 
зРЕС. По щелчку на кнопке Просмотр (ВЗВом) в компонент [Ппаге2 переносит- 
ся изображение из компонента Ппаге] в таком виде, в каком оно будет при по- 
следующем сохранении его в файле формата УРЕС. Предварительно можно за- 
дать характеристики изображения УРЕС. Ползунок Качество (ТгасКВаг1) и свя- 
занный с ним компонент СЗрш ЕЯ 1 позволяют установить значение свойства 
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Сошргеззоп@ иаШу, определяющего соотношение между качеством изображе- 
ния и размером файла. Индикатор Оттенки серого (СвееКВох]) дает возможность 
заменить цветовую гамму оттенками серого (правда, на черно-белом рис. 5.15 
это не видно). Метка Э4айеТехё2, расположенная над компонентом Ппаёе2, 
отображает размер файла, который получится при сохранении изображения 
в формате УРЕС. Так что сравнение данных, отображаемых в метках ЭайЙс- 
Тех{1 и З4айсТехё2, позволяет определить соотношение размеров файлов фор- 
матов ВМР и 3РЕС в различных ситуациях. Кнопка Сохранить (ВЗауе) позволя- 
ет сохранить файл изображения с выбранными характеристиками. 
Ниже приведен код этого приложения. 


#1пс1аае <дреад.Прр> 


ТОРЕСТмааде *]рдз = пем ТОРЕСТмаде (); 
Боо1 Реп; 


У01А _ РЕаз®са11 ТКогт1: :ВОрепС11скК (ТОБ)есе *бепаехг) 
{ 
1Е (ОрепР1сЕагер1а1о91->Ехесаке ()) 
{ 
Тпаче1->Р1сваге- >тоааЕгошЕт1е (ОрепРтсбикерта10о91->Е11еМаме) ; 
// определение размера файла 
10е Рапа1е = Е11еОреп (ОрепР1с6агер1а1о91->Е11еМапе, 
ЕтОрепВеаа); 
Зсаф1сТех®1->Сар®1оп = "Размер " + 
| ТоЕТобЕг (Е11ебееКк (Вапа1е,0,2)) + " байт"; 
Е11еС1озе (Папа1е); | 
// изменение размера и местоположения панели СгоирВох1 
1Е (СгоирВох1->ЪеЕЕ < Тпаде1->1еЕЕ + Тпаде1->итаеь + 10) 
СгопрВох1->ЬеЕЕ = Тмаде1->еЕЕ + Тмаде1->\1афер + 10; 
1Е (СгоирВох1->\1АП < Тпаде2->ЬеЕф + Тмаде2->мзафеь + 10) 
СгоирВох1->И1аАёВ = Тмаде2->ЪеЕе + Тпаде2->м1аеь + 10; 


Уу01А _ Еаз®са11 ТЕГогш1: : В5ПомС11скК (ТОР]ес® *5епаег) 

{ 

// оттенки серого или цвет 

7ра->Сгаузса1е = СрескКВох1->Срескеа; 

-ра->Азз1ат (Ттаде1->Р1скиге->СгарЮ1с); 

// степень сжатия 

-ра->Сошргез$1оп0ца116у = ТгаскКВаг1->Ро$1%1о0п; 

// упаковка изображения 

7-рач->Сотргез$ (); 

// сохранение во временном файле „.7]рд для определения размера 

-ра->бауеТоЕ11е ("-)ред.7ра"); 

1пе Вапа1е = Е11еОреп ("-)редч.7)рдч", ЕтОрепВеаа); 

Зсае1сТех*2->Сар®*1оп = "Размер " + | 
Тре Тобег (Е11ебееКк (Вапа1е,0,2)) + " байт"; 

Е11еС1озе (Вапа1е); в 

Тмаче2 ->Р1сфиге->ГоаАЕгопЕ1 1е ("-)ред.3)ра"); 

Ре1ефеЕ11е ("-)рез.7ра"); 

// непосредственная загрузка изображения в Ттаде?2 

// Ттаде2->Р1сЕиге->СгарВ1с->Аз5лап (7р9ч); 


У01А __Газ®са11 ТРГогит: :В5ауеСс11сКк (ТОР)]есе *5епаекг) 
{ 
1Е (ЗауеР1сеаге)1а1о91->Ехесате ()) 
)рч->бахеТоЕ11е (бауеР1с®игер1а1о31->Е11еМате) ; 
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у01А __Еаз®са11 ТЕоги|:; :ТгаскКВаг1Спапде (ТОБ]есе *5епаег) 


С5р1пЕЯ1{1->Уа1ае = ТгасКВаг1->Ро$1%1о0п; 


у01А __ЁЕазЕса11 ТЕГогкш1: :С5р1пЕЗ161СПапде (ТОБ]ес®е *5епаег) 


{ 
ТгаскВаг1->Роз11оп = С$р1пЕа161->Уа1ае; 


у01А _ Еаз®са11 ТГоги\1: : ГогшСгеаее (ТОБ]есе *5епаег) 


Тпаче1->Сапуаз->Е111Вес® (Тпаче1->Воппа$Вес®); 
// сохранение во временном файле „Ьтр для определения размера 
Тпаче1->Ртскаге->В1пар->бауеТоЕ11е ("-ртр.Ьтр"); 
106 Вапа1е = Е11еОреп ("-Бтр.Бтр", ЕтОрепВеаа); 
бсаф1сТех*1->СарЕ1оп = "Размер " + 

ТрЕТобег (Е11ебееКк (Рапа1е,0,2)) + " байт"; 
г11еслозе (вапале) ; 
Ре1ефеЁЕ11е ("-Бир.Бтр"); 


У01А __Еаз6са11 ТКогт1: : КогиС1озе (ТОр)есе *5епаег, 
ТС1озеАсЕ1оп &Асфе1оп) 


{ 
7-ра->Егее(); 


у01А _ Еаз&са11 ТЕогм-: : Тпаде1Моцзеромпт (ТОБ)]ес®е *5епаек, 
ТМоцзеВаЕ оп Ваееоп, Т5И1ЕЕбфафе $Б1ЕЕ, 1пЕ Х, 1пЕ У) 


1Е (бЗрееаВаоп1->ПВомп) 


// начало рисования пером 
Реп = Егие; 
Тпадче1->Сапуаз->МоуеТо (Х,\У); 


\01А '_ЕазЕса11 ТРоги1: : Тпаде1МоизеМоуе (ТОБ)]есе *бепаек, 
Т5В1ЕЕбсафе $ЗО1ЕЕ, 10 Х, 11 У) 


{ 

1Е (Реп) 
// продолжение рисования пером 
Тпаче1->Сапуаз->Ъ1пеТо (Х,У); 


у01А __Газ®са11 ТГоги1: : Тиаде1Моизе0р (ТОр]есЕ *5епаекг, 
ТМоцзеВа оп Вибеоп, ТбП1ЕЕббаее $И1Ек, 11 Х, 116 У) 
{ . 


// окончание рисования пером 
Реп = Еа1<е; 


} 


. Прежде всего, обратите внимание на необходимую для работы с форматом 
РЕС директиву шеш4е, подключающую файл „Уред.йрр. После этой директи- 
вы в коде следует создание глобальной переменной ]}рё класса ТУРЕСПпаге, ' 
в которой будет храниться изображение в формате УРЕС. Объявляется также 
глобальная переменная Реп, которая будет использоваться далее при рисова- 
нии линий. 
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Функция ВОрепСЦсК является обработчиком щелчка на кнопке Открыть. 
В ней обычным образом загружается в Ппадбе]1 изображение из файла, выбран- 
ного пользователем при работе с диалогом ОрепР\1еигеП1а]10о51. Открываемый 
файл может иметь формат ВМР или УРЕС. Дальнейшие действия в этой функ- 
ции связаны с отображением в метке 5ЗфайсТех{1 размера загруженного фай- 
ла. С помощью функции ЕЦеОреп получается дескриптор файла, а с помощью 
функции ЕЙПеЗееК определяется его размер. 

В компонентах [пабе] и пабе? установлены в фгие свойства Ащфо517е, 
чтобы размеры компонентов автоматически изменялись в соответствии с раз- 
мерами изображения. Но при загрузке больших изображений на форме может 
получиться перекрытие компонентов: компонент Ппабе1 накроет частично па- 
нель СгопрВохЁ, а компонент Ппаве? не поместится в этой панели. Поэтому 
последние операторы функции ВОрепСПеК предусматривают в подобных слу- 
чаях изменение положения и ширины панели СгоирВох1. 

Функция ВЗВомСИсК является обработчиком щелчка на кнопке Просмотр. 
Первый оператор этой функции задает значение свойства Сгаузса]е объекта 
{ре в зависимости от состояния индикатора Оттенки серого (СВесКВох1). Затем 
методом А$51п изображение из компонента Ппабе1 переносится в 1рт. В соот- 
ветствии с положением ползунка ТгасКВаг1 задается степень сжатия изобра- 
жения — свойство Сотргез1оп@иаШЩу. В ползунке ТгасКВаг1 свойства Мт 
и Мах заданы равными соответственно 1 и 100, что соответствует допустимым 
пределам изменения значения Сотргез51опО ца у. Следующий оператор ме- 
тодом Сотргез$ осуществляет сжатие изображения с заданной степенью. 

Далее надо отобразить изображение в компоненте Ппазе2. Если бы требо- 
валось только это, достаточно было бы выполнить соответствующее присваива- 
ние методом Аз; (закомментированный оператор в конце функции В$Вом- 
СПекК). Но мы хотим отображать размер файла, который получится при сохра- 
нении данного изображения в формате УРЕС. Для этого делается сохранение 
изображения методом ЗауеТоЕ!е во временном файле с именем “-]ред.]рх”. 
Затем с помощью функции ЕПеОреп получается дескриптор этого файла, а 
с помощью функции ЕЦеЗееК определяется его размер. Загрузка изображения 
в Ппаге2 производится из этого временного файла, после чего файл удаляется 
функцией ВаееЕе. 

Функция ВбауеСПеК является обработчиком щелчка на кнопке Сохранить. 
В ней методом ЗауеТоЕ1!е объекта ]рй изображение сохраняется в файле, ко- 
торый указал пользователь, работая с диалогом сохранения ЗауеР1ефаге- 
0121021. 

Функции ТгасКВаг1СВапое и СЭршЕЧЦ1СЬВапее являются обработчика- 
ми событий ОпСПВапге компонентов ТгаскВаг1 и СЗршЕЯИ1. В них просто 
производится согласование значений свойства Ро5 10оп компонента ТгасКВаг1 
и свойства Уае компонента СБртЕЧИТ. Так что пользователь может зада- 
вать степень сжатия или движком ползунка ТгасКВаг1, или численно в ком- 
поненте СЭртЕЗЧЦТ. 

Функция РЕогтСгезже является обработчиком события ОпСгеае формы. 
В этом обработчике канва компонента Ппабе1 очищается методом ЕШКВесф, что- 
бы пользователь, если захочет, мог на ней рисовать. Затем изображение канвы 
сохраняется методом ЗауеТоЕЙе во временном файле с именем “-Бтр.Бшр”, 
чтобы определить размер изображения, характерный для файла в формате 
ВМР. После определения и отображения размера файла он уничтожается. 

Функция РЕогтС1!ю$е является обработчиком события ОпС]озе формы. 
В нем удаляется созданный в начале выполнения приложения объект }ре. 
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Функции Ппае1 Моизероми, Ппахе1МопзеМоуе и Ппабе1МоизеОр явля- 
ются обработчиками событий компонента Ппасе1, связанных с мышью. При 
событии ОпМоицзеро\мп проверяется, нажата ли кнопка ЗреедВиЙоп1. Если 
нажата, то надо начинать рисование линии. Переменной Реп, которая в прило- 
жении указывает на режим рисования, задается значение фгие. Перо переме- 
щается методом МоуеТо в точку, в которой находится курсор мыши. При со- 
бытии ОпМоцизеМоуе проверяется значение переменной Реп. Если оно равно 
фгие, то рисуется линия из прежней точки в новую точку, в которой располо- 
жен курсор. При событии ОпМоизеОр переменной Реп задается значение 
{а!5е, что свидетельствует об окончании рисования линии. 

Поработав с подобным приложением, вы можете наглядно посмотреть 
влияние степени сжатия на размеры файлов УРЕС и на качество изображения. 
Соотношения между размерами файлов ВМР и 4РЕС в данном примере суще- 
ственно зависит от вида и насыщенности изображения. Для многокрасочного 
изображения (рис. 5.15 а) размер файла УРЕС при задании высокого качества 
может оказаться даже больше размера исходного файла ВМР. Впрочем, сни- 
жение качества примерно на 10-20 процентов позволяет существенно умень- 
шить размер файла. Заметно влияет на размер также замена многокрасочной 
палитры оттенками серого (на рис. 5.15 а изображен именно такой вариант). 
Если же рисунок ненасыщенный и не использует многоцветья, что характерно 
для большинства технических применений, то размер файла в формате УРЕС. 
получается намного меньше файла ВМР (см. пример на рис. 5.15 6). 


5.5 Основы @О!, преобразование координат 
изображений 


5.5.1 Понятие контекста устройства 


С точки зрения пользователя контекст устройства — это поверхность лю- 
бого оконного компонента, принтера и ряда других объектов, на которой мож- 
но отображать изображения и рисовать. Контекст имеет такие графические 
объекты, как перо для проведения линий, кисть для закрашивания областей 
контекста, битовая матрица, палитра, определяющая доступные цвета, 
шрифт, регион (см. разд. 5.2.2). | | | 

ВАРТ \/1п4о\з контекст устройства — это внутренняя структура, к кото- 
рой программист не имеет прямого доступа. Управление контекстом осуществ- 
ляется с помощью множества функций, основные из которых будут описаны 
далее. В совокупности они реализуют графический интерфейс устройств (=гар- 
В1с$ 4еу1се пфег!асе — СОТ), который поддерживается библиотеками СОГ.О/,, 
@РГ.0ОГ.32 и драйверами устройств. СОТ обеспечивает программиста многими 
сотнями функций. Отличительной чертой СТ является независимость от кон- 
кретных устройств, видеокарт, принтеров. Так что вы с равным успехом може- 
те рисовать на поверхности любого оконного компонента, на поверхности ра- 
бочего стола, но поверхности документа, печатаемого принтером. 

Доступ к контексту устройства обеспечивается его дескриптором. Если 
речь идет об изображениях на канве Сапуа$ типа ТСапуа$, то дескриптором 
контекста является дескриптор канвы Сапуаз—>НапШе. Но с помощью функ- 
ций АРТ \У1п4о\$ можно помещать изображения, трансформируя при жела- 
нии их координаты, на поверхности любого оконного компонента, например, 
на панели типа ТРапе|, не имеющей канвы. В этом случае дескриптор контек- 
ста может быть получен с помощью функции АР] \У/114омз Сеё ОС: 
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ИТМОЗЕКАРТ НРС сСеёрс (ТМ НИМР Б\па); 


В качестве аргумента В\У/п4 задается дескриптор окна. Например, оператор 
НОС Н = Сеферос (Рапе11->Напа1е); 


присвоит переменной Н дескриптор контекста панели Рапе1. 
Имеется еще одна функция — де \Ут94ом)С, позволяющая получить де- 
скриптор окна: 


ИТМОЗЕВАРТ НОС Сее\М1паомрс (ТМ НИМО ВИпа); 


Эта функция отличается от Се ОС тем, что дает доступ к окну целиком, 
включая его полосу заголовка, меню, полосы прокрутки. 

Если функцией бе ОС или Се \Ут@дом)Сс был получен дескриптор кон- 
текста, то после того, как необходимость в нем отпадет, он должен быть осво- 
божден функцией В@еа$е)С: 


ИТМОЗЕВАРТ 1пЕе Ве1еазерс (ТМ НИМО РИра, тм НОС 1№0С); 


Аргументы ВУ\У/п4 и ВОС указывают соответственно дескрипторы окна и осво- 
бождаемого контекста. 


На контексте устройства можно отображать изображения, рисовать линии 
и фигуры. Если устройство является канвой ТСапуа$, то можно использовать 
любые методы канвы для копирования изображений и рисования: МоуеТо, 
ГлпеТо и множество других. Если же контекст не канва, то для копирования 
на него изображения можно использовать функцию ВЁВНИ (впрочем, ее можно 
использовать и для копирования на канву): 
ИТМСОТАРТ ВООТ В1ЕВ1+(1М НОС Насрезе, ТМ 11% пхрезк, 
ТМ 1пЕ пурезе, ТМ 1пЕ опмМ1абь, 
ТМ 1пЕ пНеларб®, ТМ НОС Расбкс, 


ТМ апЕ пхХбкес, 1М№М 106 пуУбкгс, 
ТМ РИОВР амВор); 


Параметры В4е)е$%, пХО,е$&, пУ,/е$, пУ\У1а®, пНеВ определяют деск- 
риптор контекста, координаты левого верхнего угла, ширины и высоты облас- 
ти контекста, в которую проводится копирование. Параметры В@4с8ге, пХ$гс, 
пУбге определяют дескриптор и координаты левого верхнего угла области 
того контекста, из которого копируется изображение. Параметр 4мКВор опре- 
деляет режим комбинирования цветов источника и приемника изображения. 
Значения ВГАСКМЕЗ5 и \УШЩШТЕМЕЗЬ просто заливают область приемника 
цветом, соответствующим в палитре по умолчанию черному и белому. Эти зна- 
чения используются обычно для очистки области приемника. Значение 
5ВССОРУ обеспечивает копирование изображения. Остальные значения, ко- 
торые вы можете посмотреть во встроенный справке С++Виаег, обеспечива- 
ют различные комбинации цветов изображений в источнике и приемнике. 

Рассмотрим примеры. В них предполагается, что Н — дескриптор контек- 
ста панели Рапе!1. Тогда следующий оператор очистит поверхность панели, 
заполнив ее белым цветом: 

В1%В1% (Н, Рапе11->С11епЕВесе.ЪеЕе, Рапе11->С11епеВес®.Тор, 


Рапе11->С11епЕВес*.иласв (), 
Рапе11->С11епеВес®.Незаве (), МОГЬ, О, 0, И"НТТЕМЕЗ5); 


Следующий оператор перенесет в указанную область панели изображение, 
хранящееся в объекте ВЁтар типа ТВ тар: 


В1ЕВ1е(Н, 10, 10, 100, 100, В1Емар->Сапуаз->Напа1е, 
О, О, $УВССОРУ); 
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Для рисования линий на контексте устройства в АР1 \У/1т94о\мз предусмот- 
рен ряд функций: Аге и АгсТо — рисуют окружность или эллипс, теТо — 
рисует линию, МоуеТоЕх — перемещает перо, Ро!уВежег, Ро]уВежлегТо, 
Ро!у)гам, Роуше, Ро1у|пеТо, Ро!уРо]уПпе — рисуют кривые по заданному 
массиву точек, и ряд других. Функции, оканчивающиеся на “То” отличаются 
тем, что перемещают позицию пера в конец линии. В целом эти функции похо- 
жи на соответствующие методы класса ТСапуа$. Основное отличие от методов 
ТСапуаз заключается в том, что во все эти функции первым аргументом пере- 
дается дескриптор контекста. Подробное описание всех этих функций вы най- 
дете в гл. 8. 

Например, следующие операторы нарисуют на панели линию из левого 
верхнего в правый нижний угол панели Рапе!1: 


МохеТоЕх (Н, 0, 0, №11); 
Т1реТо (Н, Рапе11->МзаЕр, Рапе11->Не1ат*); 


В первом операторе, перемещающем перо в верхний левый угол, послед-` 
ний аргумент в вызове МоуеТоЕх задан равным МОГ.Г. В качестве этого аргу- 
мента можно было бы задать указатель на запись типа РОТМТ. Тогда в этой за- 
писи сохранилась бы предшествующая позиция пера. 

Имеется также ряд функций, рисующих заполненные фигуры: СКвог4, ЕШрее, 
Р1е, Роугоп, Ро!уРо]угоп, Вефап]е, Коипд Вес и ряд других (см. их описание и 
примеры применения в гл. 8). Как и для упомянутых ранее функций основное от- 
личие этих функций от аналогичных методов ТСапуа$ заключается в том, что 
в них первым аргументом передается дескриптор контекста. 

В качестве примера ниже приведены операторы, рисующие прямоуголь- 
ник и круг, вписанные в панель Рапе1: 


Кесфкапа1е(Н, 0, 0, Рапе11->м1аЕеВ, Рапе11->Незар®); 
Агс (Н, О, 0, Рапе11->\1а6в, Рапе11->Нетарве, О0, 0, 0, 0); 


Все перечисленные функции рисуют линии или контуры фигур текущим 
пером. Заливка площади фигур осуществляется текущей кистью. Перо 
и кисть можно выбирать из числа предопределенных с помощью функции: 


_ МТМСОТАРТ НСРТОВУ Сбеф5еосКкКОр)ес® (ТМ 1пе ЕпОБ)ес®); 
Функция возвращает дескриптор соответствующего пера, кисти, шрифта, па- 
литры. Параметр #пОБдес{ может принимать множество значений. Полный их 


список см. в описании функции в гл. 8. А пока укажем значения, которые ис- 
пользуются в последующих примерах: 


м =—— = = ——== И ини рии ===: ро = 


Нотл0\ _ ВКО Н, Пустая кисть (отсутствие заливки). 
ты вон 
| МНТТЕ_ВВоН | Велая кисть. 
_ВГАСК_РЕМ .__; Черное перо. —_ ИИ | 
МО._РЕМ _______ Нулевое перо, (не рисует. линии). НИ — 
| ЗУЗТЕМ_ЕОМТ Системный шрифт по умолчанию с изменяющей- — 
| 


| _ ся шириной СИМВОЛОВ. 


о —— = == == и == —- ——— И 
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Например, оператор 
НВКО$Н НМОЪЬ = бее5еоскОЮесе (МОТ ВВОЗН); 


занесет в переменную НМОТТ, дескриптор пустой кисти. При использовании 
такой кисти фигуры, рисуемые рассмотренными ранее функциями, не будут 
закрашиваться внутри. 

Оператор 


НРЕМ В1аскКРеп = Сее$оскКОБ)ес® (ВЬАСК_РЕМ);; 


создает дескриптор черного пера. 
Оператор 


НЕОМТ бузГопЕе = беезбоскОБ)ес® (5У5ТЕМ ГОМТ); 


создает дескриптор системного прифта. 


Создать дескриптор нестандартного пера можно функцией СгезфеРеп: 


ИТМСОТАРТ НРЕМ СгеакеРеп (ТМ 1пе ЕпРепзеу1е, 
ТМ 11 пи1аЕр, ТМ СОГОВВЕЕ сгСо1ог); 


Функция возвращает дескриптор пера. Параметр гпРеп&Уе определяет 
стиль рисуемых линий и может принимать следующие значения: 


Гр: РЗ_вОмр | Сплошная линия. о —_ И 
Р5_ОАЗН _Штриховая ; линия. 
а рр —. 
Р5_ от — —_ __ _Пунктирная линия. | 1 
Р5_ АЗНООТ. —__ _Штрихпунктирная ая линия . о 
'Р5_РАЗНООТЬОТ 1 Линия и: из штрихов и сдвоенных пунктиров. __ —_ —__ 
РМО. _ __ Невидимое перо. — 


Р5 _ТМ5ТОЕЕВАМЕ. Сплошная линия. При рисовании линий, ограниченных \ 
‘прямоугольником, линия при любой птирине пера распо- 
| ‚ лагается полностью внутри. прямоугольной области. 


Стили Р5_ОАЗН, Р$_ООТ, Р5_БАЗНООТ и Р5_РАЗНООТООТ не ис- 
пользуются при ширине пера превышающей 1. 

Параметры п\14 и сгСоог функции СгежеРеп определяют ширину 
и цвет линии. 

Например, оператор 


НРЕМ ВеРеп = СгеасеРеп (Р$_5ОТТО, 1, с]1Веа); 
создает дескриптор сплошного красного пера с единичной шириной. 
Имеется также функция СгежеРеп ш41тес&, создающая дескриптор пера, 


описание которого дается структурой типа ГОСРЕМ. Поля этой структуры за- 
дают те же величины, что и параметры функции СгежеРеп. 


Создать дескриптор нестандартной кисти можно функцией СгежфеВги$В- 
п 1гесё: 


ИТМСРТАРТ НВКОЗН СгеабеВхга$ВТпа1гес® (ТМ СОМ5Т ТОСВКО$Н * 1р1Ь); 


Единственный параметр функции является указателем на структуру типа 
ГОСВКОЗН. Ее полное описание дается в гл. 8 в разделе, посвященном функ- 
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ции СгежеВги Та гес+. Структура имеет поля Зе — стиль, №Соог — 
цвет, НаёеВ — заполнение. Поле №54Яе может принимать, в частности, зна- 
чения В5_ЗОГТШО — сплошная заливка, В _НАТСНЕО — кисть со штрихов- 
кой, В5_НОШ.ОМ или В5_МОШ, — пустая. 

Поле №Со]1ог структуры ГОСВВОЗН определяет цвет кисти. 

Поле №НафеВ игнорируется для сплошной или пустой кисти. А для кисти 
со штриховкой поле ШНаёеВ указывает стиль штриховки. Например, 
Н$_ВОТАСОМАГ — косая штриховка снизу вверх. 

Следующие операторы создают дескриптор сплошной красной кисти: 

ТОСВВО$Н 1р15; 

1р16.165Еу1е = В5 $5О0ЬТО; 


1р16.16Со1ох = с1Веа; 
НВКОЗН ВеЧаВгазб = СгеафеВгазВТпа1гесе (&1р1Ь)); 


‘А если в приведенном коде изменить значение поля №5$е и задать 
Нав следующим образом: 


1р1ь.155%у1е = В$ НАТСНЕО; 
1р1ь.1ЪЬНаесв = Н$ ВОТАСОМАЬ; 


то кисть будет заполнять поверхности диагональной красной штриховкой. 
Помимо рассмотренной функции СгезеВги$ В т@1тгесй для создания не- 
стандартных кистей, имеются функции СгежеЗоПаВгиз в, СгеафеНа&еВВги$ В 
и СгежфеРаНегипВгизв. Их описание вы найдете в гл. 8. 
Имеется ряд функций, позволяющих выводить символьные строки на кон- 
текст устройства: ОгамТех&, ОгамТех{Ех, Ех Гех{Оц&, ТаБедТехОцф, Тех{- 
Оп, СгауЗгште. Простейшая из них Тех{Оцё: 


МТМСОТАРТ ВООЪ Тех Ой (ТМ НОС Вас, ТМ 1пЕ пхХ5ЗвагкЕ, 
ТМ 106 пуУ5бахге, ТМ ЬРСИЗТВ 1рбег1па, 
ТМ 106 сЬ5ег1па); 


Параметры пХ5фагё и пУ5фагф указывают координаты начала строки, 
]р54г11е — строка текста, е6$гтя — число символов в строке. Например, 
следующие операторы обеспечивают вывод строки текста: 


Ап$156к1па 5 = "Это текст"; 
ТехеОчф (Н, 10, 10, $.с 56г(), $5.1епаЕВ()); 


Функция Тех{Оцё не очень удобна даже при выводе однострочных тек- 
стов, поскольку при желании выровнять текст по середине какой-то области 
приходится вычислять значение параметра пХ5$фагё. Например, горизонталь- 
ное выравнивание текста по середине компонента Птабе]1, на контекст канвы 
которого выводится строка, обеспечивается оператором: 


ТехеО<е (Н, (Тмадче1->итаеи - Тпаде1->Сапуаз->Техеизаеь (5)) / 2, 
О, 5.с 56г(), 5.Ъепаев()); 


Другим недостатком функции Тех{Оий является невозможность вывода 
многострочных текстов. В выводимую строку нельзя включить символы пере-_ 
хода на новую строку “\п”. 

Значительно больше возможностей предоставляет функция ОгамТех6: 


10Е ОгамТех® (ТМ НОС ПОС, ТМ ТРСМЗТКВ 1р5Еглпа, 
ТМ 10пЕ пСоопЕ, ТМ ООТ .РВЕСТ 1рВесф, 
ТМ ОТМТ оаРогма®); 


Параметры 1рЭитше и пСопп{ указывают строку текста и число символов 
в ней. Параметр 1рВесф указывает на структуру типа ТВес&, определяющую 
прямоугольную область, в которую вписывается текст. Параметр иРогтай оп- 
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ределяет флаги форматирования текста. Он может содержать следующие фла- 
ги, объединяемые операцией ИЛИ: 


ОТ ВОТТОМ Выравнивает текст по вертикали по низу заданной + об- 
ласти. Работает только в комбинации с флагом 
ОТ_ЭПМСГЕЫМЕ. 


ОТ_САЕГСВЕСТ При задании этого флага функция не отображает текст, . 
а только. подсчитывает ширину и высоту области, необ- , 


ходимой для отображения текста. Вычисленные разме- | 
| ры области заносятся в структуру 1рВес&, а высота воз- | 


вращается как результат вызова фыункции. Для много-. 


строчных текстов используется ширина области, ука- — 
занная в [рВесф, а ее высота рассчитывается так, чтобы | 
в области поместилась (без запаса) последняя строка. 
Для однострочного текста ширина изменяется так, что- 
бы в ней без запаса уместились все символы. | 
ИИ 

| 


ОТ СЕМТЕК Выравнивает текст по горизонтали по центру заданной 
области. 


НИ _ ОИ 


БТ_ЕБТТСОМТКВОГ Осуществляет отображение в стиле многострочных 
окон редактирования. 


ОТ_ЕМО_ЕГЫР1$ Используется вместе с флагом от _МОРТЕУ УТЕС. 
Если текст строки не помещается по ширине в отведен- ' 
ную область, то часть строки в ее конце заменяется | 
многоточием. Изменяется не только отображение, но 
и сама исходная строка. 


|ОТ_ЕХРАМОТАВ$ Разрешает использовать в строке символы : табуляции 
"\$". По умолчанию табуляция осуществляется на 

8 символов. Но это может быть изменено флагом 
ОТ_ТАВЗТОР. 


| 

ООО — - - ще ен --.- | 
от _ЕХТЕВМАТ- Включает верхнюю точку символов в высоту строки. 
ГЕАОТХС О ПВ 
ОТ ТЕЕТ | Выравнивает текст влево. 
д - . —_ 


ОТ_МОРТЕУЗТЕИМ С |Разрешает изменять строку флагами. от ЕМО_ ЕГЛР- | 
` 515 и ОТ РАТН_ЕГГРЬЗТ$. 


м он иво, 


‚От МОСЫР Отображает текст, не усекая его, если он оказывается | 
шире выделенной области, т.е. расширяет в этом слу- 
чае область отображения. В любых случаях ускоряет 
отображение текста, так как исключает операции оцен- | 
ки его длины. . 


| 


| 
| : 
| 
| 


| ООО ВОИ 
‚| ОТ_МОРВЕЕТХ — Отображает символ &, если он встречается в строке. В‹ от-' 
| сутствие данного флага символ & не отображается, а вы- | 
| зывает подчеркивание следующего символа, только сдво- ' 


| енные символы _&& отображаются как один символ &. 


4 
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‚рт РАТН ЕлР&$ | Используется вместе с . ‚флагом ОТ_ МООТЕУ$ ТЕМ 
для отображения строк, содержащих длинный путь | 
`к файлу. Если текст строки, содержащей символы 

| | "\\”, не помещается по ширине в отведенную область, 

то часть строки перед последними символами "\\" за- 

‚меняется многоточием. Таким образом, урезается путь, | 

‘но имя файла сохраняется. Изменяется не только ото- 

бражение, но и сама исходная строка. 


р 
НЯ МД 


| 

ОТ В СНТ _| Выравнивает текст вправо. 

|н—-— Ъ$— —— ———- 
| ОТ_ТАВЗТОР | Устанавливает число символов сдвига, соответствующе- 


| го символам табуляции "\$"” (по умолчанию 8). Число 


от ЭПМСГЕЫМЕ _ | Отображает текст в одной строке.. _ 
| _ записывается в битах 8-15 параметра иЕогта%$. 
— м—трщ 


ОТ_ТОР _ | 'Выравнивает текст по вертикали по верху заданной об- 
ласти. Работает только в комбинации с флагом 

- ОТ_1ТМСТЕШМЕ. 
| 
| 


ОТ_ УСЕМТЕВ '`Выравнивает текст по вертикали по центру заданной 
области. Работает только в комбинации с флагом 
—__ | РТ_ ЭПМУСЬГЕЫМЕ. 


о щ ЕЕ НИИ 


'рт_ МУОВОВВЕАК ` Осуществляет аз автоматический перенос по словам, если | 


| 
| строка превышает заданную ширину области. Символы | 


| Пережода на новую строку "\п” также действуют. _ 


Поскольку флаг ОТ ТАВЗТОР предполагает задание в битах 8—15 числа 
символов, приходящихся на табуляцию, этот флаг не может применяться со- 
вместно с флагами РТ_САЕГСВЕСТ, ОТ_ЕХТЕВМАЕСГЕАОИМ С, ОТ_ТУТЕКБ- 
МАГ, ОТ МОСЫШР и ОТ МОРВЕМХ, использующими те же биты. 

Рассмотрим примеры. Следующий оператор обеспечивает отображение 
текста в центре (по горизонтали) области В с автоматическим переносом 
строк, если они не помещаются по ширине области: 


РгамТехе (Н, $.с з6к(), 5.ЪепаЕВ(), &В, РТ СЕМТЕВ | РТ МОВРОВВЕАК); 


Если строка не длинная, а в В качестве координат х задана вся ширина кон- 
текста, строка будет центрирована по горизонтали. А приведенный ниже опе- 
ратор отобразит ее в центре заданной области и по горизонтали, и по вертика- 
ли: 


`РгамТехе (Н, $5.с_$&г(), 5.Бепаев(), &8, 
РТ _5ТМСЬЕБТМЕ | ОТ УСЕМТЕВ | ОТ СЕМТЕВ); 


Следующий оператор выравнивает текст влево и разрешает использовать 
символы табуляции: 


ОгамТех® (Н, 5.с 5%г(), $.Бераеь (), &В, 
РТ_ТЕЕТ | ОТ ЕХРАМОТАВ$ | ОТ МОВБРОВВЕАК); 


Если текст длинный, он автоматически разбивается на строки. А если в тексте 
встречаются символы "\п\+", то они обеспечивают переход на новую строку 
с табуляцией. Таким образом, получаются красные строки в начале абзацев. 
Отступ в красной строке равен восьми символам. Если это много, можно уме- 
ньшить отступ, например, до трех символов, изменив оператор следующим об- 
разом: 
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ОгамТехе (Н, 5.с $%г(), 5.Ъепаев(), &вВ, 
РТ_ТЕЕТ | РТ ЕХРАМРТАВ$ | (РТ _ТАВЗТОР | 0х300) | 
РТ_МОВРВВЕАК); 


Мы рассмотрели ранее функции де ЗфюосКОЦес+, СгежеРеп, Сгезж{еВги$В- 
1 1гесф, которые создают дескрипторы кисти, пера, шрифта. Эти дескрипто- 
ры могут использоваться в рассмотренных функциях вывода на контекст изо- 
бражений и текстов. Чтобы использовать созданный дескриптор, его надо на- 
значить для контекста данного устройства. Это осуществляется функцией 
ЗеесОЦес(: 


ИТМСОТАРТ НСОТОВУ ИМТМАРТ 5$е1ес®ОБ)ес® (ТМ НОС Бас, ТМ НСОТОВУ Баа1оЬ)); 


Параметр В4е — дескриптор контекста, а параметр пЕЧтоь3 — дескриптор кис- 
ти или пера. | 
Если продолжить приведенные ранее примеры, то следующие операторы 
бе1есеОЮ)ес® (Н, НМОТ); 


5е1есеОБ]ес® (Н, ВеаРеп); 
5е1есеОБ]ес® (Н, $Зу$Еоп®); 


зададут контексту, указанному дескриптором Н, определенные ранее пустую 

палитру, красное перо и системный шрифт. | 
Задание кисти, пера, шрифта для контекста можно объединить с создани- 

ем их дескрипторов, не вводя промежуточных переменных. Например: 
5е1есОю)ес® (Н, сбеё5осКкОБ)ес® (МОЬЬ ВВОЗН)); 


5е1есеОЮ)ес® (Н, Сгеа®еРеп (РЗ_5ОТТО, 1, с1Веа)); 
зе1есЕОю)есе(Н, Сее5осКкОБ)ес® (5УЗТЕМ ЕОМТ)); 


5.5.2 Преобразование координат контекста устройства 


Иногда в приложениях требуется преобразовывать координаты изображе- 
ний и надписей. Например, поворачивать под заданным углом, осуществлять 
зеркальное отображение и т.п. При необходимости трансформировать коорди- 
наты в АРТ \/1ш4омз$ используется описанное в разд. 5.5.1 понятие дескрипто- 
ра контекста устройства. 

Трансформация координат контекста осуществляется функцией АРТ У/ш- 
домз Зе Уог1АТгап$Гогт: 


ИТМСОТАРТ ВООГ ее Мог1АТкапзЕокм (ТМ НОС Вас, ТМ СОМЗТ ХРОВМ *); 


Аргумент В4с является дескриптором контекста того устройства, коорди- 
наты которого подвергаются трансформации. Второй аргумент функции опре- 
деляет адрес структуры типа ХЕОВМ, поля которой задают элементы матри- 
цы линейного преобразования координат. Эта структура объявлена следую- 
щим образом: 


суреаеЕ зегоасе ФадхРОВМ 

{ 
ЕТОАТ ем11; 
ЕТОАТ ем12; 
ЕЪОАТ ем21; 
ЕЪОАТ ем22; 
ЕЪОАТ ерх; 
ЕБОАТ еру; 

} ХРОБМ, *РХЕРОВМ, РАВ *ГРХЕОВМ; 
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Преобразование исходных координат Х и У в координаты Х'и У' опреде- 
ляется соотношениями: 


х' Х ‘°ем11 + У °ем21 + е0х, 
У" = Х ‘°ем12 + У‘ емМ22 + еру, 


Например, если надо просто сдвинуть изображение на еОх по оси Х и на 
е)у по оси У, следует в структуре ХЕОВМ задать еМ11 = еМ21 = еМ12 = еМмМ22 
= 0, и установить требуемые значения еОх и еъу. 

Если при всех описанных далее преобразованиях надо сохранить непод- 
вижной точку с координатами (ХО, У0), например, центр изображения, то зна- 
чения еОх и еОу надо определять соотношениями: 


ерх = ХО - ХО * емМ11 - У0 * ем21; 
еру = У0 - ХО ` еМмМ12 - \0 * ем22; 


Зеркальное отображение относительно оси с Х = ХО при этом задается со- 
отношениями еМ12 = еМ21 = 0, еМ11 = -1, еМ22 = 1. Если элементы матрицы 
задать соотношениями еМ12 = еМ21 = 0, еМ11 = 1, ем22 = -1, то получится 
зеркальное отображение относительно оси с У = У0, т.е. изображение перевер- 
нется. Если задать еМ11 = еМ22 = М, еМ12 = еМ21 = 0, то изображение растя- 
нется (при М > 1) или уменьшится (при М < 1) в М раз. 

Поворот изображения на угол А осуществляется при задании еМ11 
еМ22 = соз(А), еМ12 = з11(А), еМ21 = -—з11(А). При необходимости осущест- 
вить более сложные преобразования, связанные с одновременным поворотом, 
сдвигом и изменением размера, вы можете сами по приведенным соотношени- 
ям вывести нужные соотношения. 


Перед вызовом функции Зе \УМог!АТгап$огт надо предварительно вы- 
звать функцию 5еСгарШс$Моде, задающую соответствующий графический 
режим: 


ИТМСОТАРТ 110% бесСсгарй1с$Моае (ТМ НОС Пас, ТМ 1пЕ 1Моае); 


Параметр В4с имеет тот же смысл, что иа функции Зе Уог1АТгап$Рогт, 
а параметр 1Мо4е может принимать одно из двух значений: @ОМ_СОМРА- 
ТТВЕЕ — режим, совместимый с У\/ш4о\мз 3.1, или СМ_АБУАМСЕО — режим 
более современных версий У/114о\з. По умолчанию в \!11140\$ устанавливает- 
ся режим @М_СОМРАТТВТЕЕ, в котором функция Зе \Уог14Тгап$Ёогт не ра- 
ботает. Так что перед вызовом этой функции её Мог!9Тгап$Гогт надо устано- 
вить функцией Зе СгарЬ1е5Мо4де режим СМ_АГУАМСЕР. 


Описанная трансформация координат контекста устройства с помощью 
функции Зе \ог!АТгап$огт возможна только начиная с \!114о\з МТ/2000/ 
ХР. В У шаомз 95/98 такая функция отсутствует. Для этих версий У/ш94о\з, 
если возникает задача трансформировать, например, битовую матрицу, это 
приходится делать по пикселам, изменяя их координаты в соответствии с за- 
данной трансформацией. В рассмотренном далее примере показаны подобные 
алгоритмы основных трансформаций. Но такая трансформация — это процесс, 
очень медленный по сравнению с трансформацией координат функцией 5е- 
Уог1АТгап$огт. Так что оперативную трансформацию проводить невозмож- 
но. Если все-таки трансформация нужна, имеет смысл заранее или в фоновом 
режиме подготовить набор трансформированных изображений, а потом в нуж- 
ные моменты отображать то или иное из них. 


5.5 Основы 601, преобразование координат изображений 373 


5.5.3 Пример преобразования координат 


Рассмотрим тестовый пример, поясняющий все описанное в предыдущих разде- 
_ лах. Этот пример, вид которого во время выполнения показан на рис. 5.16, имеется 
на приложенном к книге диске в каталоге Сгарй в проекте ТгапзИтаздез. Прило- 
жение демонстрирует основные варианты трансформации изображений: поворот 
под углом, заданным пользователем (изображения в правых окнах формы), изме- 
нение масштаба по коэффициенту, заданному пользователем, горизонтальное 
и вертикальное зеркальные отражения (если вы вглядитесь в рис. 5.16, то увидите, 
что левое изображение зеркально по отношению к правым изображениям). 

Одновременно демонстрируются различные варианты получения транс- 
формированных изображений. Левое верхнее окно на рис. 5.16 представляет 
собой компонент Ппайе1, трансформация в котором осуществляется по пиксе- 
лам. Это наименее эффективный вариант, который требует на преобразование 
изображения значительного времени. К, сожалению, это единственный вари- 
ант, работающий в \Иш4о\з 9.х. Поэтому он введен в приложение. Второй ва- 
риант (справа вверху на рис. 5.16) — использование функции 5е\У\он9- 
Тгап$?огт для преобразования координат канвы компонента Гтабе2. Это са- 
мый простой и эффективный способ преобразования изображений. Третий ва- 
риант (справа внизу на рис. 5.16) демонстрирует получение и трансформацию 
изображений на панели Рапе!1. По эффективности этот вариант аналогичен 
предыдущему. Ноу него есть крупный недостаток: если окно приложения ока- 
жется перекрытым другим окном, изображение или его часть сотрется. У па- 
нели нет события ОпРашф, обработчик которого позволил бы в подобных слу- 
чаях перерисовывать изображение. Событием ОпРашф формы тоже нельзя 
воспользоваться, так оно происходит до того, как перерисовываются компо- 
ненты, расположенные на форме. В тестовом приложении этот недостаток уст- 
ранен заданием у формы свойств Вогдег5 уе = 5$501а10о5 и Еогт5 У = 
554ауОпТор. Тем самым исключается возможность стирания изображения. 
Но подобная сложность, конечно, является недостатком данного варианта ото- 
бражения и трансформации изображений. 


Рис. 5.16 о Х 
Приложение, демонстрирующее 
трансформацию изображений 


Вариант 3 (бемойаТ гаи отт с панелью) 


симметрия горизонтальная 
симметрия вертикальная 
масштабирование 
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Размеры окон, отображающих изображения всех трех вариантов, выбра- 
ны одинаковыми, что используется в приведенном далее коде. 

Для получения желательной трансформации изображения пользователь 
должен выбрать соответствующую строку в списке Преобразование (Т1$Вох1) 
в левом нижнем углу формы, задать значение угла поворота в окне Угол поворота 
(ЕЧКТ), если осуществляется поворот, или задать масштабный коэффициент 
в другом окне (Е91{2), если изменяется масштаб. После этого пользователь дол- 
жен нажать кнопку того варианта, который он хочет посмотреть. Если пользо- 
ватель выберет в списке 11${Вох1 первую строку, то без нажатия каких-либо 
кнопок изображения во всех окнах приложения примут свой начальный вид. 

Ниже приведен код этого тестового приложения. 

#ргадта гезопсгсе "Ттаде1.ВЕ5" 

ТЕоги1 *ЁРогм1; 

СгарЮ1сз$: :ТВ1Емар *5гсВ1емар; 

ТВесе В; 


Е1оаф апа1е; 
ХРГОВМ хЕогы; 


10 х0, у0; 

аоцЬ1е з, с; 

соп$з® Ап$156г1па 5 = "Портрет"; 

// дескрипторы контекста и перьев для Рапе11 
НОС Н; 


НРЕМ В1асКРеп, ВеаРеп; 


01а _ Еаз&са11 ТГогш1::РогпСгеаее (ТОБ]есе *5епаег) 
| 

Н = сефброс (Рапе11->Напа1е); 

В1аскРеп = Сбеф5$хоскОБ)ес+® (ВЪАСК_РЕМ) ; 

Ве4Реп = СгеафеРеп (РЗ _ЗОЪТО, 1, с1Веа); 

ЗгсВ1Етар=пем СгарП1сз: : ТВ1емар; 

5гсВ1Етмар->НапЧ1е = Гоа@аВ1 мар (НТпзапсе, "ТМАСЕ"); 

Тмаче1->Сапуаз->Огам ( (Тмаде1->И1аЕн - ЗксВуетар->М1аеь) / 2, 

(1Тпаде1->Не1аюе - 5хсВ16тар->Не1а0е) / 2, 5хксВ1емар); 

ЗгсВ1етар->Незайе *= загф (2); 

ЗгсВ1Емар->Итаей *= заг® (2); 

В = Вес ( (Тмаде1->М1ар - 5гсВ1тар->Илаеь) / д, 
(Тмаче1->Не191* - 5хсВ16мар->Не1ав®) / 2, 
(Тваде1->И1аЕв + бгсВ1Емар->М1аей) / д, 
(Тпадче1->Не1запЕ + 5гсВ1Емар->Не1а9Н®) / 2); 

5гсВ1тар->Сапуаз->СоруВес® (Вес+ (0, 0, 5гсВ1Етар->М1ае, 

ЗгсВ1 Е мар->Не1ап®), Тмаде1->Сапуаз, К); 
.1$ЕВох1->ТЕешТпаех = 0; 
} 


у01А _ Еаз®са11 ТЕГогм1: : Когтрезегоу (ТОБ]ес* *5епаег) 
| 

Че1ефсе $гсВ1емар; 

Ке1еазерСс (Рапе11->Напа1е, Н); 


у01Аа _ Еа$&са11 ТЕГогм1: : Ви оп1С11сК (ТОБ)]есе *5епаег) 
{ 
// вариант без функций АРТ И1п4ои$ 
1Е (Гоги1->11$ЕВох1->ТепшТпаех ==0) гебагп; 
5сгееп->Сагзог = сгНочгС1а$$; 
апч1е = ЗЕгТоР1оа® (Гоги1->Еа1%1->Тех®) * МРТ / 180.; 
Чопр1е $ = $11 (апа1е); 
аочЬ1е с = соз (апа1е); 
‚ аоцЬ1е М = 1. / ЗЕЕТоЕ1оа® (Еа1*2->Тех®); 


# 
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10 5гсВ1етарх, ЗхгсВ1%тару; 
хО = 5гсВ16тар->И1аеь / 2.; 
УО = 5гсВ1мар->Нелайе / 2.; | 
// создание вспомогательного объекта БезЕВлЕтар 
Сгарр1с$: :ТВ1Емар *Без®В16тар = пем Сгарр1сз: :ТВ1 пар; 
_Рез&В16мар->НезаНе = 5$гсВ1®тар->Не1чЬе; | 
Рез*В1пар->И1аЕП = 5ЗгсВ16тмар->И1аеь; 
// запись пикселов БезЕВ1Етар с учетом преобразования 
Рог (116 х = 0; х < ПБезЕВ1етар->И1аеь; х++) 
{ 
Бог (1106 у = 0; у < ПезЕВ1тар->Нелаве; у++) 
{ - . 
$и1Еср (.1$ЕВох1->Т$ешГТпаех) 
{ 
// поворот 
сазе 1: | 
ЗгсВ1тарх (176) ((х-х0) *с+ (у-у0) *5) +х0; 
ЗгсВ1Етару = (116) ((у-у0) *с- (х-х0) *з) +у0; 
1Е ((ЗхсВ1ещарх >= 0) && (5гсВ1®марх < ПезеВ1Етар->И1афев) 
&& (ЗгсВ1Емару >= 0) 
&& (ЗгсВ1Емару < РезЕВ1$тар->Не191е)) 
РезЕВ1+пар->Сапуаз->Р1хе1$[х] [у] = 
ЗгсВ1 мар->Сапуаз->Р1хе1$ [5гсВ1Емарх] [5гсВ1емару]; 


е1зе Пез&В1&тар->Сапуаз->Р1хе13[х] [у] = с1\ ще; 
‚ ргеак; 
// симметрия относительно вертикальной оси 
сазе 2: 


Рез5<В1Ептар->Сапуаз->Р1хе1$[х] [у] = 
ЗгсВ1мар->Сапуаз->Р1хе1$ [РезВ1Емар->Мтаев - х - 1] [у]; 
Ьгеак; | | 
// симметрия относительно горизонтальной оси 
сазе 3: 
Рез(В1Емар->Сапуа$->Р1хе1$[х] [у] = 
ЗгсВ1& мар->Сапуа$->Р1хе1$[х] [РезЕВ1Емар->Незайе - у-1]; 


Бгеак; 
‚ // изменение масштаба 
сазе 4: 
бхсВ1Емарх = (х-х0) * М + хО0; 
ЗгсВ1етару = (у-у0) * М + 90; | 


1Е((5гсВ1етарх >= 0). && (ЗгсВ1Етарх < ПезЕВ16тар->М1аен) 
&& (ЗгсВ1ещару >= 0) && 
(ЗусВ1Емару < ПБезЕВ1Етар->Нетав®)) 
РезЕВ1тар->Сапуаз->Р1хе1$[х] [у] = 
5усВ16стар->Сапуаз->Р1хе1$ [бухсВ1&марх] [5$гсВ1етару]; 
е1зе Рез*В1Етар->Сапуа$->Р1хе1$[х] [у] = с1\1%е; 
Ьгеак; 
} 
} 
} 
Тпаде1->Сапуа$->Е111Вес® (В); 
Тпаде1->Сапуаз->Огам (В.ЪеЁе, В.Тор, БезеВ1емар); 
Ае1еёе ПРез&В1%мар; 
бсгееп->Сигзог = .сгреЁац1*; 


\у01А РогмХЕогм (уота) . 
{ 
$м1Еср (ГКогпи1->1$6Вох1->Т$ешТпаех) 
{ 
сазе 1: 
апа1е = ЗЕгТоЕ1оа& (ЕГоги1->Еа1*1->Техё) * МРТ / 180.; 
$ = $511 (апа1е); 
С = с0$ (апа1е); 
хЕогм.емМ11 = хЕогм.ем22 = с; 
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хЕогм.еМмМ12 = $3; 
хЕогм.еМм21 = -$; 
Бгеак; 

сазе 2: 
хЕоги.еМ11 = -1.0; 


хЕоги.емМ12 = хЕоги.емМ21 
хЕоги.ем22 = 1.0; 
Бгеак; 
сазе 3: | 
хЕогм.ем11 = 1.0; 
хЕог.еМмМ12 = хЕогм.еМм21 = О0.; 
хЕогм.ем22 = -1.0; 
Бгеак; 
сазе 4: 
хЕоги.ем11 = хЕогм.еМм22 = ЗЕгТоЕ1оа* (Еогт1->Е 91 2->Тех+); 
хЕог.емМ12 = хЕогм.ем21 =0.; 
Ьгеак; 
} 
хЕогм.ерх 
хЕогш.еру 


х0 - хО * хЕогм.емМ11 - у0 * хЕоги.ем21; 
У0 - х0 * хЕоги.еМ12 - у0 * хЕогт.еМмМ22;. 


// создание временного объекта ПезЕВ1Етар 
Сгарр1с$: :ТВ16тар *ПезЕВ1Етар=пем СгарП1сз: : ТВ1Емар; 
ПезЕВ1Етар->Незан*=5гсВ16тар->Не1ав+; 
Рез<В1$тар->И1ЧЕ=5гсВ1*тар->Иаей; 
// преобразование координат ПРезЕВ1Етар 
хО = ЗгсВ1Смар->Илаен / 2.; 
УО = 5ЗгсВ1мар->Неларе / 2.; 
РогшХЕоги (); 
зеЕбсгарп1сзМоде (рез{В1Епар->Сапуаз->Напа1е, СМ АРУАМСЕЬ); 
Зее\ог1АТгапзЕоги (ВезеВ1птар->Сапуаз->Напа]1е, &хЕогм) ; 
// копирование из 5гсВ1Етар в БезЕВ1Етар 
// (картинка трансформируется) 
В1%В1% (РезЕВ1мар->Сапуаз->Напа1е, 0, 0, ПезЕВ1*мар->И1ает, 
РезЕВ1Емар->Не191®, 5гсВ1&пар->Сапуа$->Напа1е, 
О, 0, $ВССОРУ); 
// вывод текста 
5е1есеОБ]ес® (Вез&В1Етмар->Сапуа$->Напа1е, 
Сее5оскОЮ)ес® (5У5ТЕМ ЕОМТ)); 
ТехЕОц® (Рез(В16тар->Сапуаз->Напа1е, 
Рез&В1мар->И1А - БезЕВ1емар->Сапуаз->Техемтаен ($)) / 2, 
О, 5.с 3з%г(), 5.БепаевВ ()); 
// восстановление координат РезЕВ1Етар 
хЕоги.ем1Т = хЕоги.еМмМ22 = 1; 
хЕогм.еМ12 = хЕогм.еМ21 = хЕоги.ерх = хЕогм.еПу = 0; 
зеЕИог]1 АТгапз Гоги (РезВ1Етар->Сапуаз->Напа]1е, &хЁогм); 
// отображение изображения из ПезЕВ1Етар в Ттаде2 
Тпадче2->Сапуаз->Огам (В.еЕе, В.Тор, БезЕВ1тар); 
Че1ефе ПезЕВ1*%пар; | 


// очистка контекста 
В1%В16 (Н, Рапе11->С11еп Весе.ЪеЕЕ, Рапе11->С11епеВес®.Тор, 
Рапе11->С11епЕВесе .Итаер (), 
Рапе11->С11епЕВесе .Нелзане(), №11, 0, 0, МНТТЕМЕ$5$); 
х0 Рапе11->И1аев / 2.; 
УО0 = Рапе11->Незайе /2.; 
ЕРКогшХЕогм (); 
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ЗесСбгарВ1с5Моае (Н, СМ АРУАМСЕЬ); 
беЕеМог1АТгапзЕогм (Н, &хЕогм) ; 
// перенос на контекст изображения 
В1ЕВ1е(Н, В.ТеЕЕ, К.Тор, В.М1аерп (), 
К.Не1арфе(), эзгсВ1тар->Сапуаз->Напа1е, 0, 0, $УВССОРУ); 


// вывод текста 
Зе1есОБ)]есе (Н, Сбее5коскОБ)ес® (5У5ТЕМ_ЕОМТ)); 
ТехеОче (Н 
(Рапе11->И1аЕВ - 5хсВ1&мар->Сапуаз->ТехеИ1аев ($)) / 2, 
ЗгсВ1тар->Сапуаз->ТехеНелайе (5), $5.с $зЕк(), 
5.БепаеЕР ()); 
// задание пустой ‘кисти и черного пера 
5е1есеОЮ)ес® (Н, Сее5оскОр)есе (МОТЬ ВВОЗН)); 
бе1есеОБ]ес® (Н, В1асКРеп); 
// изображение фигур 
Вескапа1е (Н, ВК.ЪеЕф, В.Тор, В.ВКлапе, В.Воебом); 
Агс (Н, 70, 50, Рапе11->Итаев-70, Рапе11->Неларе-50, 0, 0, 0, 0); 
// задание красного пера 
бе1есеОБ]ес® (Н, ВеаРеп); 
// рисование линий 
МоуеТоЕх (Н, 0, 0, №11); 
Т1пеТо (Н, Рапе11->\1аев-1, 0); 
Т1пеТо (Н, Рапе11->М1аЕв-1, Рапе11->Не1ар®-1); 
Т1пеТо(Н, 0, Рапе11->Незае-1); 
ТалреТо(н, 0, 0); 


// восстановление нормального режима отображения 
хЕогм.еМ11 = хЕоги.еМ22 = 1.; 

хЕогм.еМ12 = хЕогм.еМ21 = хЕогм.ерх = хЕогм.еру = О0.; 
беЕ\йог1ЯТгапт$Еогм (Н, &хЕогм) ; 


\01А __Еаз6са11 ТГогм1: :1$%Вох1С11сКк (ТОБ)]есЕ *5епаекг) 
{ 
1Е (115ЕВох1->ТеепТпаех == 0) 


{ 
Т1пег1->Епаб1еа = Еа15е; 


Тпаче1->Сапуаз->Огам ( (Тмаде1->М1аеВ - 5хсВ1мар->ИзаеЬ) / 2, 
(Ттаче1->Незаве - $гсВ1©мар->Незане) / 2, 
5гсвВ1емар); 


Ва 6оп2С11сК (бепаег); 
Ви боп3С11сК (бепаег); 
} 

} 

Прокомментируем приведенный код. Директива ргата гезоигсе подклю- 
чает к модулю файл ресурсов (см. разд. 2.5), в котором содержится использо- 
ванное в приложении изображение. Функция ЕогтСгеаф{е является обработчи- 
ком события ОпСгеж{е формы. Ее первый оператор создает дескриптор контек- 
ста панели Рапе1 и запоминает его в глобальной переменной Н. Два следую- 
щих оператора создают и запоминают в глобальных переменных дескрипторы 
черного и красного пера, которые будут использоваться при рисовании на па- 
нели Рапе!1. Затем создается глобальный объект ЭгеВ тар, в который загру- 
жается из ресурса изображение с именем ТМАСЕ. Это изображение отобража- 
ется методом канвы Огам в середине компонента Ппахе1. Затем размеры объ- 
екта ЭгеВЁё тар увеличиваются в `/2 раз. Это делается из следующих соображе- 
ний. Изображение, хранящееся в компоненте, квадратное. При поворотах во- 
круг его центра углы изображения будут перемещаться по окружности с диа- 
метром в /2 2 раз большем длины стороны. Так что перерисовывать надо прямо- 


угольную область с высотой и шириной в /2 2 раз большими первоначальных. 
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Поэтому увеличиваются размеры ЭгеВЁ тар и в глобальную переменную В, за- 
носятся функцией Вес& координаты перерисовываемой области, центр кото- 
рой совпадает с центром компонента Ппабе1. Затем эта область Ппабе1 с уже 
занесенным в него изображением копируется методом СоруКес& обратно в объ- 
ект ЭгсВЁтар. Последний оператор задает значение Цешш4ех списка [1$%- 
Вох1, выделяя в списке первую строку. | 

Функция ЕогтОе$& гоу является обработчиком события ОпОе$фгоу формы. 
В ней очищается память от объекта эгеВтар и освобождается дескриптор Н 
контекста панели Рапе1. 

Функция Вавоп ЕСНсК является обработчиком щелчка на кнопке, обеспе- 
чивающей первый вариант преобразования координат. Если в списке 1.15 Вох1 
выделена первая строка, то никаких преобразований не производится, и рабо- 
та функции завершается. Это связано с тем, что, как будет видно далее, при 
выделении первой строки во все окна автоматически заносятся изображения 
в их исходном виде, так что никаких дополнительных операций не требуется. 
Далее в функции ВиНоп1СПсЕ устанавливается вид курсора сгНопгО1]а$$, так 
как преобразование координат — процесс длительный, и желательно чтобы 
в течение этого времени пользователь видел «песочные часы». Затем вычисля-. 
ется угол поворота ап е в радианах по заданному пользователем в окне ЕЯ 1 
значению этого угла в градусах. Вычисляются и запоминаются в локальных 
переменных $ и © соответственно синус и косинус угла поворота. Все эти опера- 
ции с углом нужны, если пользователь в качестве вида преобразования задал 
поворот изображения. Вычисляется также величина М обратная заданному 
пользователем в окне ЕЯ? масштабному коэффициенту. Это потребуется, 
если пользователь задал изменение масштаба. Объявляются вспомогательные 
локальные переменные ЗгеВИитарх и ЭгеВ тару, которые используются при 
вычислениях координат пикселов. Создается временный графический объект 
Пез{ВИтар, в который будут записываться пикселы преобразованного изобра- 
жения. Его размеры делаются равными размерам объекта ЭгеВ Итар, содер- 
жащего исходное изображение. 

Далее начинаются вложенные циклы, перебирающие все пикселы транс- 
формированного изображения Оез{ВИтар. Учтите, что циклы надо строить 
именно по тому объекту, в который переносятся пикселы, а не по исходному 
изображению. Иначе в результате преобразования координат в результирую- 
щем изображении могут появиться пустые пикселы, что очень серьезно иска- 
зит изображение. 

Операции при переносе пикселов из ЭгеВ тар в Оез&ВЁтар зависят от 
указанного пользователем преобразования, т.е. от значения 1,15 Вох1—>Цет- 
п4дех. При повороте осей сначала вычисляются ЭгеВйтарх и ЭгсВЁтару — 
координаты в исходной системе координат, соответствующие координатам х 
и у пиксела в результирующей системе координат. Далее проверяется, лежат 
ли эти исходные координаты в пределах преобразовываемого изображения. 
` Дело в том, что при повороте они могут выходить за пределы исходной области 
изображения. В этом случае в результирующем изображении цвет пикселов 
задается белым. А если координаты х и у соответствуют пикселу исходного 
изображения, то этот пиксел копируется в позицию (х, у). 

Аналогичным образом осуществляется масштабирование изображения. 
А зеркальные отображения получаются более простыми. В этих случаях раз- 
меры исходного и результирующего изображений совпадают, и достаточно 
просто переставить соответствующим образом пикселы. | 
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По окончании циклов в Эез{ВЁтар находится преобразованное изображе- 
ние. Остается только очистить методом ЕШЖес{ область исходного изображе- 
ния на канве компонента Ппабе1 и перенести в эту область методом Огам изо- 
бражение из Ве {ВЁтар. После этого объект Вез Втар уничтожается, и тип 
курсора возвращается к значению по умолчанию. 

Функция ЕогтХогт является вспомогательной. Ее задача — рассчитать 
поля структуры хогт, на которую во втором и третьем вариантах расчета де- 
лается ссылка при вызовах функции Зе \Уог!ЧТгап$огт. Необходимые для 
пересчета соотношения были рассмотрены в разд. 5.5.2. Так что функция 
Еогт ХЁогшт вряд ли нуждается в пояснениях. 

Функция ВиНоп2СПеК является обработчиком щелчка на кнопке, соот- 
ветствующей отображению преобразованного изображения в компоненте Пта- 
хе2. Сначала в этом обработчике создается временный графический объект 
Рез{ВЁтар, в который будет заноситься преобразованное изображение. Его 
размеры делаются равными размерам объекта ЭгеВ Ётар, содержащего исход- 
ное изображение. Затем определяются координаты х0 и у0 центра изображе- 
ния и производится вызов описанной выше функции ЕогтХ#огш, заполняю- 
щей структуру хогт. Далее последовательным вызовом функций ЗеёСгар- 
61с5Моде и Зе \У/ог!14ЧТгап$огт производится преобразование координат кан- 
вы объекта Без В\тар, заданное структурой хогш. После этого функцией 
ВЦВЕИ изображение из ЭгеВЦтар копируется в Ве ВЁтар. Поскольку коор- 
динаты Оез ВЦтар изменены, изображение при этом трансформируется за- 
данным образом. После этого, чтобы показать преобразование текста, устанав- 
ливается шрифт контекста и в Ое5ВЁтар заносится функцией ТехЮОиё стро- 
ка Портрет”. | 

Затем поля структуры хогш задаются соответствующими обычной систе- 
ме координат, и новым вызовом функции Зе \ог1АТгап${огт координаты 
канвы РВез{ВЁ тар возвращаются в состояние по умолчанию. После этого изо- 
бражение из Ве ВЁтар копируется в Ппабе2 и объект Вез{ВЁйтар уничтожа- 
ется. Как видим, применение функции Зе \ог1АТгап$огт значительно упро- 
щает код. А эксперимент покажет вам, что время выполнения преобразования 
неизмеримо мало по сравнению с первым вариантом. 

Функция ВиНвЙоп3 СНеЁ является обработчиком щелчка на кнопке, соот- 
ветствующей отображению преобразованного изображения в контексте панели 
Рапе!1. Сначала функцией ВЦЫВИ с последним параметром \УНТТЕМЕЗ$ очи- 
щается контекст панели. Затем, как ив ВиНоп2СЦеЕ, производится трансфор- 
мация координат контекста панели. После этого методом ВИВИЁ на панель пе- 
реносится изображение из ЭгеВЦтар, которое оказывается трансформирован- 
ным. Дальнейшие операторы включены в код просто для того, чтобы проиллю- 
стрировать вывод текста и рисование линий и фигур на контексте устройства. 
Сначала устанавливается шрифт и в контекст заносится функцией Тех{Оц 
строка “Портрет”. После этого для контекста задается пустая кисть, черное 
перо, и рисуются прямоугольных и эллипс. Поскольку кисть пустая, закраски 
площади внутри фигур не происходит, и изображение не стирается. Затем за- 
дается красное перо и функциями МоуеТоЕх и ИтеТо рисуется прямоуголь- 
ник по периметру контекста. Поскольку координаты контекста панели по- 
прежнему трансформированы, линии и фигуры также трансформируются. По- 
следние операторы обработчика Ви_Ноп3 СЦсК восстанавливают систему коор- 
динат контекста панели. 

Функция 11$ Вох1ТСПеК является обработчиком щелчка на списке 1:1$%- 
Вох1. Основное назначение этого обработчика заключается в том, чтобы ото- 
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бразить во всех окнах нормальное изображение в случае, если в списке выде- 
лена первая строка. Это осуществляется занесением изображения из ЭгеВИ- 
тар в Ппабе]1 и вызовом уже описанных функций ВиНоп2СИсК и ВиЙвйопз- 
СПеКк. Ноу функции 11$&Вох1 СПЕК есть еще одно назначение. Хочется, чтобы 
при запуске приложения сразу во всех окнах отобразились бы изображения. 
Для компонентов Птпабе это легко можно был бы сделать, вызвав функцию 
115$ Вох1СИсК из обработчика события ОпСгеже формы или из обработчика 
ее события ОпРашё. Но для панели Рапе1 это не сработало бы, так как па- 
нель прорисовывается после всех событий при создании формы. Чтобы устра- 
нить эту неприятность, в приложение введен таймер Типег1. Его время вы- 
держки Пеегуа! задано очень маленьким — равным 10. В качестве обработ- 
чика события ОпТ!тег указана функция 11$ Вох1СПсК. Таймер срабатывает 
практически сразу после создания формы и появления на экране формы 
и обеспечивает занесение в окна изображений. А первый оператор функции 
1Г15{Вох1СПеЕ, как вы видите в приведенном коде, делает таймер в дальней- 
шем недоступным. | 

Мы рассмотрели сугубо тестовое приложение. Более реальное применение 
методов преобразования координат вы найдете в разд. 5.3.1.3. 


Работа с дисками, файлами 
и каталогами 


6.1 Операции с дисками 


6.1.1 Получение информации о логических дисках 


Список всех доступных на компьютере логических дисков можно полу- 
чить функцией Се Тог1са Шуе Ито$, объявленной в файле И7тразе.й сле- 
дующим образом: 


РМОВО СееТо91са1Рг1уе5&г1паз (ТМ ОИОВО пВиЕЕекЪепаеВ, 
ОПТ ГРЗТВ 1рВоаЕЁЕег); 


Параметр пВиегТ.епо{В определяет длину буфера 1рВиЁег, в который 
функция заносит список дисков. Функция возвращает длину буфера, которая 
нужна была бы для размещения всей информации. Если возвращенная длина 
больше пВиЁЙегГепо&, значит, список не удалось занести полностью. Если 
функция вернула 0, значит, произошла ошибка. 

Список размещается в буфере в виде строк, обозначающих корневые ката- 
логи. Например, “С:\”. Отдельные строки отделяются друг от друга нулевыми 
символами. В конец списка заносится два.нулевых символа. 

Определить тип конкретного диска можно функцией Се ОнуеТуре: 


ОТМТ сбеерг1уеТуре (ТМ БРСЗТВ 1рВоо&РаЕПМапме); 


Параметр 1рВоо Ра Маше — это корневой каталог диска в той форме, 
в которой заносит диски в список функция бе ТорлсаОтуе гт5$. Если 
]рВоо{Ра Маше = МОГГ,, подразумевается текущий диск. Функция возвра- 
щает целое число, которое может принимать следующие значения: 


Тип диска не определен 


‚0 
—_—_ — 
1 `Заданный корневой каталог отсутствует 


УЖ — НИ 


‚ РЕТУЕ_ВЕМОУАВГЕ Съемный диск — 


‚ОВБТУЕ ХЕХ —__[__ |Постоян! НН 
| РЕТУЕ_ВЕМОТЕ ‘Удаленный сетевой дик 


`РЕТУЕ_СОВОМ Диск СО-ВОМ 
| и р УД ыыМр> >= ооо 
|РЕТУЕ_ВАМП$К 


а ое а вен ве а ак 24а а. ес я 4 


Постоянный диск 


Информацию о размере диска и свободном месте на нем можно получить 
функцией Се О1$КЕгееЭрасеЕх, которая объявлена в файле И1пфазе.й следую- 
щим образом: 


ВООТ Сеср1зКЕгеебрасеёх ( 
ТМ ГРСЗТК 1рр01гесфогуМаме, 
ОЧТ РОГАВСЕ _ТМТЕСЕВ 1рЕгееВу*езАуа11аб1еТоСа11ег, 
ОЧТ РОТАКСЕ ТМТЕСЕВК 1рТоба]МимрегоЕВуеез, 
ОПТ РОТАВСЕ ТМТЕСЕК 1рТоба1МитрегоЕЕгееВу*ез); 
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Параметр 1рПО!гес4югуМате — имя каталога на том диске, о котором тре- 
буется получить информацию. Это не обязательно должен быть корневой ката- 
лог. Если фО1гесфогуМате = МОТ, будет получена информация о текущем 
диске. | 
Параметр 1рЕгееВуе$АуаПа]еТоСаПег — свободное место на диске 
(в байтах), доступное данному приложению. Параметр 1рТофа МишфегОЕВу- 
$е5 — емкость диска, параметр 1рТофаМишЪегО?ЕгееВуёе; — указатель на 
свободное число байтов на диске. | 

Перечисленные выше функции — это функции АРТ \У\11940\з. Однако 
в С++Виа!аег есть более простые и удобные функции. Функция 01$Ё$127е из 
файла из 43.В: 


ехЕегп РАСКАСЕ __1п664 __Еаз®са11 Р1$К512е (Вуфе Рг1уе); 


возвращает размер диска в байтах. Параметр Омуе задает диск, о котором же- 
лательно получить информацию: 0 — текущий, 1 — А, 2 — Вит.д. 
Функция 0О1$КЕгее: 


‚ехесегп РАСКАСЕ _ 110%64 __ Еаз®са11 Р15КЕгее (ВуЕе ПОг1уе); 


возвращает свободное место на диске в байтах. Параметр Омуе имеет тот же 
смысл, что и в функции О1$К$1те. Обе функции возвращают -1, если указан- 
ного диска нет. Так что, организовав цикл по номерам дисков, легко опреде- 
лить, сколько дисков имеется на компьютере. 
Информацию о файловой системе, расположенной на диске, можно полу- 
чить функцией деУо!атепогта оп, объявленной следующим образом: 
ВООГ Се Уо1оме1ТпЕогма®1оп (ТМ ЬРССТВ ]1рВооЕРаЕПМаме, 
ОЧТ ГРЗТВ 1рУо1амемамеВоЕЕег, 
ТМ ОМОВО пУо1амемапеб$1те, 
‘ОПТ ТРЬМОВБР 1рУо1омебег1ла]Мопфегк, 
ООТ .РОМОВО 1рМах1татСотропепЕЪепаец, 
ООТ ЪРОМОВО 1рЕ11ебузфепЕ1аваз, 


ОЧТ ГРЗТВ 1рЕ11ебузбетМатеВаЕЕег, 
ТМ РМИОВР пЕ11ебузкептМаме$1те); 


Параметр рКоо Ра Маше — корневой каталог диска. Параметр 1рУош- 
штеМматеВиЁег — буфер размера пУоитеМате$127е, в который возвращается 
имя диска. В. параметр 1рУоатеЗега Митфег возвращается серийный номер 
диска. Учтите, что это отнюдь не заводской номер винчестера. Это чисто слу- 
жебный номер логического диска, который записывается на диск во время его 
форматирования. | 

В параметр рМахипитСотропеп Гепо В возвращается допустимое число 
сомволов в элементах имен файлов, т.е. число сомволов, которые могут разме- 
щаться между обратными слэшами. Например, если поддерживаются длин- 
ные имена, то обычно рМахпипитСотропеп(Тепо* В = 255. 

В параметр 1рЕПеЗузет 1ай$ возвращаются флаги, характеризующие 
файловую систему на диске (см. подробнее гл. 8 и приведенный далее при- 
мер). 

В буфер 1рЕПезЗузет МатеВиЁег размера пЕЦеЗузетМате517е возвра- 
щается имя файловой системы, например, “`РКАТ” или "МТЕЗ”. 

Рассмотрим тестовый пример, иллюстрирующий применение всех этих 
функций. Это проект РЕЦе][п]} в каталоге РЦез на прилагаемом к книге диске. 
На рис. 6.1 показано окно этого приложения во время выполнения. 
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Рис. 6.1 Информация о дискам _ У 


: Диск А:\ съемный 

Проект РЕ|ешТ во время выполнения | диск СА локальный 

идентификатор - 5У5ТЕМ 
` серийный номер - 1288263458 

емкость - 1949 МБ (2044051 456 байт] 
свободно - 356 МБ [373407744 байт) 
доступно - 356 МБ (373407744 байт) 
система - ЕАТЗ2 
поддерживает сжатие 
максимальная длина имен файлов - 255 
сохраняет регистр имен файлов 
поддерживает АСЁ 
Диск О0-\ локальный 


идентификатор - ХР 

серийный номер - 954651553 

емкость - 9889 МБ (10370121728 байт} 
свободно - 1354 МБ (1420165120 байт) 
доступно - 1354 МБ (1420165120 байт) 
система - ЕАТЗ2 


поддерживает сжатие 
максимальная длина имен файлов - 255 


Диск Е:\ локальный 

идентификатор - РВОВ 

серийный номер - 1410617303 

емкость - 9889 МБ [10370121728 байт] =] 


Ниже приведен обработчик щелчка на кнопке в окне приложения. 


у01А _ Еаз&са11 ТГоги1:; :Вие®оп1С11сК (ТОБ]есе *5епаег) 
{ 
РИОВОР Матрег, Е11еТепаеВ, У\Уо1Е1ааз; 
срахг Пу1уе$ [255], ВаЕ [256]; 
сраг ЗузбетМате [127]; 
Ап$15Ег1па 5; 
101; 
РСВаг'Р ; 
__ 10664 ЕгееАуа11аб1е, Тофа15расе, Тофа1Егее; 
В1свЕЧ11->С1еак(); | . 
1Е (Сеегод1са10г1уе$&г1паз (256,Ог1уез) > 256) ех1е; 
Р = Ог1уез; 
мр11е (*Р != 0) 
{ 
5 "Диск " + Ап515ег1па (Р); 
1 = Сее)г1луеТуре (Р); 
$м1ЕсВ (1) 


{ 


сазе 0: 5 = $ +" неизвестного типа"; 


Ьгеак; 
сазе ОКТУЕ ВЕМОУАВТЕ: $ = 5 + " съемный"; 
Бгеак; — 
сазе РКТУЕ_ ВЕМОТЕ: 5 = $ + " сетевой"; 
Ьгеак; 
сазе ОВТУЕ_СРОВОМ: $ = $ +" СО-ВОМ"; 
Ьгеак; | 
сазе ОВТУЕ_ВАМОТЗК: = "в 03"; р 
Ьгеак; 
ЧеЁРац1+: $ = $ + " локальный"; 


} 
В1срЕЯ1 1 ->5е1Ас Е г1Бафбез->56у1е 
В1срЕа11->Ь1пез->Ааа ($); 
В1срЕа1{1->5е1Аб Е г1Бабез = К1срЕа11->ШеЕАЕ Е гк1Ба вез; 

1Е ((1 == ОВТУЕ_ЕТХЕО) || (1 == ОКТУЕ _КЕМОТЕ)) 

{ | 

1Е (СекУо1амеТпЕогмае1опт (Р, ВоЕЁ, 256, &Мотрег, &Р11етепафеь, 

&Уо1Е1ад5, ЗузеепМате, 128)) 


ТРопе5$у1е$ () << ЕзВо1а; 


{ 
В1срЕЯ161->1пез->Ааа ("идентификатор - " + 
((Ап$156г1па (ВаЕ) =="") 2? Ап515бЕг1па ("отсутствует") : 
Ап$15Ег1па (ВаЕЁ))); 
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В1срЕа1$1->Г1пез->АЧа ("серийный номер - " + ТпЕТобекг (№ашбег)); 
5у5$ие115: :Сеер1зКЕгеебрасеЕх (Р, ЕгееАуа11аЪ1е, 
Тоса15расе, &Тофа1Егее); 


В1срЕа11->Г1пез->Ааа ("емкость - " + 
ТпеТоЗег (Тоба1$расе >> 20) +" МБ (" + ТпЕТо5ег (Тоба1$расе) 
+" байт) ") ; 
В1срЕа11->Г1пез->ААаа ("свободно - " + 
ТпЕТобехг (Тофа1Егее >> 20) + " МБ (" + ТОЕТобЕг (Тоба1Егее) 
+ " байт)"); 
В1спЕаз 1->Ь1пез->Ааа ("доступно - " + 
ТрЕТобек (ЕГгееАуа11аБ1е >> 20) + 
" МБ (" + ТоЕТобЕк (ЕгееАуа11аЪ1е) + " байт)"); 
В1срЕа1 *1->1пез->Ааа ("система - " + Ап$156г1па (бузбетМапе)); 


1Е ((Уо1Е1ад$ &5 Е5 ЕТЬЕ СОМРВЕЗЗТОМ) > 0 ) 
В1срЕа1$1->Г1пез->ААа ("поддерживает сжатие"); 
е1зе К1сВЕа11->1пез->Ааа ("не поддерживает сжатие"). 


В1срЕа1 Е 1->1пез->Ааа ("максимальная длина имен файлов = "+ 
Трое Тозек (Р1]ерепаев)); 


1Е ((\о1Е1ад$ && Е5 САЗЕ 15$ РВЕЗЕБУЕО) > 0 ) 
К1 сЬЕа1*1->Ь1пез->ААаА ("сохраняет регистр имен файлов"); 


1Е ((\Уо1Е1ачз && Е5$ РЕВЗТЗТЕМТ АСТ$) > 0) 
В1срЕа11->Г1пе$->ААаА ("поддерживает АСШ"); 


} 
Р = Р + 4; 


Приведенный код начинается с вызова функции аеТ.огсеа Шуе {г1т5$5, 
возвращающей в буфер Омуе$ список дисков. Если размера буфера не хвати- 
ло, работа процедуры завершается. Конечно, можно было бы, руководствуясь 
возвращенным значением, выделить динамически в памяти буфер требуемого 
размера. Но я не стал усложнять код. 

Далее указатель Р устанавливается на начало буфера Омуе$, и следует цикл 
\уИЦе по всему списку. В конце каждого прохода указатель Р сдвигается на 4 
символа, так что начинает указывать на следующий диск списка. Если Р указы- 
вает на нулевой символ, значит, достигнут конец списка, обозначаемый двумя 
нулевыми символами. При каждом проходе, т.е. для каждого диска, вызывает- 
ся функция адеФыуеТуре, указывающая тип диска. Вызываются также функ- 
ции деУоГлтеП{огтайоп и Се О15ЕЕгееЗрасеЕх. Результаты анализа инфор- 
мации, возвращаемой всеми этими функциями, вы можете видеть на рис. 6.1. 


6.1.2 Получение информации о физических и логических 
дисках функцией ОБемсеюоСот“го! | 


Функция Вех1сеТоСопф го] осуществляет непосредственное взаимодействие с 
драйвером устройства (дисковода), посылая ему команду, позволяющую управ- 
лять этим устройством или получить о нем информацию. Это многоцелевая 
функция управления вводом-выводом (ТОСТТ,). Фактически, Оеу1сеТоСоп@`о] 
представляет собой множество функций, вид которых задается ее параметром 
4\ТоСопёго!Со4е. Подробное описание функции ,ечм1сеГоСопето| вы найдете 
в гл. 8. А в данном разделе рассмотрим использование этой функции для полу- 
чения информации о дисках. 
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С помощью функции ОемсеТоСопего] можно получить доступ не только 
к логическим, но и к физическим дискам. Дескриптор диска, информацию 
о котором вы хотите Получить, задается первым параметром функции. Этот де- 
скриптор возвращается функцией СгезфеЕЦе (ее подробное описание 
см. в разд. 6.7.1 ив гл. 8.), которая должна быть предварительно вызвана. 
При этом должны быть выполнены следующие требования: 


1. Пользователь должен иметь права администратора. 


2. Чтобы открыть физический жесткий диск с номером х, путь к файлу — 
аргумент 1рЕПеМаше в вызове Сгеж{еЕПе должен иметь форму «\\.\РНУ- 
1САГОРУЕх». Номера жесткого диска начинаются с нуля. Например: 
«\\.\РНУЗСАБГОВГУЕ0» — это первый физический диск компьютера по- 
льзователя. | 


3. Чтобы открыть накопитель на гибких дисках или открыть один из логиче- 
ских дисков, на которые разбит физический диск, путь к файлу — аргу- 
мент 1рЕ|ПеМаше в вызове СгезжеЕЦе должен иметь форму «\\.\х:», 
где х — буква диска (регистр буквы не имеет значения). Например: 
«\\.\А:» — диск А, «\\.\4:» — диск О. 


4. Аргумент АмСгеайоп 1 (гай оп в вызове Сгеа&еЕЦе должен иметь флаг 
ОРЕМ_ЕХТЗТГМС. 


5. При открытии гибкого или жесткого диска вы должны в аргументе 4мЗВа- 
геМоде в вызове СгежеЕЦе установить флаг ЕП.Е_5НАВЕ_\МЩТЕ. 


Таким образом, открытие устройства может осуществляться, например, 
таким оператором: 


НАМОЬЕ РОеу1се=Схеа*еЕ1 1е (Еа1Е1->Техе.с зЕг(), 


СЕМЕКТС_ВЕАШ | СЕМЕВТС ИВТТЕ, 
ЕТЬЕ ЗНАВЕ КЕАР | ЕТЬЕ ЗНАВЕ ИКГТЕ, МОБ, 
ОРЕМ_ ЕХТЗТТМС, 0, МОГ); 
1Е (ЮОеу1се == ТМУАЬТР НАМОГЕ УАГОЕ) 
ЗВомМеззасе ("Невозможно открыть диск. \пОшибка: \п'" + 
ЗузЕггогМеззасде (СееЪазЕЕгког ()) + "!"); 


В этом коде подразумевается, что устройство задано пользователем в окне 
редактирования ЕЁ] в формате, соответствующем приведенным выше требо- 
ваниям. Например, в окне может быть написано «\\.\Р|пуз1саШтуе0”, если 
надо получить доступ к первому физическому жесткому диску. А может быть 
написано ”\\.\а:” или «\\.\4:”, если надо получить доступ к гибкому диску А 
или к логическому диску О. Этот диск О не обязательно должен относиться к 
жесткому диску. Это может быть, например, устройство СО-ВОМ. 

Если в окне ЕЯ1 записано имя диска, которого нет на компьютере, поль- 
зователю будет показано окно с сообщением вида: } 

Невозможно открыть диск. 


Ошибка: 
'Не удается открыть указанный файл' 


Если вы хотите записать имя диска непосредственно в вызове функции 
Сгеж{еЕ Пе, не забудьте о необходимости сдваивать символы слеша. Например, 
так: | 

НАМОЬЕ Вреу1се=СгеакеЕ11е ("\\\\.\\Рруз4са1ргахеб", 

СЕМЕВТС ВЕАР | СЕМЕВТС ИВТТЕ, 


ЕТЬЕ_ЗНАВЕ ВЕАР | ЕТЬЕ ЗНАВЕ ИВТТЕ, МОБ, 
ОРЕМ ЕХТЗТТМС, 0, МО); 
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После того, как нужные операции с диском, вызываемые функцией Ое\- 
сеГоСопфго], завершены, дескриптор следует закрыть функцией С]1озеНапе: 


С1о5еНапа1е (ПОеу1се); 


А теперь рассмотрим получение информации о диске, заданном своим де- 
скриптором В,е\мсее. Информацию будем заносить в окно редактирования 
Мето1. Во всех случаях работы с функцией РемсеТоСопего! надо вручную 
включить в модуль директиву | 


#1пс1аае <и1п10с+1.8> ` 


и объявить переменную ВКеигпе4Вуез: 


РИОВКОР ВБебигпеаВусез; 


Дальнейшие примеры даются без особых пояснений. Всю необходимую 
информацию о режимах работы с функцией Оем1ееГоСопфго] вы Найдете в ГЛ. 
8. 

Размер диска можно получить следующим образом: 

СЕТ ЬБЕМСТН_ТМЕОВМАТТОМ СЪЕ; 

1Е (Реу1сеТоСопЕго1 (ПрРеутсе, ТОСТЬ ОТ5К_СЕТ_ЪЕМСТН_ТМ№РЕО, 

МОГ, О, &СЬЕ, $12е0ЕЁ (СЬЕ), &ВебогпеаВуеез, 
МОЪЬ) ) 


{ 
ТОМСЪЬОМС Ъ = СЬЕ.ТепаеВ .ОцааРагк; 
ЗЕгтпа 5 = ТпЕТобек (1); 
Бог (1106 1=5.репаф®В ()-2; 1>1; 1-=3) 
5.Тобекё (' "',1); 
Зеглпа 51 = "!; 
1Е(Г > 1073741824). 
$1 = ЕТоаеТозекЕ (Ъ / 1073741824., ЕЕР1лхеа, 10, 2) +" ГБ"; 
е] зе 1Е(Т > 1048576) 
$1 = Е1\оа*ТобЕуЕ(Ъ / 1048576., ЕЕЕ1хеа, 10, 2) +" МБ"; 
е1зе 1Е(Т > 1024) 
$1 = Е!оа ТобЕуЕ(Ъ / 1024., ЕЕЕ1хеа, 10, 2) + " КБ"; 


Мепо1->Ь1пез->Ааа ("Размер " + 51 +" (" + $5 +" байт)"); 


} 


Полученный в этом примере размер диска отображается в окне Мето] в 
виде строки такого вида: 


Размер 186,31 ГБ (200 049 647 616 байт) 


Функция ОемсеТоСопфтго| со вторым параметром равным ТОСТЕ_Т1$К_ 
СЕТ_ТЕМСТН_1№ЕО заносит ‘информацию о размере диска в байтах в струк- 
туру типа СЕТ ТЕМСТН_ТМЕОВМАТТОМ СЕЕ. Эта структура содержит одно 
поле Геп2& типа ГАКСЕ_ТУТЕСЕВК (см. описание этого типа в разд. 1.15.1). 
С помощью поля @ца4Раг& этого типа размер диска заносится в переменную Г.. 

Затем полученный размер в байтах заносится в виде строки в перемен- 
ную ». В цикле #ог в эту строку вставляются пробелы после каждых трех раз- 
рядов, чтобы облегчить чтение числа пользователем. В переменной 51 форми- 
руется строка размера в ГБ, МБ или КБ в зависимости от размера диска. 

При успешном выполнении функция возвращает положительное значение. 

Использованная в данном примере функция О,еум1сеГоСоп@го! с кодом 
ТтОСТЬ _ОТЗК_СЕТ_ТГЕМСТН_ТМЕО применима к физическим и логическим 
жестким дискам и к съемным дискам (например, к СО-ВОМ), если в них за- 
гружен носитель. При использовании функции для гибких дисководов или. 
дисководов, в которые не вставлен диск, возвращается О — ошибка. Вид ошиб- 
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ки можно узнать вызовом функции Се Га Еггог. По сравнению с применяв- 
шейся в разд. 6.1.1 функцией 01$К$517е рассмотренный подход имеет преиму- 
щество при получении информации о физических жестких дисках и съемных 
дисках, в частности, СО-ВОМ с загруженным носителем информации. Функ- 
ция 01$К512е для таких дисков просто неприменима. 

Следующий пример (проект РГОЗТЕ в каталоге РИез) демонстрирует полу- 
чение информации о конфигурации дисков. 


р1$К СЕОМЕТВУ 0; | 
1Е (Реу1сеТоСоп&го1 (ПОеу1се, ТОСТЬ РТ5К_СЕТ ОВТУЕ _СЕОМЕТВУ, 


МОЬЬ, 0, &0С, з12еоЁ(рС), &ВекогпеаВуеез, МОЬЬ)) 
{ 
Апз156хапа 5; 
$м1ЕсП (РСс.МеазаТуре) 
{ 


сазе Опкпомп: 5 = "Формат неизвестен"; 

. Ьгеак; 
сазе К5 1Р2_512: 5 = "5.25 дюйма, 1.2МВ, 512 байт в секторе"; 
Ьгеак; 
сазе ЕЗ 1Р%44 512: 5$ = "3.5 дюйма, 1.44МВ, 512 байт в секторе"; 
Ьгеак; 
сазе КЗ _2РЕ88 512: $5 = "3.5 дюйма, 2.88МВ, 512 байт в секторе"; 
Бгеак; 
сазе ЕЗ_20РЕ8 512: $ = "3.5 дюйма, 20.8МВ, 512 байт в секторе"; 
БгеаКк; | 
сазе ЕЗ_720_512: $ = "3.5 дюйма, 720КВ, 512 байт в секторе"; 
Ьгеак; . 
сазе Е5 360 512: 5 = "5.25 дюйма, З60КВ, 512 байт в секторе"; 
Ьгеак; 
сазе К5 320 512: 5$ = "5.25 дюйма, 320КВ, 512 байт в секторе"; 
БгеакК; 

. сазе Е5_ 180 512: $ = "5.25 дюйма, 180КВ, 512 байт в секторе"; 
ЬгеаКк; 
сазе Е5 160 512: $ = "5.25 дюйма, 160КВ, 512 байт в секторе"; 
БгеаКк; 
сазе КетоуаЪ]1еМеа1а: 5 = "Съемный диск"; 
Бгеак; 
сазе Е1хеМед1а: $ = "Несъемный жесткий диск"; 
Ьгеак; 
сазе ЕЗ_120М 512: $ = "3.5 дюйма, 120М, Гибкий"; 
ЬгеаКк; 
сазе ЕЗ_ 640 512: 5 = "3.5 дюйма, 640КВ, 512 байт в секторе"; 
БгеаКк; 
сазе Е5 640 512: 5 = "5.25 дюйма, 640КВ, 512 байт в секторе"; 
БгеаК; 
сазе Е5 720 512: 5 = "5.25 дюйма, 720КВ, 512 байт в секторе"; 
ргеак; — — | 
сазе ЕЗ_1РЕ2 512: 5 = "3.5 дюйма, 1.2МЬ, 512 байт в секторе"; 
БгеаКк; , 
сазе ЕЗ 1Р®23 1024: 5 = "3.5 дюйма, `1.23МЬ, 1024 байт в секторе"; 
ЬгеаКк; 
сазе Е5 1Р%23 1024: 5 = "5.25 дюйма, 1.23МВ, 1024 байт в секторе"; 
ЬгеаКк; 
сазе ЕЗ 128МЬ 512: $ = "З.5 дюйма, МО 128МЬ, 512 байт в секторе"; 
БЬгеак; 
сазе ЕЗ_230МЬ 512: 5 = "3.5 дюйма, МО 230МЬ, 512 байт в секторе"; 
Ьгеак; | 
сазе Е8_256 128: 5 = "8 дюйма, 256КВ, 128 байт в секторе"; 
Бгеак; | 
сазе ЕЗ 200МЬ 512: $ = "3.5 дюйма, 200М, Гибкий (Н1ЕР)"; 
Ьгеак; 


сазе ЕЗ_240М 512: $ = "3.5 дюйма, 240МЬ, Гибкий (Н1ЕРО)";; 
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ЬгеаКк; 
сазе ЕЗ_32М 512: $ = "3.5 дюйма, 32МЬ, Гибкий"; 


} 
Мето1->Г1пез$->Ааа ($); 


Мемо1->ТЪ1пез->ААа ("Число цилиндров " + 
| ТпеТо5ек (РС.Су11паег$ .ОпааРаг®)); 
Мепо1->1пез->Ааа ("Число треков в цилиндре " + 
ТпеТоЗег (Рб.Тгаск$РекСу]1паег)); 
Мепо1->1Т1пез->ААа ("Число секторов в треке " + 
Тре Тобег (ОС.бесфогзРегТгасКк)); 
Мепо1->1пез->ААа ("Число байтов в секторе " + 


ТпеТозег (Рс.ВубезРегбеског)); 
} 


е1зе 
ЗВомМеззасе ("Получить информацию о диске не удалось. \пОшибка:\п'" + 
сузЕггогМеззаае (бес азеЕгкох (}) + "'"); 


Результат выполнения этого примера может быть таким: 


Несъемный жесткий диск 
Число цилиндров 24321 

Число треков в цилиндре 255 
Число секторов в треке 63 
Число байтов в секторе 512 


В этом примере использована функция Вех1сеГоСопфтго]! со вторым пара- 
метром равным ТЮСТЬ ОТК СЕТ ОВТУЕ_СЕОМЕТКУ. В таком режиме 
функция заносит информацию о конфигурации диска в структуру типа ОТК _ 
СЕОМЕТКУ. Поле СуПп@4ег$ этой структуры содержит число цилиндров 
_и имеет тип ГАВСЕ ТМТЕСЕВ. Поля Тгаск$РегСуйп@4ег, Зесог$РегТгасК 
и ВуезРег5есфог содержат соответственно число треков в цилиндре, число 
секторов в треке и число байт в секторе. Поле МещаТуре характеризует тип 
диска. Возможные значения этого поля определяются перечислением типа 
_МЕРТА_ ТУРЕ. Смысл элементов этого перечисления вы можете видеть в опе- 
раторе змйеВ приведенного кода. 

При успешном выполнении функции Оеу1сеГоСопёто] с кодом ТОСТЬЕ_ 
ОЗК_СЕТ_ГЕМСТН Л М№ЕО возвращается положительное значение. Функция 
Реу1сеТоСоп4го1 применима к любым дискам, физическим и логическим. 
Но если в дисководе со съемным диском (гибким или СО) не вставлен носитель 
информации, то функция возвращает нулевое сообщение — ошибку. 

Мы рассмотрели основные возможности функции Оем1сеТоСопф то] по по- 
лучении информации о дисках. По сравнению с функциями, рассмотренными 
в предыдущем разделе, достоинствами функции Оез1ееТоСоп{го| являются 
возможность работать с физическими и съемными дисками и возможность по- 
лучать информацию о конфигурации диска, что, впрочем, тоже имеет смысл 
именно для этих типов дисков. Так что если желательно иметь приложение, 
дающее информацию о всех дисках компьютера, то, вероятно, для логических 
дисков проще и естественнее использовать приемы, описанные в предыдущем 
_ разделе, а для физических и съемных дисков использовать функцию Ое\мсе- 
ТоСоп#тго!1. Ниже приведен фрагмент кода, дающий информацию о всех подоб- 
ных дисках и суммирующий предыдущие примеры. 


#1п0с1ааАе <м1п1о0осе1.1> 


НАМОГЕ ПОеу1се; 

РИОВР ВебогпеаВу*ез; 

Мепо1->С1еах(); 

Мето1->Т1пез->Ааа ("Информация о физических дисках компьютера"); 
Бок (106 1=0; 1 < 1000; 1++) // Цикл по физическим дискам 


{ 
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С1о5еНапа1е (ПО)еу1се); | 
преу1се=СгеаееЕ11е ( ("\\\\.\\Рруз1са1Ох1уе" + ТпЕТобех (1)).с _$зЕк(), 
СЕМЕКТС_ВЕАШО | СЕМЕВТС _ИВТТЕ, 

ЕТТЕ ЗНАВЕ_ВЕАР | ЕТЬЕ $НАВЕ ИВТТЕ, МОБЬ, 
ОРЕМ ЕХТЗТТМС, 0, №11); 

1Е (ПОеу1се == ТМУАТТО_ НАМРЬЕ _УАЪОЕ) 

Ьгеак; // Прерывание цикла, если больше физических дисков нет 


Мемо1->Ъ1пез->Ааа ("Диск "+ ТоеТобЕк (1)); 

СЕТ _ЪЕМСТН_ТМГОКМАТТОМ СЬЕ; 

1Е (Реу1сеТоСопего1 (П)еу1се, ТОСТЬ ОТ$5К СЕТ ТЕМСТН ТМРО, . 
МОЪЬ, 0, &СЬЕ, з1хеоЕ(СЬЕ), &ВКебагпеаВуеез, 
МО) ) 


_ ТОМСЬОМС Ь = СЬЕ.ЪепаеВ .ОчааРаге; 
ЗЕглпа 5 = ТаЕТобекг (1); 
Бог (106 1=5.Бепафь()-2; 1>1; 1-=3) 
5.Тпзеге (' ',1); 
ЗЕглпа $51 = "!; 
ТЕ (Г > 1073741824) 
$1 = Е\оа ТобЕкЕ(Ъ / 1073741824., ЕЕЕ1хеа, 10, 2) +" ГБИ; 
е1зе 1Е(Т, > 1048576) 
$1 = РЛоа%*ТобегЕ(Т / 1048576., ЕЕЕ1хеа, 10, 2) +" МБ"; 
е1зе 1Е(Т, > 1024) | 
$1 = Е\оа%*ТобЕкЕР(Т / 1024., ЕЕР1хеа, 10, 2) +" КБИ; 


Мемо1->1пез->Ааа ("Размер " + $1 +" (" + $ + " байт)"); 
} 


РТ$5К СЕОМЕТВУ рС; | 
11 (реу1сеТоСопего1 (вреу1се, ТОСТЬ_рТ$К_СЕТ_ОВТУЕ СЕОМЕТВУ, 
МОР, 0, &0С, з1хеоЕЁ(р0С), &КебогпеаВу®ез, МОГ!) 
{ 
Мепо1->11пез->Ааа ("Число цилиндров. "+ 
ТоеТоЗех (ОС.Су11паег$. ОцааРагь)); 
Мепо1->Ь1пез->Ааа ("Число треков в цилиндре " + 
| ТпеТоЗег (2б.ТгаскзРегСу11п4ег)); 


Мепо1->Т1пез->Ааа ("Число секторов в треке " + 
ТоЕТобЕг (ОС.бесеогзРегТгасКк)); 
Мепо1->Ъ1пез->Ааа ("Число байтов в секторе " + 


ТрЕТозек (РСс.ВубезРегзеског)); 
} 
} 


Мепо1->11пез->Ада ("\г\пИнформация о съемных дисках компьютера"); 
Еог (сПахг сП='А'!; сб <= '2'; ср++) 
{ 


С1озеНапа1е (№Ш)еу1се); 


Апз15ег1лпа 5 = "\\\\.\\:" 
5.Тизетф (сВ,5) + ЗЕг1лпа (св); //+ ":"); 
преу1се = СгеафеЕ11е(5.с з%т(), 


СЕМЕКТС _ВЕАО | СЕМЕВТС ИВТТЕ, 
ЕТЬЕ ЗНАВЕ ВЕАШ | ЕТГЕ СНАВЕ _МВТТЕ, МОЬЬ, 
ОРЕМ ЕХТЗТТМС, 0, МОЪЬ); 
1ЁЕ (ПБеу1се == ТМУАТТР НАМОЬЕ УАГОЕ) 
сопё1пце;// Прерывание обработки диска, который не удалось открыть 


ОТК СЕОМЕТВКУ 1С; 

1Е (реу1сетоСопего1 (Вреу{се, ТОСТЬ ОТ$5К_ СЕТ ОВТУЕ СЕОМЕТВУ, 
МОБ, 0, &0С, э1тхеоЕЁ (ОС), &ВебоагпеаВуеез, МОП1,)) 
{ ` . 
Ап$156 капа 5; 
$м1Еср (ОСс.Меа1аТуре) 
{ 
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сазе ОпКкпомп: сопЕ1пие; 
сазе Е5 1Р%52_512: 5 = "5.25 дюйма, 1.2МВ, 512 байт в секторе"; 


ргеаКк; 
// см. рассмотренный ранее пример 
сазе Кептохаб1еМеЯта: 5 = "Съемный диск"; 
БгеаКк; 
сазе Е1хеМеа1а: соп®&1пае; // Несъемный диск не рассматривается 
сазе ЕЗ 120М 512: $ = "3.5 дюйма, 120М, Гибкий"; 
Ьгеак; 


. // см. рассмотренный ранее пример 
} 
Мемо1->Ъ1пез->Ааа ("Диск " + 5Егтпа (с1)); 
Мепо1->Г1пез$->Ааа (5); 
Мемо1->Ъ1пез->Ааа ("Число цилиндров " + 

Тре Тозехг (0С.Су11паег$ .ОцаЯРаг®)); 
Мето1->Т1пез->Ааа ("Число треков в цилиндре " + 
ТрЕТобех (ОС.Тгаск$РегСу11паег)); 


Мето1->11пез->Ааа ("Число секторов в треке " + 
ТоЕТозЕхг (0Сб.бесеогзРегТгасКк)); 
Мето1->Ъ1пез->Ааа ("Число байтов в секторе " + 


ТпеТозег (рСс.ВубезРегбесфог)); 
| 


е1зе сопЕ1пие; 

СЕТ_ТЕМСТН_ТМЕОВМАТТОМ СЬЕ; о. 

1Е (Реу1сеТоСопе го] (П)еу1се, ТОСТЬ РТ$5К_ СЕТ ЪЕМСТН_ТМЕО, 
МОГ, 0, &СЬЕ, з12еоЕЁ (СЪЕ), &ВебогпеаВусез, 
МОГ) ) 


{ 
ЪОМСЬОМС Г = СЬЕ.Тепафр.. ОпааРаге; 


5Еглпа 5 = ТпЕТо5бк (1); 
// см. определение размера для физического диска 
Мепо1->Г1пез->Ааа ("Размер " + $1 +" (" + $ + " байт}"); 
} 
} 
Приведенный код выдаст информацию о всех физических дисках компью- 
тера и о съемных дисках, загруженных в данный момент в дисководы. 
Рассмотрим еще один способ использования функции Оеу1сеГоСопфго] для 
получения информации о дисках. Нередко требуется определить, доступен ли 
диск. Если речь идет о сменных дисках, то недоступность может быть связана 
с тем, что в дисковод не вставлен носитель информации. В этом случае надо 
предложить пользователю вставить нужный диск. Недоступность может быть 
связана также с рассмотренной в следующем разделе блокировкой диска. 
Информацию о доступности диска с дескриптором ВОеху1ее можно полу- 
чить следующим образом: 
1Е (Реу1сеТоСоп®го]1 (ПОеу1се, ТОСТЬ_ СТОВАСЕ СНЕСК_ _УЕВТЕУ, 
| мМОЪЬ, 0, МО, 0, &ВекагпеЧВу+ез, МОЪЬ) } 
‘Мепо1->Т1пез->АаАа ("Устройство готово к работе"); 


е15е 
Мепо1->11пе$- >АЗА ("Устройство не готово к работе"); 


Функция Ре\мсеТоСотго| с кодом ЮСТ $ТОВАСЕ_СНЕСК_УЕВТЕУ 
возвращает фгие, если устройство готово к работе — не заблокировано и диск 
вставлен в дисковод. 


6.1.3 Управление дисководами СО-КОМ 


Функция Ое\з1ееТоСопфго| позволяет не только получать информацию 
о дисках, но и управлять ими. Рассмотрим несколько таких возможностей 
применительно к СО-ВОМ. 
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В СО-ВОМ можно управлять выдвижением носителя. Выдвинуть лоток 
с носителем можно функцией Оех1сеГоСопфго| с кодом ЮСТЬ_ ЗТОВАСЕ_ 
ЕТЕСТ_МЕБТА: 


Реу1сеТоСоп®го1 (ПРеу1се, ТОСТЬ $ТОВАСЕ ЕЗЕСТ МЗОТА, 
МОЬЬ, 0, №01, 0, &ВебогпеЯВу“ез, МОЪГ); 


Программно задвинуть лоток с носителем можно функцией 
Рех1сеГоСопфго] с кодом 1ОСТГ ЗТОВАСЕ_ТОАШ_МЕПШТА: 


Реу1сеТоСопЕго1 (йБеу1се, ТОСТЬ 5ТОВАСЕ БОАР МзОТА, 
МТТ, 0, МОБЬ, 0, &ВебагпеаВу(сез, МОЪЬ); 


Функция возвращает фгиае, если выполнена успешно. 

Вызов функции ОемсеТоСопёго] с кодом ТОСТ! _ЗТОВАСЕ_МЕШТА_КЕ- 
МОТХАГ позволяет блокировать или разблокировать возможность выдвиже- 
ния лотка. Подобный вызов в синхронном режиме имеет вид: 


РКЕУЕМТ МЕРТА_ВЕМОУАГ РМК; 


Ре\у1сеТоСопЕгко1 (ПП,еутсе, ТОСТЬ 5ТОВАСЕ_ МЕРТА ВЕМОУАЪ, 
&РМК, з17еоЕ(РМК), МОЬЬ, 0, &$ВебагрпеаВуеез$, МОТ); 


Входным буфером служит структура типа _РВЕУЕМТ МЕРТА_ВЕМО- 
УАГ, имеющая одно булево поле Ргеуеп{МеФ1аВетоха!. Задание значения 
этого поля фгие блокирует выдвижение лотка, а задание значения #а[$е снима- 
ет блокировку. Пусть, например, в приложении имеется группа радиокнопок 
Ва410оСгоир1, в которой первая кнопка означает Блокировоть, а вторая — Раз- 
блокировать. И имеется кнопка, при щелчке на которой должна выполняться ' 
операция, заданная радиокнопками. Тогда обработчик щелчка.на этой кнопке 
может иметь вид: | 

РВЕУЕМТ МЕРТА ВЕМОУАЪ РМБ; 

РМВ.РгеуепсМеа1аКемтоуа1 = Ка@1оСбкоир1->ТкетмТп4ех == 0; 

1Е(! Реу1сетоСопеко1 (ПРреу1се, ТОСТТ ЗТОВАСЕ МЕОРТА ВЕМОУАЬ, 

&РМВ, $з12еоЕ (РМК), МОГГ, 0, &ВебагпеаВуеез, 
мот) ) 


ЗБомМеззаче ( 
"Диск не воспринял команду 'ТОСТЬ 5ТОВАСЕ _МЕШТА_ВЕМОУАЬ'"); 


Если выдвижение лотка заблокировано, то носитель нельзя‘извлечь и вруч- 
ную. Более того, если приложение закрылось, а блокировка не была снята, то 
устройство так и останется заблокированным. Так что будьте осторожны с этой 
командой, чтобы не доставить неприятность пользователю. Если в приложении 
предусмотрено использование этой команды, то полезно во избежание неприят- 
ностей при закрытии приложения на всякий случай снимать блокировку. 

Если подряд выполнено несколько вызовов Оеу1сеоСоп то], задающих 
блокировку, то устройство разблокируется только после такого же количества 
вызовов, снимающих блокировку. Так что если вы хотите гарантированно вы- 
двинуть лоток, независимо от числа предшествующих блокировок, это можно 
сделать так: 
| РКЕУЕМТ МЕРТА ВЕМОУАТ РМВ; 

РМК.Ргеуеп&МеЯ1аКетоуа1 = Еа1$е; 

ир11е(! Реу1сеТоСопЕго1 (ПБеу1се, ТОСТЬ 5ТОВАСЕ_ ЕЗЕСТ.МЕРТА, 

МОГ, 0, МОБЬ, 0, &ВЗебогрпеаВувез, МОТЦ)) 
Реу1сетоСопЕго1 (ПОеу1се, ТОСТЬ 5ТОВАСЕ МЕСТА _ВЕМОУАЦ, 


&РМВ, з12еоЕ (РМВ), МОТ, ), &Вебогпеавуеез, 
МОГ); 


Подобный код полезно выполнить и при завершении приложения, в кото- 
ром вы использовали блокировку. 
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6.2 Папки и их интерфейсы 


Папка — понятие более общее, чем каталог. Наряду с папками, соответст- 
вующими каталогам, существуют виртуальные папки: Панель управления, 
Принтеры, Мой компьютер и т.п. Папки имеют интерфейс ЗвВеПЕо14ег, объяв- 
ленный в файле 51106:.й. Доступ к интерфейсу корневой папки Рабочий стол 
(РезКюр} дает функция ЭН@ае ЮеКфорЕо1@ег: 


ЗНЗТРАРТ 5НСеерезкЕорЕо1аег (15е11Го14Аег **ррэзВЁ); 


В случае успешного выполнения она возвращает значение МОЕВКОВ и за- 
носит в ррзНЁ указатель на интерфейс 15 ВеПРо]4ег. Учтите, что содержимое 
корневой папки в общем случае отличается от содержимого Рабочего стола 
в более привычном понимании, т.е. от набора папок и ярлыков, расположен- 
ных на экране. Например, независимо от того, что вы вынесли на экран, кор- 
невая папка помимо элементов, размещенных на экране, обычно содержит та- 
кие элементы, как Мой компьютер, Сетевое окружение, егте! Ехр|огег, Мои доку- 
менты и ряд других. 

Вы можете вставить вызов ЭН@Се Фе ЮорЕо14ег, например, в обработчик 
события ОпСгезже вашей формы следующим образом: 


И/#1пс1иае <ус1.[5> //обратите внимание на отключение ус1.П 
#1пс10ае <501о05).6> 


156е11Го1аег *Т5Е; 
у01А __ЕазЕса11 ТЕогм1: : ГогмСгеасе (ОБ)есЕ *5епаег) 


{ 
1Е (5НСсеерезКкорРо1аех (&15Р) != МОЕВВОВ) 
Табе11->Сар®1оп=" Корневая папка недоступна"; 


} 


Если функция выполнилась без ошибок, вы получили доступ к интерфей- 
су корневой папки через переменную 1$РЕ. 

Как можно заметить из приведенного выше примера, при подключении 
модуля 3й106.й надо отключать модуль 0с(.й. Это не случайно. Дело в том, что 
если его не отключать, компилятор выдает сообщение о дубликате объявлений 
ряда функций. 

Каждый элемент, содержащийся в папке, имеет уникальный идентифика- 
тор, определяющий его место в родительской папке. Идентификатор является 
структурой типа ЗНТТЕМТО. Ее поле сЪ указывает размер структуры, а поле 
а Ш содержит различную информацию в зависимости от интерфейса роди- 
тельской папки. При работе с папками чаще приходится иметь дело не с сами- 
ми идентификаторами элементов, а с указателями на них типа ЕРТТЕМ- 
ШТ. Обычно они называются РТОГ (а ропщег %ф0 ап Цеш 14евиЁег 11$). 
РТОГ указывает на структуру типа ТТЕМПШПМ$Т с единственным полем шк 
типа ЭЯТТЕМТО, представляющим идентификатор элемента. 

Теперь остановимся на некоторых методах интерфейса Т$ве!Ео1Фег. Ме- 
тод Че 015р1ауМатеО:: 

НВЕЗОГТ (5ТОМЕТНОРСАЬЬТУРЕ *Сее01зр1ауМамесое ) ( 


15$Ре11Ео]1аег * Тр15, ГРСТТЕМТРЬТЗТ р1а1, 
ЗНСОМЕ оЕ]1ад$, ЗЭТЕВЕТ *рМапе); 


дает доступ к имени элемента — файла или папки. Параметр р141 — указатель 
РОГ на идентификатор элемента. Если р191 = МОТ.Г,, то подразумевается РТО 
корневой папки (Рабочего стола). Параметр иЕ1а5$ задает форму отображения 
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имени и может принимать одно из трех значекий: ЭНСОМ_МОВМАЕ, 
эНормМ МЕРОГОЕК или ЗЭНСОМ_ЕОКРАВЬГМС. Первые два мало различа- 
ются, влияя только на отображение общих документов. А третье значение 
предназначено не для показа пользователю, а для поограммного использова- 
ния: имя, отображаемое в этом варианте, может передаваться в метод Рагзе- 
015 р1ауМате, позволяющий по имени найти РФ... 

Параметр рМаште определяет структуру типа ЭТВВЕТ, в которую метод 
`Сего15р1ауМатеЁ возвращает имя элемента. Поле иТуре этой структуры со- 
держит } указание варианта, В котором з записано имя: 


Имя ‘содержится в поле > сб типа массива символов лов СВаг. | 


5 


 ТЕВЕТ _  ОРЕЗЕТ Имя содержится в поле аБТО рассмотренной ранее струк- | 
‘туры типа Т5НИет Ш) с индексом, определяемым полем 
‚ пОЁЁзе4.. 


СТВВЕТ _ Утв Имя содержится в массиве символов в МаеСваг,. на кото- 
_._рый указывает поле ре: типа РУ/14еСВаг. 


Ниже в качестве примера приведена функция, возвращающая имя эле- 
мента папки Эве|Ео4ег, указанного параметром р. 


Ап$15Ег1па МамеоЕЕо1аег (151е11Го1аег* 5ре11Ео14@ег, ГРТТЕМТОЬТЬТ р1а1) 


{ 
СТВВЕТ 1рМапе; 


петмзе* (&1рМаме, 0, з127еоЕ (1рМапе)); 
5ре11Ео14ег->беёр15р1ауМамеОЕ (р1а1, $НСОМ_МОВМАГ, &1рМаме); 
$м16есН (1рМаме.оТуре) ° 
{ 
сазе ЗЭТВВКЕТ МФТК: тебсагп 1рМаше .рО1ебекг; 
‚сазе ЭУТВВЕТ ОГЕЗЕТ: гебагп р1а1->мК1а.аотТр [1рМаме . чОЕЁзее 
— 517еоЕ (р1а1-->щк1а.сЬ)]; 
сазе ЗТКВЕТ С$ТВ: гесигп 1рМаме.с5ег; 
} 
} 


Например, если указатель 1$ЗЕ на интерфейс 15$ веПРо!4ег создан, как опи-. 


сано выше в функции ЕогтСгезже, то следующий оператор запишет в метку 
Т.аБе!1 текст "Рабочий стол": 


Таре11->СарЕ1оп = МамеоЕГо14ет (Т$Е, МОТЪЬ); 


Теперь рассмотрим возможности организации цикла по элементам, распо- 
ложенным в папке. Для этого служит другой интерфейс папок — Епит- 
10Г1$. Получить указатель на него можно с помощью метода ЕпатОЩес{$ 
интерфейса ТЗвВеПЕо@4ег: 


НВЕЗОГТ 5ТРМЕТНОРСАЬЪЬТУРЕ ЕпомОБ}] есе$ (НИМО Бмипа, 
ЗНСОМТЕ ахЕЕ1адз, ТЕпаштроЬ1$е **ррепиптТр1Г1$6) = 0; 


Параметр В\и@ — дескриптор окна, параметр ррепип!1!ОТ.15 — возвра- 
щаемый методом указатель на интерфейс Епит ОТ1$%, а параметр г ая$ 
является сочетанием флагов, указывающих, что именно’должно включаться 
в список элементов папки. Эти флаги могут быть с: тедующими: 


ие тит 
ЭНСОМТЕ_ ЕОГРЕВ$ папки ОИ И 


ЭНСОМТЕ_ МОМЕОГОЕЕ$ ‘файлы. и ярлыки 1 (не папки) | | 


ЗНСОМТЕ_ УСГОРЕНТШОЕМ | | невидимые объек гы 
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Приведем в качестве примера функцию, продолжающую приведенные 
выше примеры и обеспечивающую отображение всего списка элементов ука- 
занной папки ЭВе|Еоаег в окне Мето1. 

Для начала введем данную функцию в класс формы (добавляем в заголо- 
вочный файл строку, выделенную жирным шрифтом): 

с]аз5 ТКогм1 : рир11с ТРогм 


{ 


рг1уафе: // ПОзег аес1агаЕ1оп$ 
уо1А Г15ЕОЕГо1Ааег (Т5е11Го14ег *5}е]11Го14ехг,. 
Сага1па1 Е1ад$); 


риЮ11с: _ ИХ 05егк аес1агаЕ1оп$ 


}; 
Теперь описываем саму функцию в файле „серр: 


. \ 
\01Я ТЕогшм1: : 1$ ОЕРГо1аек (1Т5Ве11ЕГо1Ааег *5ре11Го1аех, 
СагЯ1па1 Е1ааз = УНСОМТЕ _РГОГОЕБ$ | 
ЗНСОМТЕ МОМЕОТГОЕВ$ | $УНСОМТЕ_ТМСЬОБЕНТРОРЕМ) 


ТРТТЕМТОЬТЗТ р1а1 = №11; 
ип51ареа 1опа Мам; 
ТЕпоюТ0Ь1$е *Епоп; 


Мепо1->С1еаг(); 
5Ре11Го1аег->ЕпимОБ)есе$ (Напа1е, Е1адз$, &Епим); 
Чо 


{ | 
Мемо1->Т1пез->Ааа (МапеоЕГо1аег (5№е11ЕГо1аег, р141)); 


} 
мр11е (Епам->Мехеё (1, &р1а1, &Мим) == $5 ОК); 
} 


Параметр Е1а5$ определяет, что именно будет входить в список. По умол-. 
чанию в этот параметр включены все флаги, так что вызов функции может 
иметь вид: 


ТЗ ОЕРО1аег (15Е); 


Если считать, что это продолжение рассмотренного ранее примера, то та- 
кой оператор обеспечит отображение всего содержимого корневой папки. Если 
же вызвать функцию, например, ‚оператором 


156 ОЕЕГо1Аег (Т5Е, ЗНСОМТЕ_ РГОЬРЕВ$); 


то в окне Мето1 отобразятся только папки: обычные и системные. 

Функция 11$ ОЁРо]4ег обеспечивает методом ЕпитОБ]ес{$ доступ к интер- 
фейсу Епит типа ТЕпит ОТ 1$6. Далее для продвижения по списку элементов 
используется метод Мехё интерфейса Епит ОТ $, перемещающий РОГ 
к следующему элементу. Вторым аргументом этого метода указывается адрес 
массива, в который метод заносит указатели РТОГ. Первый аргумент указыва- 
ет размер этого массива. В данном случае этот аргумент задан равным 1, так 
как переменная р14! — не массив, а всего одна структура. Последний аргу- 
мент — переменная, в которую заносится число возвращенных идентификато- 
ров. В данном случае это число всегда равно 1, но синтаксис требует отвести 
для него переменную. | 

Пока результат, возвращенный методом, равен 5_ОК, цикл повторяется 
и имена элементов, полученные описанной выше функцией МатеОЁРЕо1Фег, за- 
носятся в окно Мето1{. Хочу еще раз обратить ваше внимание на то, что опи- 
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санная функция 11$ ОЁЕо]4ег будет работать только как продолжение начато- 
го выше описания примера, т.е. в совокупности с функцией МатеО{!РоФег. 

В приведенном примере указатели РТОГ получались последовательным 
просмотром списка папки. Имеется также функция ЭНСбе Зреса1Ео4ег- 
Госайоп, которая возвращает РТОГ, системных папок. Эта функция объявлена 
следующим образом: 


$НОТОАРТ $НСеебрес1а1Ео1аегГоса®*1опт (НИМР Бипа, 1пе пРоТаег, 
ТРТТЕМТОТ15Т *рр141); 


Параметр В\п@ — дескриптор окна вызывающего приложения. В пара- 
метр рр19 возвращается РТО... А параметр пЕо]!4ег определяет ту системную 
папку, к которой требуется доступ. Этот параметр может принимать следую- 
щие значения: 


[стог ВТТВОСКЕТ_ |" Корзина". Местоположение этого каталога не 
‚заносится в реестр, а сам каталог имеет атри- 


буты системного и невидимого, чтобы пользо- 
‚ватель случайно не переместил и не удалил | 


его | 
С5ГЕ_ СОМТЕОт.$_ ПИ _|“ `Панель: управления' " — виртуальная папка. 1. 
с$тт,_ РЕКТОР | __ | Корневая т папка. 


А що. —_ — УД, 


С5ТОГ _РЕЗКТОРЬВЕСТОКУ "Рабочий стол” — системный каталог, содер- ‘ 
‘жащий то, что размещено на экране. Не ‘следу-_ 
‚ет путать этот каталог с корневой папкой. 


д щ-. и -- -—— -— --—4 


С5ТОГ. ОВТУЕЗ_ | 1 "Мой компьютер” - —- виртуальная папка. 


о НН ионы МИ о онаонаиИННННИИ 

С5ШГ_ЕОМТЬ “Шрифты” — виртуальная папка. — 

амБв р тт — 7 т 1 

СУШЕ _МЕТНООО Системный к каталог с объектами сетевого окру- | 
Я ОНИ 

 СТОГ_1 МЕТУОКК | В Сетевое окружение”. — виртуальная папка. | 

зол _ о 

| С5ТРЕ_РЕВЗОМАГ — “Мои документы" —- системный каталог. 

Мы мА 

10С5ТОГ. РЕТМТЕВ$ “Принтеры” — вирт ‘уальная папка. 

дм и ——— —_ и 

СТО РВОСКАМЗ Программы" — системный каталог, содержа- 

‘щий программные группы пользователя, кото- | 

_| рые, в свою очередь, являются системными 

каталогами. 

и ие 

С5ГОГ._ВЕСЕМТ О | “Недавние. докумен' гы" — системный каталог. | 

`СЗТОГ_ЗЕМОТО `"Зепа То" — 

_ЗЕМОТС о зе _ — систем гный каталог. ИИ 

| С5ШТ,_ЗТАЕТМЕМО | о | “Пуск” — ‘системный каталог. | 

СГ. ЗТАВТОР '”Автозапуск” — системный каталог пользова- 

я НИ 

`С5 С5ТЕ_Т! _ТЕМРГАТЕ$ Шаблоны — — системный каталог. | И 


Теперь рассмотрим демонстрационный проект (проект [5 йеИЕо@4ег в ката- 
логе ЕИез на диске, приложенном к книге), в котором используются все рас- 
смотренные и некоторые другие методы интерфейсов папок. Окно этого прило- 
жения показано на рис. 6.2. Оно содержит список 11$&Вох1 в левом верхнем 
углу, в котором в первый момент отображается содержимое корневой папки. 
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В окне Мето1 (справа) повторяются имена элементов папки (на рис. 6.2 они 
не повторяются, но об этом ниже). Если сделать двойной щелчок на строке 
списка 11$%&Вох1, содержащей имя папки, то в список и в окно Мето1 занесут- 
ся имена элементов этой папки. В метке Габе]1, размещенной над списком 
11$ Вох1, отображается путь к раскрытой папке ("Рабочий стол\Мой компью- 
тер” на рис. 6.2). Первая строка списка с надписью "Назад" позволяет при 
двойном щелчке на ней вернуться в предыдущую папку. 


Рис. 6.2 1Е' Работа с интерфейсом Е5Нейроет 

Де монстрационное Рабочий стол\Мой компьютер 

приложение во время : — _ 
выполнения Назад Принтеры и факсы 


|Панель управления Панель задач и меню "Пуск" 
1 Общие документы Свойства папки 
} Диск 3.5 [А:] Сетевые подключения 
5УСТЕМ [С:] Шрифты 
: ХР (0:) Администрирование 
Е: Назначенные задания 
Сканеры и камеры 
:] АдоБе С ага 
015ТА!В ([Н:] Почта 
Тезё$ на "основное (Му „!. Экран 
ПЕ --..- 4..5 --- ГА Система 
Установка и удаление программ 
Системные папки Язык и региональные стандарты 
АеаР!ауег 
Па нель управления У] Эстановка оборудования 
нете! Ор@ой$ 
Форма имен`-`----``-^^^``-?  Мгровые устройства 


| @ 5НВОМ_МОВМАЕ | Мышь 
С $НВОМ ИМЕОШЕЯ | 
‚ Г $НБОМ _РОВРАВЯМС. 


Выпадающий список СошфоВох1, размещенный под 11$ Вох1, позволяет 
отобразить в окне Мето1 содержимое одной из системных папок (они не рас- 
крываются щелчком в 11$ Вох1). На рис. 6.2 раскрыта папка «Нанель управ- 
ления». Поэтому строки в Мето] и в 1$ Вох] не совпадают. 

Группа радиокнопок Ва@10оСгопр1 в чисто демонстрационных целях по- 
зволяет выбрать форму представления имен папок и файлов. 

Ниже приведен текст этого приложения. 


Для начала приведем описание класса: 


с1аз$ ТГогт1 : руаб11с ТЕГогм 

{ 

_ ручр11зВеа: // ТРЕ-тападея СотропепЕз 
рг1уа*е: // ПОзег аес]агаЕ1ол$ 


\о1а 156 ОЕЕГо1аег (Т5ре11Ео14ег *51е11Ео1аег, 
Сага1па1 Е1ааз); 
Апз15Ег1па МамеоЕРГо14ег (Т5ре11Го1Аег* $5е11Ео1аег, 
ГРТТЕМТОЬТ$ЗТ р1а1); 
руЮ11с: // ПИзек аес]ага®1оп5$ 


}; 
В нем даны описания двух используемых в приложении функций: 11$ 01- 
Ро]4дег и МатеОГЕо]4ег. Теперь перейдем к самому коду: 


6.2 Папки и их интерфейсы 397 


//#1пс1иае <ус1.№>//опять же обратите внимание 
| //на отключение файла ус1.В 

#1пс1а4е <$60634а1.Н> 

#10с1аае <$561051.8> 


ее яеннненнненннн-- 
//Объявление глобальных переменных 

ТЬ1$5еЕ *Ар1а1 = пем Т11$6; // список РТОГ текущей папки 
ТЬ15Е *АРГо1Чег = пем Т115$%; // список иерархии папок 


Боо1 11$ЕВох = &гае; 


Ап$15$г1лпа ТГогп1:; : МапедЕРГо1аег (Т$1е11Ео1аег* $1е11Ео1аег, 
` .РТТЕМТРЬТЗТ ‘р1а1) 
{ 
ОСТВВЕТ 1рМапе; 
РИОВР агЕЁ1адз; 
петзеф (&1рМаме, 0, $12еоЕ (1рМапе)); 
5м16сп (Ваа1обгопр1->ТеепТпаех) 
{ . 
сазе 0: ахгЕЕ1ааз = 5НСОМ МОВМАГ; 
БгеаКк; 
сазе 1: АхЕЕ1ачз = $НСОМ ТМРГОГОЕВ; 
ЬгеаКк; 
сазе 2: ахЕЕ1адз = 5НСОМ РГОВРАВ$ТМС; 
} | 


5Ре11Го1аег->беер15$р1ауМащеоЕ (р191, чгЕЕ1ааз, &1рМаме); 
$м1Еср (1рМаме.оаТуре) 


{ 
сазе УТВВЕТ ИЗТВ: гебигп 1рМаме.рО1е5ег; 


сазе ЗТВВЕТ ОБЕЗЕТ: гебагп р191->К14.аБто [1рмМаше. ОЕЕзее 
— $126е0Е (р191->мКк1а.сЬ)]; 
сазе З5ТВВЕТ_С$ТВ: хебагп 1рМаме.с5ег; 


%01А ТРГогм1 : : 51$ ОЕРо14ег (1$е11Ео14ег *5ре11Ес1аег, 
Сага1па1 Е1адз = УНСОМТЕ ЕОГОЕВ$ | 
ЗНСОМТЕ МОМЕОГОЕК$ | э5НСОКТЕ _ТМСЬОРЕНТРОРЕМ) 
{ 
ГРТТЕМТОЬТСТ р1а1 = №1; 
ип$1апеа 1опа Мам; 
ТЕпамТоТ1$е *Епом; 


1Е (111$5%Вох) 

{ 

Ар1а1->С1еаг(); 

15ЕВох1->С1еаг(); 

.1$ЕВох1->Т16емз->Ааа ("Назад"); 

} 
Мемто1->С1еахг(); 
5Ппе11ЕГо1аег->ЕпоамОБ)есе$ (Напа1е, Е1ад5, &Епам); 


ир11е (Епим->М№ехе (1, &р1а1, &М№им) == $_ОК) 
| 
Мето1->11пез->Ааа (МапеоЕРо1аег (5$1е11Ео1аег, ©14а1)); 
1Е (1115ЕВох) 

{ 

Ар1491->Ааа (р141); 

115Вох1->Т&етз->АаЧа (МашеоЕЕо1ает (5Ве11Ео14ег, р1а1)); 
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\о1а 


{ 


__Фаз®са11 ТЕГогш1: 


1Т5ре11ЕГо1Ааег * Т5Е; 


{ 
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: ГогиСгеафе (ТОБ]есЕ *5епаег) 


1Е (5НСсеерезКеорРо1аег (&15Ё) != МОЕВВОВ) 


Ап$156г1па 5="Корневая папка недоступна"; 
Арр11са*1оп->МеззадеВох (5.с_зЕг(), "Нет доступа", 
МВ ОК | МВ_ТСОМЕХСТАМАТТОМ); 


} 


е1зе 


{ 


АГо1Аег->ААа (Т15Е); 


} 
} 


\о1а 


{ 
ТРС 


__ Еазфса11 ТЕОГТ : 


ТТЕМТРОЬТСТ р19а1; 


ОЪОМС ЕТадз; 
15Ве11РГо1аег *1Т5Е1; 


1Е 
{ 
15 


Ъ15ЕОЕРГо1аег ( (Т5Ве11РГо1аег *)АГо1аег->Теетз[0]); 


ии ИИ НИ еее 


:1$6Вох1061С11сК (ТОр]есе *Зепаег) 


(115ЕВох1->ТЕешТраех > 0) 


Е1= 


( 
р1а1 = (.РСТТЕМТРОЬТЗТ 
Е1]1ааз = 


ЗЕСАО РОГОЕВ 


Т5ре11Ео1аехг *) АРГо1аег->Т&епмз$ [АГо1Ааег->СоппЕ - 1]; 


) Ар1а1->Теемз [11$ЕВох1->ТсепшТпаех - 1]; 
| СЕСАО ЕТЬЕЗУЗАМСЕСТОВ; | 


1Т5Е1->СесАЕек1роаеезоОЕ (1, &р1а1, &Е1адз); 


1Е 


{ 


(((ЗЕСАО ЕОГОЕВ & 


Е]1ачз) != 0) && 


((ЗЕСАО ЕТЬЕЗУЗАМСЕЗТОВ & Е1адз) != 0)) 


Тафе12->СарЕ1оп = Гафе12->СарЕ1оп + "\\" + | 
МатеоЕГо1аех ( (Т5ре11Го1аег *) АРГо1аег-> 


ТЕемз$ [АРо] аег->СоопЕ - 11], 
(.РТТЕМТОЬТЗТ)р1а1); 


1$Е1->В1паТоОБ)ес® (р1а1, МО, 


АРо1Аег->Ааа (1$Е1); 
11$ ОЕРГо1аег (15Е1); 


} 


е15е 


{ 


} 
} 


Ап$156е1па 5 =" \' 


ТТО_Т5ре11РГо1аек, & (.РУОТР) (1$Е1)); 


"+ МатеоЕГо19аехк (Т5Е1, 


(ТТРТТЕМТОЬТ$Т)р1а1)+ "' не папка"; 
Арр11са*1оп->МеззадеВох ($.с_ зе г(), 


е1зе , 
1Е (АГо1Аег->СозрЕ 


{ 


"Раскрывать можно только папки",МВ_ ОК | 
МВ _ТСОМЕХСЪАМАТТОМ); 


// если выбрана строка "Назад"_ 


>1) 


Ап515Е:1па $ = Гае12->Саре1оп; 


Таре12->Саре1оп = 


5. зееьепаеП (Таз&Ре11т1*ет ("\\", 5)-1); 


АРГо1Аег->ре]1ете (АГо1Аег->СоцпЕе - 1); 
1$Е1= (15ре1]РГо1аег *) АРГо1Аег->ТЕемтз$ [АГо] аег->Сооп® - 1]; 
1 $ЕОЕРо1аех (1$Е1); 
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} 

е1зе Т1$ЕОЕГо1аег ( (Т5Ве1]РГо1аег *) АРГо]Аехг->Теептз[0]); 
} | | | 
не ннннннннннннннн+================-== 


10 пРо1аег; 
ТРТТЕМТОЬТ$ЗТ р1а1; 
Т5ре]11РГо]1аег *1Т$Е]1; 


$5м1Еср (СопроВох1->ТЕепТпаех) 


{ 
сазе 0: пРго1Аек = С$5ТОГ ВТТВОСКЕТ; 


ргеакК; 
сазе 1: пРГо14Аег = С$ТОГ СОМТВОГЬ5; 
ргеак; | 
сазе 2: пГо1аег = С5ТОЬ РЕЗКТОРОТВЕСТОВУ; 
ргеак; 
сазе 3: пРго1аег = С$5ТОЬ РОВТУЕЗ; 
ргеаКк; 
сазе 4: пРо1Аег = С5ТОЬ РОМТ$; 
ргеак; | 
сазе 5: пЕго1Аег = С$5ТОЪ МЕТНООВ; 
ргеак; | 
сазе 6: пго1аег = С5ТОЪ МЕТМОВК; 
_геаКк; | 
сазе 7: пГо14Аег = С5ТОГ РЕВЗОМАГ; 
ргеаКк; 
сазе 8: пГо14ег = С5ТОЪ РВАТМТЕВ$; 
ргеак; 
сазе 9: пГго1аег = С5ТОЬ РВОСВАМ5; 
ргеак; 
сазе 10: пРо1аег = С5ТОЬ ВЕСЕМТ; 
ргеак; 
сазе 11: пРо1Аег = С$ТРЬ ЗЕМОТО; 
_ фгеак; 
сазе 12: пго14ег = С$ТРЬ ЗТАВТМЕМО; 
ргеак; 
сазе 13: пГо14ег = С$5ТРЬ $5ТАВТУОР; 
ргеаКк; 


сазе 14: пРо14ег = С5ТОЬ ТЕМРЬАТЕ$; 
} 


$Нбеебрес1а1ЕГо1АегГоса®1оп (НапЯ1е, пРо14ег, &р1а1); 

((15ре11Ео1аег *) (АГо]аег->Теетз [0])) ->В1паТооБ]ес® (р1а1, 
| МОЪЬ, ТТРЬ Т5ре11Ро1аег, & (БРУОТР) Т$ЕТ); 

т15ЕВох = Еа1$е; 

11 $ ОЁКо14ег (15Е1); 

.Г1$ЕВох = гие; 


У01а __Еаз®са11 ТЕогт1: :Арр11сас1опЕуепе $1 5НомН1 пе ( 
Апз156г1лпа &Нтпе5ег,Юоо1 &Сап5ром, ТНапЕТпЕо &НлпЕТпЕо) 
{ | | 
ТЕ ((НапетпЕо.НапЕСопЕго] == 115$6Вох1) && 
(11$ЕВох1->Т$бем1Тпаех >= 0)) 
1Е (Табе11->Сапуаз->ТехЕй1аен (11$5ЕВох1->Т6ем$-> 
ЗЕ х1па$ [11$ЕВох1->Т$бепТпаех]) > 113$&Вох1->С11епЕМ1аер) 
{ | 
НарпЕе5Ехг = 1$6Вох1->Т$бепз->5Ег1паз [11$ЕВох1->Т6епТпаех]; 
Арр11сае1опЕуепе$1->Сапсе1015раесП (); 
} 
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Среди модулей, подключенных директивой #ти4е, имеются ЗВОБЛа.Л 
и 5НОБ:.й, содержащие определения используемых интерфейсов и функций. 
В классе формы объявлены две функции МашеОЁ!Ро!4ег и Г45 ОЁЕо1@ег, обес- 
печивающие отображение содержимого указанной папки. Объявлено несколь- 
ко глобальных переменных. Ар!9 — объект типа Т11$%, который хранит РШГ. 
всех элементов папки в той же последовательности, в которой их имена занесе- 
ны в список 11$&Вох1. Это позволяет при щелчке пользователя на строке спи- 
ска [1$ Вох] сразу определить РТОГ выделенного элемента, не тратя времени 
на его поиск. АРо]4ег также является объектом типа Т14$%. В нем хранится 
последовательность интерфейсов раскрытых папок. Это позволяет легко пе- 
рейти к предыдущей папке при щелчке пользователя в списке 11$%Вох1 на 
строке “Назад”. Переменная 1.1.15Вох определяет, надо ли заносить имена 
элементов в список [15$&Вох1. Значение этой переменной почти всегда фгае, за 
исключением выбора пользователем системной папки в списке СошфоВох1. 

Перейдем к рассмотрению функций приложения. Функция МатеО?Ео]- 
ег, возвращающая имя элемента р! папки Эве|ПЕРо]4ег, уже была описана 
ранее в этом параграфе с некоторыми упрощениями. Отличие от предыдущего 
описания заключается только в том, что данном варианте анализируется со- 
стояние группы радиокнопок Ва41оСгоир1, и определяется флаг эх Е 1а5$, за- 
дающий формат возвращаемого имени элемента. 

Функция Г$ОЁРо ег, обеспечивающая отображение списка элементов 
папки Эве|Ео]4ег с флагами Е1а5$, также была описана ранее в этом парагра- 
фе. В данном варианте функции отличия сводятся к тому, что при Е11$Вох = 
фгие заполняется списки 11$ Вох1 и Ар!41. Сначала список 14$&Вох1 очищает- 
ся и в него заносится первая строка “Назад”. Список Ар! свертывается. А 
в цикле для каждого элемента его имя добавляется в 11$4Вох1, а его РОГ за- 
носится в Ар! 41, размер которого увеличивается на 1. 

Функция ЕогтСгез{е является обработчиком события ОпСгезжфе формы. 
В нем вызывается функция 5Нбе ОеК%4орЕо!4ег. После вызова интерфейс 
корневой папки заносится в переменную 1ЗЕ типа 5ве|Ео]4ег. Далее ее ука- 
затель заносится первым элементом в список АРо]4ег. После этого вызывается 
описанная выше функция 11$ ОЁЕо]4ег, отображающая список элементов кор- 
невой папки. 

Функция 11$Вох1РЫСПеК является обработчиком двойного щелчка на 
списке 11${Вох1. Если индекс 11$Вох1—>Цет тдех > 0, значит, пользователь 
щелкнул не на первой строке списка. Тогда РТО выбранного пользователем 
элемента извлекается из списка Ар!4! по индексу, уменьшенному на 1 из-за 
наличия в списке 11$&Вох1 первой строки “Назад”. Затем для проверки, явля- 
ется ли выбранный элемент папкой, содержащей какие-то элементы, исполь- 
зуется ранее не описанный метод Се АЙгЬще$ ОР интерфейса 1$Ве!Ео@ег. 
Он позволяет определить атрибуты элемента папки. Объект, для которого 
в процедуре вызывается этот метод, является последним элементом списка 
АЕо@ег, т.е. текущей папкой. Первым аргументом метода Се АЙгЬще$ ОЁ 
указывается число элементов, атрибуты которых требуется определить. В дан- 
ном случае требуются атрибуты только одного элемента. В качестве второго 
аргумента в метод передается указатель на РТОГ элемента. А третий аргумент 
является одновременно входным и выходным. При вызове метода в этот аргу- 
мент заносятся флаги, определяющие требуемую информацию (их можно и не 
заносить, но указание флагов, которые желательно получить, ускоряет опера- 
цию). В данном случае указано два флага: ЗЕСАО_ ЕОГОЕК — определяет, 
что элемент является папкой, и ЗЕСАО ЕПЕЗУЗАМСЕ$ТОВ — определяет, 
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что папка имеет вложенные файловые структуры. Метод имеет еще много фла- 
гов, которые вы можете посмотреть во встроенной справке С++Ви!аег. После 
вызова метода де АИгЬще$ ОЕ в тот же третий параметр возвращается инфор- 
мация о наличии или отсутствии затребованных флагов. Наличие того или 
иного флага проверяется операцией &. Если хотя бы одного из интересующих 
нас флагов нет, в функции выдается сообщение о том, что выделенный пользо- 
вателем элемент — это не папка, которую можно раскрыть. А если оба флага 
имеются, то происходит следующее. Текст метки Габе]2 дополняется обрат- 
ным слэшем и именем открываемой папки, получаемым уже рассмотренной 
функцией МатеО!ЕРо!4ег. Далее методом ВшАаТоОЦес{ определяется и зано- 
сится в список АРо!4ег интерфейс этой папки. Метод вызывается для объекта 
15Е1= (5ве|ЕРо@ег *) АРо]4ег->Цет3[АЕо]4ег->Соцпё - 1], т.е. для теку- 
щей папки. В качестве первого аргумента в метод передается РТОГ интересую- 
щего элемента этой папки. Второй аргумент метода не используется и. в него 
передается МОГГ. В качестве третьего аргумента записывается идентифика- 
тор интерфейса, который требуется получить. В данном случае это 
ПО Т5ве|Ео]Чег — идентификатор интерфейса Т5впе|Ро!@ег. А последний ар- 
гумент — это указатель на объект, в который возвращается затребованный ин- 
терфейс. В данном случае это последний элемент списка АРо]@ег, или в наших 
обозначениях — переменная 1$ЗЕ. 

Мы рассмотрели, что происходит в функции при выборе пользователем 
папки или файла. Осталось рассмотреть операции при выборе пользователем 
строки “Назад”. Если в этот момент текущая папка не корневая (проверяется 
по максимальному индексу списка АЕоег), то длина списка АЕРо!4ег умень- 
птается на 1. Тем самым последним элементом его становится интерфейс пре- 
дыдущей папки. Соответственно усекается и надпись метки Гафе]2: из нее уда- 
ляются символы, начиная с последнего символа "\" (его позиция определяется 
функцией Га${Ое|йшЁег). Затем для папки, которая стала последней в списке 
АЕо!4ег, вызывается функция 11$ ОЁ!Ро]!4ег, отображающая список элемен- 
тов. Эти операции производятся, если текущая папка не корневая. А для кор- 
невой папки все действия ограничиваются вызовом 115$ ОЁРЕо]@ег. 

Перейдем теперь к рассмотрению функции СошфоВох1С]озе Ор, срабаты- 
вающий после выбора пользователем строки из списка СотфоВох1. В этот спи- 
сок во время проектирования занесены строки: 

Корзина 

Панель управления 

Рабочий стол 

Мой компьютер 

Шрифты 

Сетевые файлы 

Сетевое окружение 

Мои документы 

Принтеры 

Программы из главного меню 

Недавние документы 

Переслать (5епа $о) 

Пуск 

Автозапуск 

Шаблоны 


В начале процедуры СотБоВох1СозеОр анализируется индекс списка 
и формируется переменная пЕо]4ег, передаваемая в качестве второго аргумен- 
та в описанную ранее функцию 5НСбе{Зреса1Ео]ЧегГ.осаЙоп, возвращающую 
в переменную р1 4] указатель РТОГ выбранной пользователем системной пап- 
ки. Этот РТОГ относится к корневой папке. Поэтому именно для этой папки 
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(т.е. для АРо|!4ег—->Цет$[0]) вызывается рассмотренный в предыдущей проце- 
дуре метод ВшАаТоОес+. Он возвращает в переменную 13Е1 интерфейс затре- 
бованной папки. А затем все той же процедурой Т1$ОЁЕо]4ег отображается 
в окне Мето]1 список элементов папки. Только при этом задается 111$ Вох = 
Га]5е, чтобы не испортить списки, хранящиеся в 11$ Вох] и в Ар! 41. 

Последняя функция приведенного кода АррПсайопЕует{ 515 Бом НШ яв- 
ляется вспомогательной и обеспечивает отображение во всплывающем ярлыч- 
ке длинного текста выделенной строки списка 11$Вох1, который может быть 
не виден целиком в окне списка. Описание подобных функций см. в разд. 5.1 
в гл. 5. 

Приведенный пример показывает, как можно исследовать содержимое 
обычных и виртуальных папок. 


6.3 Преобразование РИОЕ в путь 


В предыдущем разделе рассмотрена работа с папками с помощью интер- 
фейса ЗвВеПРо!4ег. Но часто для последующего применения требуется знать 
не указатель идентификатора РТОГ, а обычный путь к папке файловой систе- 
мы. Имеется функция $Н@беРа{ЕготГОТ1$, позволяющая получить путь 
к папке файловой системы по ее РТОГ. Эта функция объявлена в файле 
У5НОБ:.й следующим образом: 


ЗН5ТОАРТ_(ВООЪ) ЗНбеЕРа®ВЕкомТрТ15$6 (.РСТТЕМТРЬТЗТ раа\т, 
.РСОТВ рз2РаЕП); 


Функция возвращает фгие в случае успеха и заносит в этом случае найден- 
ный путь к папке в буфер р57Раё В. Если же параметр р! соответствует вирту- 
альной папке, не входящей в файловую систему, или этот параметр вообще за- 
дан неверно, то возвращается Ёа1$е. 

Если папка является корневой на диске, то путь заносится с завершаю- 
щим обратным слэшем. Например, “С:\". В остальных случаях завершающий 
слэш отсутствует. Так что если он нужен, его надо добавлять программно. 

Функцию, преобразующую РТОГ в путь с заключительным слэшем можно 
организовать следующим образом. 


Апз15Ег1па РТОГТоРа®р (ГРСТТЕМТРЬТ$Т р1а1) 


{ 
спаг РафН [МАХ _РАТН]; 


1Е (5НсбееРаеВЕгомТрЬ1$е (раа1, Рае|) ) 


{ 

1Е (Рабр[5Ег1еп (Раф) -11 != '\\') 
ЗЕгСаф (Раб, "\\"); 

} 

е1зе Рав [0]= '\0'!; 

тебигп Ап$156г1па (Ра®р); 


} 


В функцию передается РТОГ папки через параметр р191. Если функция 
5Н@е Ра Егош 0 Г1$ выполнилась без ошибки, то проверяется, равен ли по- 
следний символ массива РаёВ символу "\". Если не равен, то он добавляется 
в конец строки. Если при выполнении функции $Нбе Ра ®Егот 0Г1$4 про- 
изошла ошибка, то приведенная функция возвращает пустую строку. 

Далее приведен пример (см. рис. 6.3), показывающий использование данной 
функции на практике. Добавьте на формуМето]1 и ВиЙоп1. По щелчку на кноп- 
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ке в Мето1 должен заноситься список путей доступных папок и файлов в корне- 
вой папке. Обработчик щелчка на кнопке может выглядеть следующим образом: 


уо1А _ Еаз&са11 ТЕГогш1: : Ви ®оп1С11ск (ТОр]есЕ *5епаехг) 

{ 

ГРТТЕМТОГТ$Т р;. 

Ап$156г1па $="!; 

ип$1апеа Топа Мим; 

Т5$Бе11РГо1аег * Т5Е; 

ТЕПИмТОГ1$е *Епим; 

5НбсесрезКеорЕго1аег (&Т5Е); 

Т$Е->ЕпимОр)]есе$ (Напа1е, ЗНСОМТЕ РГОБОЕВ$ | 

ЭНСОМТЕ МОМРОБРЕК$ | ЗНСОМТЕ ТМСЬОБЕНТРЬРЕМ, &Епим); 


Мепто1->С]еак(); 
иВ11е (Епим->М№ехе (1, &р, &Мим) == $_ОК) 
{ 

$=РТОГТоРа®В (р); 

1 Е ($!="\) 

Мепо1->Г1пез->Ааа ($); 


Рис. 6.3 |6 =. Список папок и: файлов в корневой па . 

: | 100 оситет апд бенисз\я\Мои  окументьК, 
П рограмма Р Ра Кора | |О:\боситей апд бей таз\я\Рабочий стол\О на основное (Мусотр2)\ 
в момент выполнения | О :\боситег$ апд бейтдз\я\Рабочий стол\НовоепК\ 


 0:\Боситейб апд б5ейиоз\я\Рабочий стол\АцоР!а Мепи 5 дю 3.0иК\ 
|: О:\Ооситегт апд бевидз\я\Рабочий стол\НеГ\, 

| Ф:\Боситепб апд бейтоаз\я\Рабочий стол\СО\, 

{0:\Обоситейк апд Зе{тоз“я\Рабочий стол\\\Ипдои$ Соттапде! 32. "К 
| {О.\Воситет апд бевидз‘я\Рабочий стол\ Ярлык для МС.ЕХЕ р 

| Ф./\Боситейё апд Зеидз\я\Рабочий стол\Неиспользуемые ярлыки“ 


| :О.\Боситенё апд бешиодз\я\Рабочий стол\ мА р ДК, 

в О: \босцтейб апд бЗещиоз\я\Рабочий стол\Ярлык для ТС.ЕХЕ р 
 2:\боситеме эпд бешидз‘я\Рабочий стол\Мой компьютер. К“ 
`О:\боситетв апд бещиодз\я\Рабочий стол\Мстозой Меца! био МЕТ мк. 
О:\Воситетв апд Зе\идз\я\Рабочий стол \меБМопеу Кеерег. ик‘, 


Данный пример можно найти на приложенном к книге диске в каталоге 
ЕЦез под именем РРАЧПора1й. Возможные дополнительные варианты получе- 
ния РОГ папки рассмотрены далее в главе, в частности в разд. 6.5. 
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В разд. 6.2 было показано, как получить доступ к папкам, в том числе сис- 
темным, через их интерфейсы. Но есть и другой путь доступа к системным 
папкам — через информацию, хранящуюся в реестре. Информация о систем- 
ных папках хранится в ключе НКЕУ СУККЕМТ_ОЗЕК \ ЗоЙ\маге \ Мсгозой \ 
УМпдомз \ Ситеп!Мегзюп \ Ехр!огег \ ЗВе!! Ео!Зегз. В этом ключе хранится множест- 
во параметров. В частности, каталоги ряда системных папок хранятся в сле- 


дующих параметрах: 


—— — г: — п ЕЕ ие 


‚ Сасве | Временные файлы Интернета (Тетрогагу Пцегпеф ЕЦез) _ Е 


Иру и =—=—— ОД 


 Соо1е5_ Сооез —__ и 


ДезКор ‚Рабочий Стол | . И 
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РауогЦе$ _ | Избранное 

Еоп5 Шрифты _ 

Н15$фогу Н1$огу (История) 

Му Миз1е Моя музыка 

Му Р1ефигез Мои рисунки 

Ме Ноо4 Сетевые ресурсы (Сетевые файлы) 

Регзопа Мои документы 
Ргобгатз | Программы ОНИ 
осо Недавние документы 

ЗепаТо Переслать (БЗепАТо). 


ЭфагЕ ] Мепи 
ЭЗбагиар 


Главное меню 


Автозагрузка 


Тетр]афе$ Шаблоны 


Ниже приведен пример функции, возвращающей каталог папки, указан- 
ной именем параметра Рагат. 


#1пс1аае <Вед1$Егу.Врр> 


Ап$156г1па бузРо14ег (Ап$15Ег1па Рагам) 

{ 

ТВеч15Егу *гед = пем ТВед15&гу (КЕУ_ВЕАР); 
Апз15ег1па $,а; 


гед->КоосКеу = НКЕУ СОКВЕМТ О5ЕБ; 

а = "боЕЕмаге\ \М1скозоЕ* \ \М1паомз \ \Сиггепе\Уегз1оп\\" 
"Ехр1огег\ \5Ве11 РГо1аегз"; 

гедч->ОрепкКаеу (а, Еа1зе); 

$ = гед->Кеаабег1па (Рагапт); 


Четёее гед; 
гебагпр $; 


} 


Вызов этой функции может быть организован, например, следующим об- 
разом. Пусть на форме имеется компонент списка СошфоВох1, в котором запи- 
саны строки: 


Рабочий Стол 
Избранное 

Шрифты 

Шаблоны 

Главное меню 
Автозапуск 
Программы 
Недавние документы 
Мои документы 
Переслать (5епаТо) 
Сетевые ресурсы 
Мои рисунки 

Моя музыка 
Н1з$согу (История) 
СооКк1е5 
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Тогда обработчик события ОпСТозе0Р этого списка может выглядеть сле- 
дующим образом: 


\01а __Еаз®са11 ТГоги1: : СошроВох1С1озеЧр (ТОБ)есЕ *5епаек) 
{ 

Апз156г1па ЗРагаш, $501г; 

$м1Есп (СошроВох1->ТеетТпаех) 

{ 


сазе 0: бРагам = "ПБезКеор"; 
Бгеак; | 
сазе 1: бРагам = "Еауог1%ез"; 
Ьгеак; 
сазе 2: ЗРагат = "Еопф5"; 
| Ьгеак; 
сазе 3: бРагам = " Тепр1афез"; 
Ьгеак; 
сазе 4: ЗРагап = "5фаге Мепа"; 
ргеак; , 
сазе 5: бРагам = "5багЕар"; 
Ьгеак; 
сазе 6: ЗРагам = "Ргодгатз"; 
Ьгеак; | 
сазе 7: ЗРагам = "Весеп\ф"; 
ЬгеаКк; 
сазе 8: бРагам = "Рег5опа1"; 
Ьгеак; 
сазе 9: ЗРагам = "бепаТо"; 
БгеаКк; 
сазе 10: бРагаш = "МеЕНооа"; 
Ьгеак; 
сазе 11: ЗРагам = "Му Р1сфагез"; 
Ьгеак; 
сазе 12: бРагам = "Му Маз1с"; 
Ьгеак; 
сазе 13: бРагам = "Н156огу"; 
Ьгеак; 
сазе 14: 5Рагам = "СооК1ез"; 
Ьгеак; 


$01: = бузРго1аег (5Рагам) ; 


А далее с полученным каталогом $01: можно делать то, что требуется. На- 
пример, открыть его диалогом ТОрепПа10&, чтобы пользователь мог выбрать 
в нем какой-то файл или подкаталог: 


Орепр1а1о391->Е11еМаме = $01к + "\\*.*"; 
1Е (Орепр1а1о0о91->Ехесиее ()) 


ег 


Можно открыть диалог выбора папки З@ес&О1гесфогу (см. разд. 6.5). Для 
этого следует подключить файл ЕИеС11.йрр: 


#1пс10ае <Е11еС®г1.Прр> 


бе1ес*0)1гесвогу ("Выберите папку", $01:, 01т); 


Причем в данном случае пользователь не сможет в диалоге выйти за преде- 
лы указанной папки. 
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6.5 Диалоги выбора папок 


Нередко в приложениях надо предоставить пользователю возможность вы- 
брать в стандартном диалоге папку. Это можно сделать с помощью функции 
АРТ У/п4омз Зее П1гесогу, которая объявлена в файле РГИеСН1.Йрр следую- 
щим образом: 

6оо1 _ Еазеса11 5е1ес®Р1гесвогу (сопзе Апз15Ег1п9 


Сар*1оп, сопзЕ И1АебЕег1па Воос, 
Апз15Ех1па &01кескогу) /*оуег]оаа */; 


роо1 __Еазеса11 5е1есер1гесфогу ( 
Ап5156г1па &01гесеогу, Т5е1есер1кЕОре$ ОрЕтоп$, 
106 Не1рСех)/* оуег]1оаа */; 


Функция Э@ес ПО 1гесогу предоставляет пользователю возможность вы- 
звать стандартный диалог \/114о\з и, работая с ним, выбрать каталог. Функ- 
ция имеет две перегруженных формы. Остановимся сначала на первой форме. 

Эта форма функции вызывает стандартный диалог У/Лшо\з для поиска 
каталога (папки) — см. примеры рис. 6.4 а) и б). Параметр СарНоп содержит 
строку, отображаемую в диалоге как указание пользователю (текст “Укажите 
каталог установки программы" на рис. 6.4). Параметр Воо%ф задает корневой 
каталог, внутри которого пользователь может выбирать подкаталоги. За пре- 
делы каталога В,оо%ф пользователь выйти не может. При вызове Э@ес О1гесфогу 
в примере рис. 6.4 а) указано Воо* = “{:\". Если указать вместо В00% пустую 
строку или отсутствующий на компьютере каталог, то в диалоговом окне ото- 
бразится дерево всех папок (рис. 6.4 6) и пользователь имеет возможность вы- 
брать на любом диске любой каталог. 


Е) Обзор папок й В о $13 6) ЕВ 


укажите каталог установки программы 


Укажите каталог установки программы 


2 2 ТЕЗТО (Е:) 

$ 5) СОЕхатро 

12 =) РАТАВАЗЕ 

:. 2} РОМ 0.000 

5) НЕ 

3 ре Мп 

- 3) ВЕСУСЕО 

+.) сужет Уоуте фоитавоп 

И 

-. 3 ТеяЕхатр 
+3 Свое! 


= В 


13 ДегАме 


= {7 Рабочий стол 

+ 13 Мои документы 

+ Мой компьютер 

№ Е. Сетевое окружение 

в = зд Вся сеть | 

+ $9 МегозоЁЕ МАпои$ МевиуогК, 
+9 \\"еБ Сйепе МевумогК 
: &9 Службы терминалов Мегозой: 
с на основное (Мисотр2 | 
с9-Ып на пусотриёег (Мусотр\ ег) | 
га-Ыпд на пусотривег (Мусотриег) 
РепгоТаН ель! нА ппсооги Нок ИМ "| 


АЯ: 


› 


Программа расположится в каталоге: 


[РА еЕ хатр\ ЕХАМРЕ 
сажа | 


Рис. 6.4. Диалоги при выборе папки первым вариантом функции 5аес<{Отес{огу 
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Выходной параметр ПОгесвогу содержит результат выбора пользователя. 
Функция возвращает фгае, если пользователь выбрал каталог и нажал ОК. 
Если пользователь нажал Отмена или закрыл каталог, не произведя выбора, то 
функция возвращает #а$е. 

Пусть, например, вы делаете программу установки вашего приложения 
и хотите, чтобы пользователь указал каталог, в котором надо установить про- 
грамму. Соответствующий диалог можно оформить следующим образом: 


#1пс1а4Ае <ЕР11еСехг1.Врр> 


Ап5151 па 21г; 


1Е (5е1есЕер)1гес®огу ("Укажите каталог установки программы ", 
"", 21 у) ) 
21х = Тпроа®Вох ("Можете уточнить каталог", 
"Программа расположится в каталоге: ', 01и); 
е1 зе 


{ 
Арр11сае1оп->Ме$задеВох ("Вы не указали каталог", 
` "Установка прервана !", МВ ТСОМ$ЗТОР); 
Арр11саЕ1оп->Тегт1паее (); 


} 


Прежде всего, обратите внимание на необходимость подключения файла 
ЕИесн1.йрр. Автоматически этот модуль не подключается. 

В данном примере вызов функции ЭЗ@аес О1гесфогу приводит к появлению 
окна, представленного на рис. 6.4 6, поскольку параметр В,00% указан пустой 
строкой. Если пользователь выбрал каталог и нажал ОК, то З@аес О1тгесфогу 
возвращает фгие. В этом случае пользователю предлагается диалоговое окно, 
вызываемое функцией шри& Вох. Оно показано на рис. 6.4 в. В этом окне поль- 
зователь может, если хочет, уточнить каталог. Если же пользователь в окне 
рис. 6.4 б не выбрал каталог, то функцией МеззагеВох вызывается окно, пока- 
занное на рис. 6.4 г, и установка прерывается. 

Вторая форма функции З@ес+П1гесфогу предоставляет более гибкий диа- 
лог (см. рис. 6.5). Возвращаемое значение, как и в первой форме функции, 
указывает, выбрал ли пользователь каталог. Параметр О1геефогу содержит вы- 
бранный пользователем каталог. Если перед вызовом З@аес& Ю1гесфогу задано 
начальное значение Огесфогу, то именно этот каталог будет раскрыт в окне 
диалога в первый момент времени. Параметр НерС&х является ссылкой на 
контекстную справку, содержащую подсказку по действиям пользователя. 
А параметр ОрНоп$ является множеством следующих опций: 


| ‚заАПо\Сгеаце_ `В диалоговом окне отображается окошко редактирования 
| Онесюгу Мате (см. рис. 6.5), в котором пользователь может , 
'написать каталог, который отсутствует. Эта опция не созда- ! 
ет сам каталог. Это задача приложения, которое прочтет 
имя каталога и при необходимости создаст его. 


о. . — 2... .1 


‚ зРегРогиСгеаве Применяется только в сочетании с заАПо\Сгеме и обеспе- 
|  чивает создание каталога, если указанный пользователем 


| каталог алог отсутствует. 
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————_ ГЕН. = о чье ив ити 


И ИНН - ИИ — ОНИ 
5аРготрё Применяется только в сочетании с $9АПомСгезфе. Если по- 


льзователь указал несуществующий каталог, ему предлага- 
ется вопрос, надо ли его создавать. Если пользователь отве- 
тил утвердительно (нажал ОК) и опция $4РегЁогтСгеа{е 
включена в множество Орйоп$, то каталог будет создан. 
‚ Если же опция $АРегогтСгеафе не задана, то приложение 
должно само создать нужный каталог. 


Если множество ОрИоп$ пустое, то пользователь не может указать ката- 
лог, которого не существует. 


Рис. 6.5 бейесЕ Отескоу —— 
Диалог при выборе папки вторым Отескиу Мате: 
вариантом фун кции 5@ес{Отестогу [ОАРодтат РАез<\Воцай\СВийдег6\Нер 


Оиесюопез; Рес: [*.*] 
=> 0 баян пи 
(=> Ргодгат Ейез КАБО 
(> Войапд 
(> СВуЧеб 


е) ИХ вом_Нер 
Е) 1555 Огуез: 


Г 9: [+2] "| 


Если вы хотите реализовать рассмотренный выше пример выбора каталога 
установки программы с помощью второй формы функции Э@ес ПО !гесфогу, то 
начало кода может иметь вид: 


#1пс10оае <Е11еСег1.Врр> 


Ап$15Ег1па О1г; 

21г="С:"; 

1Е (бе1тесЕер1гескокгу (01г, Т5е1ес®р1гОре$() << заА11]омСгеаее << 
зЧРегЕогтСгеа®е << заРгопр®,0)) 

{ 


_} 


В этом коде задается начальное значение каталога и в параметр ОрНоп$ 
включены все опции: $39ЧАПомСгеафе, заРег!огтСгезж{е и $аРготр+. Вызы- 
ваемое диалоговое окно подобно приведенному на рис. 6.5 и не будет иметь 
кнопки Нер, поскольку идентификатор контекстной справки задан равным 
нулю. 

Если пользователь напишет в окошке редактирования Опесюгу Мате ката- 
лог, который отсутствует в дереве, ему будет предложено окно запроса, пока- 
занное на рис. 6.6. Если пользователь нажмет в нем Мо, то вернется в предыду- 
щее окно. Если же он нажмет \е$, то отсутствующий каталог будет создан. 


Рис. 6.6 
Окно запроса о создании нового каталога 
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Как видно, вторая форма функции З@аес ПО1гесфогу дает дополнительную 
гибкость диалогу. Но она имеет существенный недостаток: окна, которые она 
отображает, содержат английские тексты. От окна запроса на создание катало- 
га, безусловно, лучше отказаться. Если допустимо создание нового каталога 
без дополнительного запроса, то следует задавать значение свойства ОрНоп$ 
равным [$3ЧАПомСтгезжфе, заРегГогтСгеа*е]. Если же запрос все-таки нужен, то 
лучше задать Орйоп$ равным [$9 АПомСгеа{е], а запрос и создание каталога 
обеспечить программно с помощью ранее рассмотренных средств. Так что от 
английского окна запроса избавиться несложно. Но с английскими надписями 
в основном диалоговом окне сделать ничего невозможно. 


Имеется еще одна функция, обеспечивающая вызов диалога выбора папки — 
эНВгомзеЕогЕо!ег. Диалог, вызываемый этой функцией, подобен приведенно- 
му на рис. 6.4. Функция объявлена в файле ЗОБ. следующим образом: 


З5НЗТРАРТ (ТРТТЕМТОЬТ$Т) $НВгомзеЕогРГо]1Аег (ГРВКОИЗЕТМЕО 1рЬ1); 


Функция возвращает РТОГ. (см. разд. 6.2) выбранной пользователем папки 
или МОТ.1., если пользователь не сделал свой выбор. 

Единственный параметр функции указывает на структуру типа 
ГРВВОМ5ЕУЕО, содержащую всю информацию, необходимую для вызова 
функции. Поля этой структуры содержат следующую информацию: 


а 


НИ 
В\упдОмтег Дескриптор окна вызвавшего приложения. 


т. : 
| р141 Косой ‚РТОГ папки, отображаемой как корневая в диалоговом окне. | 


| р52015р!ауМаше | | Возвращается им имя выбранной пользователем папки. 


1р57ТШе ‘Текст приглашения в диалоговом окне. 

| | О 

| “Е ]а55 Флаги, определяющие, что именно может выбрать пользова- 

‘тель в окне диалога. 

а — ии а --- —— 

ра Указатель на функцию обработки событий или МО. 

дж 

 ПРагат | ‚Определенный приложением параметр, передаваемый в фун- | 

| кЦию обработки событий. 

Итабе Индекс системного списка значков, соответствующий вы- | 
| бранной папке. | 


Поле а! ]1а$ может включать комбинацию следующих флагов: 


ини ОИ | ОНИ 


НИИ 
ВЕ _ ВВО\УЗЕЕОВСОМРОТЕВ Выбор только компьютеров. В 
| ВТЕ_ ВБКО\ЗЕРОВРЕЛМТЕВ | Выбор только принтеров. 


ны Е а —_ 


 ВР_ ЗОКТСОВЕГО\ РОМАТМ ‚Не включать в дерево сетевые папки, располо- 


_женные ниже корневой папки. 
же е Корнет 


ста КЕТОЕМЕЗАМСЕЗТОВ$ | Выбор 1 только предков системных папок. 


ВТГЕ_ВЕТОВМОМТГУЕ$ЗОТВ$ ' Выбор только системных каталогов. 


‚ ВЕ ЭТАТОЗЭТЕХТ Включать в диалог полосу состояния. Функ- 
| | ция обработки событий может заносить в нее 
текст, посылая соответствующее сообщение 
__ |Диалоговому окну. 


о НИИ НИ Ооо 
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Задание флагов, определяющих выбор пользователя, приводит к тому, что 
выделение любых вершин дерева, не соответствующих этим флагам, не делает 
доступной кнопку ОК, так что пользователь не может произвести запрещен- 
ный выбор. 

В простейшем случае вызов диалога можно оформить следующим образом: 


У01а _ Еаз®са11 ТЕГогм1: : Ви оп1С11сК (ТОБ)есЕ *$епаекг) 
{ 

ВВОМЗЕТМЕО В1пЕо; 

ГРСТТЕМТОЪТЗТ р1за1=моЬЦ; 

сраг $5$[МАХ РАТН] ; 

.РТТЕМТРОРТЬСТ РВ; 

сраг РаеП[МАХ_РАТН]; 


ВТпЕо.ВимпаОмпег Роги] ->Нава1е; 

ВТпЕо.1р52Т161е = " Выберите папку"; 
ВТпЕо.р5201$р1ауМаме = 5; 

ВТиЕо.1рЕЁп = МОГ; 
5Нсефбрес1а1Го1АегГоса®1оп (Напа1е, С5Трт ОВТУЕЗ, &Р); 
ВТ1Ео.р191Кооф®=Р; 

ВТиЕо.01Е1адз = ВТЕ ВЕТОВМОМЬУЕ$ОТВ$; 


р1Я1 = 5НВгомзеЕогРо1аег (&ВТпЕо); 
ТЕ (рзат != Мог) 
1Е (5НСееРа®ВЕкоштТрТ1$%А (р1а1, РабП)) 


{ 
1Е (Рафр[5екЬеп (РаЪВ)-1] != '\\') 
сегСае (Рафв, "\\"); 
ТаБе11->Сар®1оп = ВТпЁо.рз2015р1ауМапе; 


Таре12->СарЕ1оп = РаёП; 
} ' 


} 


В этом примере сначала заполняется структура ВП\о типа ТВгомзе По. 
В качестве корневой задается папка "Мой компьютер". Это делается вызовом 
функции 5Н@бе Зреса1Ро!егГ.осайЙоп с параметром СЗШГ, РЕТУЕЗ (см. 
описание этой функции в разд. 6.2). Полученный в результате РШЬ папки 
"Мой компьютер" заносится в поле р141Воо%ф структуры ВП\о. В поле а аз$ 
задается флаг ВТЕ ВЕТОВМОМГУЕЗЬТВ. Это соответствует выбору в диало- 
ге папок файловой системы. 

После заполнения структуры вызывается функция $НВгомзеЕогЕо!@4ег. 
При этом открывается диалог, внешне такой же, как при вызове функции 
З@ес О1гесфогу. Если пользователь выбрал в диалоге папку, то ее РОГ. зано- 
сится в переменную р!а1. Одновременно в переменную 5, адрес которой запи- 
сан в поле рз2015р1ауМате, заносится системное имя выбранной папки. Далее 
с помощью функции Н@бе Ра Его ОГ 5 и некоторых вспомогательных 
операторов формируется обычный путь к папке в переменной Ра! (см. поясне- 
ние этой функции и использованных в коде операторов в разд. 6.3). В заключе- 
ние системное имя выбранной папки и путь к ней отображаются в метках 
ГаБе11 и Габе]!2. | 

В приведенном варианте диалог, вызываемый функцией 5НСбеё$реаа1|- 
Ро] ЧегГ.осайоп, отличается от диалога, вызываемого функцией Э@аес&ПО1гес- 
фогу, только тем, что возвращается РОГ, выбранной папки и ее системное имя. 
Это позволяет далее работать с этой папкой методами, рассмотренными 
в разд. 6.2. Как мы видели, можно получить и путь к папке, правда, ценой ус- 
ложнения кода. Но функция $НСбеЗреса1Ро]4егГ.осайоп, все-таки, обладает 
и некоторыми дополнительными возможностями: в качестве корневой можно- 
задать любую обычную или виртуальную папку. Например, если в приведен- 
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ном выше коде в вызове функции ЗНСе Зрес1а!Ео]4егГ.оса оп задать второй 
параметр равным СЗТОГ. РЕЗКТОР, то корневой станет папка Рабочий стол. 
Изменение флагов в поле и! ае$ структуре типа ТВгомзеШ!о, позволяет 
управлять возможностью выбора папки в диалоге. Например, если заменить 
в приведенном коде оператор, задающий значение Е а5$, оператором _ 


ВТпЕо.91Е]адз = 0; 


то пользователь сможет выбирать в диалоге не только обычные, но и виртуаль- 
ные папки. Подобных возможностей функция З@ес О1тгесфогу не дает. 


6.6 Поиск файлов в каталогах 


6.6.1 Поиск по всему дереву каталогов 


Для поиска файлов, удовлетворяющих указанному паблону и имеющих 
указанные атрибуты, используются функции ЕЕ", Ета Мех& и процедура 
Ета(озе. Они объявлены в файле буз0ИН15.Й следующим образом: 


11 __ Еаз6са11 Е1паЕ1гкз® (сопзЕ Ап5156г1па Раф, 
106 Абег, ТбеагсЬВес &Р); 
1пЕ _ Еазеса11 Е1паМехь (Т5ЗеагсрВес &Е); 


01а _ Еаз®са11 Е1паСТозе (ТбеагсИВес &Е); 


Все они используют для работы структуру типа ТЗеагев Вес: 


5ЕгисЕ ТбеахспВес 


{ 


1пЕ Т1те; // Время создания файла 

1пЕ $1276; // Размер файла в байтах 

116 АБЕг; // Атрибуты файла 

Апз15Ег1па Маше; // Имя файла 

106 Ехс1ааеАеег; // Для внутреннего использования 
ип5$1апеа Е1пЧНапа1е; // Дополнительные сведения‘ 


\1№32 ЕТМР РАТАА Е1парака; 

;_ — — 

Начинается поиск вызовом функции Ет@аЕ!тг $$. Параметр Ра{В определяет 
путь и шаблон искомых файлов. Например, если Ра = "с:\\фез4\\*.*", то бу- 
дут искаться все файлы в каталоге с:\1ез&\. А если Рай = "с:\\{ез\\*.$тр”, то 
в каталоге с:\{езЁ\ будут искаться файлы с расширением .рпр. Параметр АИг 
определяет типы файлов, которые будут включены в поиск дополнительно 
к обычным файлам. Параметр может включать следующие флаги: 


И ООО 


ЧаВеа4Ошу и | файл только для чтения __ 

‚ РаНЧдет __ | невидимый фа файл 

Чазуте | системный файл | 

Чауоштер идентификатор дика 
`ФаОтесфогу _ |Каталог ООО 
КаАтевуе_ архивный файл | 


'{аАпуЕНе любой файл И 
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Флаги могут объединяться. Например, если АЁг = гаВеадОщу | гаН1@4деп, 
то к обычным файлам будут добавлены невидимые файлы и файлы только для 
чтения. Если АЁЙг = ЁаАпуЕЦе, то будут искаться все файлы и каталоги. 
А если АЙг = 0, то будут искаться только обычные файлы. 

Функция ЕшаЕ1`$% возвращает 0, если файл, удовлетворяющий условиям 
поиска, найден. В противном случае возвращается код ошибки \У/1т4о\мз. 

Если файл найден, то сведения о нем заносятся в поля структуры типа 
ТЗеагев Вес, определяемой параметром Е. В поле Маше этой структуры можно 
найти имя файла вместе с его расширением. Например, "Тез$.{х&". В поле 
Типе заносится дата и время создания файла. Это время в формате РОВ. Его 
можно перевести во время типа Т)аёеТипе функцией ЕИедафеТорафеТите, 
а если требуется перевести его в строку, то к значению типа ТО)афеТипе можно 
затем применить функцию ОаеТ!пеТо5 г. Таким образом, выражение вида 


РасеТт1теТоЗехг (Е1]1ера в еТорафеТ1ме (Е.Т1ме)); 


вернет дату и время создания файла в виде строки. 

Поле АЙг структуры Е содержит атрибуты файла. Определить тип найден- 
ного файла можно комбинированием соответствующего флага с полем АЙг по 
операции &. Если файл имеет данный атрибут, то результат этой операции бу- 
дет больше 0. Например, чтобы узнать, является ли найденный файл систем- 
ным, надо записать выражение 


(Р.АССЕ & ЕазузЕ11е > 0) 


Это выражение вернет фгиае, если файл системный. 

Таким образом, вызов Ет@Е!`$% может найти первый файл, удовлетворяю- 
щий условиям поиска, или убедиться, что ни одного такого файла нет. Про- 
должение поиска осуществляется вызовом функции Ет@аМехё и передачей 
в нее в качестве параметра Е той же структуры, которая передавалась 
в Еш9Е!`$%. Если ЕтЯМехё вернет 0, значит нашелся еще один файл, удовле- 
творяющий условиям поиска. Информация об этом файле занесется в ту же 
структуры Е, после чего можно снова вызывать Ешт@Мехё для поиска следую- 
щего файла. Если Еш@ЯМ№ехё вернет ненулевое значение, значит больше нет 
файлов, удовлетворяющих условиям поиска. В этом случае надо вызвать про- 
цедуру Ет@аС1озе с тем же параметром Е. Эта процедура завершает поиск и ос- 
вобождает ресурсы, выделенные для него. 


Рассмотрим чисто демонстрационный пример применения рассмотренных 
выше функций (рис 6.7). На диске вы его сможете найти в каталоге РИез под 
именем РР©тад. 


Рис. 6.7 --` Пеиск = 13 
Окно приложения РЕп90 во время выполнения | ок в каталоге. о 
Имя файла 


Ярлык (2] для МС.ЕХЕ_р# 


Дата со [ЧИ 
- 12.06.20 | 


В каталоге больше нет файлов 
Атрибут .. 


Не сист 
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Ниже приведен код данного приложения: 


#1пс1иае <\ус1.1> 
#1пс1иае <Е11еСех1.Прр> 


ТбеагсЬВес ЕЁ; 
Ап515Ег1па П1к; 
роо1 1=ЁЕа1зе;//первый ли раз поиск 


\01А _ Еазеса11 ТГоги1 ; : Ви ®оп1С11сК (ТОБ)есЕ *5епаег) 
{ 

1Е(!1) 

{ 

Е1паЕ1 зе (Р1г + "\\*.*", ЕаАпуЕ11е, Е); 

Таре11->Сар*1оп=ВафеТ1теТоб ег (Е11ерафеТорафеТ1ме (ЕГ.Т1пе)); 

1=6хое; 

Ви оп1->Сар&1оп = "Найти далее"; 

} . 

1Е (!Рарамех (РЁ) } 

{ 
Тафе11->Сар*1оп=ВафеТ1меТоЗ ег (Е11ерафсеТорафеТ1ме (Е.Т1пе)); 
1Е (Е.АСЕг & ЕабузЕ11е > 0) 

Таре12->Сар*1оп="Системный"; 
е1зе Гаре12->Сар®&1оп="Не системный"; 
Таье13->Сар®1оп= Е.Маме; 

} 

е1зе 

{ 

ЗВомМеззаае ("В каталоге больше нет файлов"); 
Ви оп1->Сар®1оп = "Найти"; 
Вас оп1->Епаб1е = Еа15е; 


у01Аа __Еазеса11 ТЕГоги1; :Вие$оп2С11сК (ТОБ)есЕ *5епаег) 
{ | 
Ва оп1->Сарё1оп = "Найти"; 
Ви воп1->Епар1еа = Еа15е; 
Е1паС1озе (ГР); 
1Е (5е1есер1гесвогу ("Укажите каталог поиска файлов","", Р1кг)) 


{ 
Ва Еоп1->Епаб1еа=егае; 


1=Еа1$е; 
Таре11->Сар®1оп=""; 
Таре12->Сар®1оп=""; 
Таре13->Сарф1оп=""; 
Тафе18->Сар*1оп=О1г; 


} 


е1зе Гаре18->Сар®1оп="Каталог не выбран"; 


} 


Приложение имеет 2 кнопки и несколько меток. По щелчку на кнопке По- 

иск в ... (Ви Коп2) пользователь может выбрать папку, в которой будет произво- 

‚ диться поиск. При выборе папки использована, ранее рассмотренная функция 

Зе@еесПлгесфогу (см. разд. 6.5). Если папка выбрана, то по щелчку на кнопке 

Найти (Вивбоп1Т) производится поиск любых файлов и папок, причем в соответ- 

ствующие метки высвечиваются имя, дата создания и атрибут системности 

найденного файла или папки. Следующий файл или папку можно найти, по- 
вторно нажав на кнопку ВиЙоп1. 
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Дальнейший код, на мой взгляд, комментариев не требует. Повторяю, что 
это чисто демонстрационное приложение, наглядно демонстрирующее исполь- 
зование функций Ет@аЕ1г$$, ЕшаМех& и Ета@С]озе. 

Теперь рассмотрим более сложные примеры использования функций поис- 
ка файлов: Первый пример вы можете найти на приложенном к книге диске 
в каталоге РИез в проекте РЕ!та. В этом примере строится дерево всех файлов, 
удовлетворяющих указанным условиям по дате создания и по размеру. Поль- 
зователь может также указать корневую папку, начиная с которой строится 
дерево. Если после построения дерева сделать в нем на узле, соответствующем 
документу или исполняемому файлу, двойной щелчок, то документ откроется 
связанной с ним программой, а исполняемый файл начнет выполняться. 

Окно этого приложения показано на рис. 6.8. Левую его часть занимает 
компонент Тгее\У1е\м,, в котором строится дерево файлов. Справа вверху разме- 
щено окно ЕЯ (его имя в приведенном далее коде — ЕОп’), в котором пользо- 
ватель может задать начальный каталог построения дерева. Задание каталога 
можно сделать также с помощью кнопки Выбрать, вызывающей стандартный 
диалог выбора каталога. 


Рис. 6.8 БН. Дерево файлов 


Окно приложения РЕпа | 
РомРаде \\/еБз Папка 


МоР'аес$ Г: к Выбрать ... - 
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Ниже размещены элементы, задающие условия, которым должны удов- 
летворять отображаемые файлы. Индикатор Включая вложенные папки (его имя 
СВшеа4е) указывает, должны ли отображаться только файлы папки, ука- 
занной в ЕП!т, или должно строиться полное дерево, включающее все вло- 
женные папки. Панель Дата создания файла содержит группу радиокнопок 
ВОа,афа и два элемента РаёеТ!пеР1сКег, задающих диапазон дат при вклю- 
ченной кнопке в диапазоне. Панель Размер файла включает индикатор любой 
(СВЗ1те), выпадающий список СошБоВох1, содержащий строки “не менее” 
и “не более", и компонент ЭршЕЗЧИТ, задающий предельный размер отобра- 
жаемых файлов. 

Поиск инициируется щелчком на кнопке Поиск (имя ВЕ1щт9д). 

Кроме видимых компонентов на форме размещен список изображений 
ГпазеГ, 1541. В нем находятся пиктограммы закрытой папки (индекс 0), доку- 
мента (индекс 1), открытой папки (индекс 2). 
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Ниже приведен код этого приложения. 


#1о0с1аае <ус1.6> 
#1пс1аае "Е11еС6у1.Врр" 
#10с1аае "5Бе11АРТ.В" 
#1пс1аае "Бафе0Е11$.Врр" 
#10с1аае "5уз0611$.Врр" 


у01а _ Еа5еса11 У1емр1г (Ап5156г1пд 01, ТТгееМо4е *Моае ) 
{ 

// основная процедура поиска 

ТбеагсВВес 5В ; 

106 1ге5$, ТВед1п; 

ТТгееМоае *МемМоае; 

ТТухее\М№оае *РМоае; 

Боо1 1ааа; // указывает, надо ли включать 

//в дерево данный файл 


// смена каталога, чтобы не задавать полный путь к файлам 


СВОзх (01); 
// добавление узла с ‘именем данного каталога 
РМ№оае = Еоги1-> Тгее\У1ем1 ->ГЕепз->Аааср11а (М№оае, ГПО1г); 
// задание пиктограммы закрытой папки 
РМоае->ТтадетТпаех = 0; 
РМ№оае->5е1есееЯТпаех = РМ№оае->ТтадеТпаех; 
// начало поиска 
1гез = Е1паЕ1г5е ("*.*", ЕГаАпуЕ11е, $8); 
мр1]е (1гез$ == ) 

{ 

1Е ((5В.Маме != ".") && (5В.Маме != "..")) 

{ 

1ааа = &6гае; 


1Е ((5В.АБЕг == 0х010) && (Гоги1->СВТрс1аае->Сьескеа)) 
\У1емр1 г (5В.Маме, РМ№оае); // для поиска во вложенной папке 
// рекурентный вызов У1еиП1г 


е1зе 

{ . 

1Е (5В.АбеЕ != 0х010) 

{ 

// проверка условий, наложенных на файл 

// проверка даты 

$и1есп (РГоги1->ВСВафа->ТеепТпаех) 

| 


сазе 0: ТВедлп = 0; 


Бгеак; 
сазе 1: ТВед1п = РабеТ1меТоЕ11ераке (Рафе() - 7); 
Бгеак; 
сазе 2: ТВед1п = ПБабеТ1теТоЕ11ераее (Рафе() - 
РаузТпМопфВ (Рафе())); 
бгеак; 
‚сазе 3: ТВед1п = РафеТ1теТоЕ11ерафе (Рае () - 
РаузТпУеаг (Рафе())); 
Ьгеак; 


сазе 4: {1Е (5В.Тлие > РазсеТ1теТоЕ11ераее ( 
ГКогп1->ПРафеТт1терР1сКкКег2->ра*е)) 

ТВед1п = 5В.Т1лте + 1000; 

е]1зе 

{ 

ТВед1п = РавеТ1теТоЕ11ера*е ( 

Гоги] ->рафеТтТ1теР1скег1->рВа*е); 

} 

Ьгеак; 


} 


415 


416 


Глава 6. Работа с дисками, файлами и каталогами 


ЧеЁЕач1$: ТВеадлп = 0; 
} 
// проверка размера 
1ааа = 5$В.Тлие >= ТВед1п; 
1Е (! РГоги1->СВ$12е->СцескКея) 
1Е (РКогп1->СопроВох1->ТЕетштТпаех == 0) 
1ааа = Тааа & (5В.51те > (Еогт1-> 
С5р1пЕа1*1->Уа1ае << 10)); 
е15е 1а@а = 1а4аа & (58В.51те < (Гоги1-> 
С5р1пЕЯ1{1->Уа1ие << 10)); 


} 
1Е (1ааа) 

{ 

// занесение узла в дерево 

МемМоае = ЕГЕоги1->ТгееУ1ем1->ТЕетз-> 

Аааср11а (РМ№оае, '5В.Мапе); 

// задание пиктограммы 

1Е ((5В.АСЕг & Еар1гесфкогку) ==. 0) 

МемМоае->ТпадеТпаех = 1; 
е15е МеиМоае->1тадеТпаех = 0; . 
МеиМоае->5е1есфеаТпаех = МемМоае->ТтадеТптаех; 
} 
} 
} 

// продолжение поиска 

1гез = Е1паМехе (58); 

} 

Е1раС1о5е (58); 

// возврат в предыдущий каталог 
СВр1к(".."); 


у01А __ЕазЕса11 ТРГогш1:; : ВЕ1паС11ск (ТОБ)есЕ *5епаег) 


// начало поиска 
Ап$15Ек1па 0О1г, СагО1к; 
// запоминание текущего каталога 
Сиго1к = СееСиггепрО1т(); 
// очистка дерева 
ТгееУ1ем1->1Еещ$->С1еаг(); 
// снятие сортировки 
Гогп1->ТгееУ1ем1->богЕТуре = СомсЕтг15$: : 5ЕМ№опе; 
// корневой каталог | 
О1х = Ти1м(ЕР1г->Техе); 
1Е (Оле != "") 
{ 

1Е ( 01к[01г.Ъепаев()] != '\\') 

Б1к = Пе + '\\ 1; | 

1Е(! О1гескогуЕх1 $$$ (21г)) 

{ . 
ЗВомМеззасе ("Указанная папка не существует"); 
хебогп; 


} 


.} 


// курсор "песочные часы" 
Зсгееп->Сагзог = сгНоогС1а$$; 

// уход`на поиск 

Утем)1т (Р1и, МОБ); 

// курсор по умолчанию 
Зсгееп->Сигзог = сгреЕац1*; 

// восстановление текущего каталога 
СПр1г (Саг)1 г); 

// сортировка дерева 
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Гоги1->Тгее\У1ем1->богЕТуре = Сотмс®г13: : $ ЕТехЕ; 

// раскрытие корневего узла 

1Е (Гоги1->ТгееУ1ем1->Тееп$->Тееп [0] ->НазСЬ11агеп) 
Когм1 ->Тгее\У1еи1->Тепз->Т%&ем [0] ->Ехрапа (ЁЕа1зе); 


%\01А __ЕазЕса11 ТЕогм1:; : ВВгомзеС11ск (ТОю]есе *5епаег) 


// диалог выбора каталога 

Апз156глпа 11; 

1Е (бе1есе)1гескогу ("Выберите папку","", Р1г)) 
ЕО1г->ТехЕ = П1к; 


\01А __Еаз®са11 ТГогм1: :Тгее\У1ем1Сопраге (ТОБ)есе *5епаег, 
ТТхеемМоае *М№оае1, ТТгее\№ооае *М№ае2, 
106 Раба, 1106 &Сотраге) 
{ 
// Функция сортировки: сначала папки, потом файлы 
1Е (М№оае1->ТмадеТпаех == М№оае2->ТтадеТпаех) 
Сомраге = Ап$1СотрагеТех+ (М№о4е1->Техе, Мо4е2->Тех®); 
е1з5е Сомраге = М№оае1->ТтадеТпаех - Моае2->ТтадеТпаех; 


\01А __Еаз®са11 ТЕКогм1: :ТкееУ1еи1061С11сК (ТОр)есе *5епаег) 
{ 

// открытие файла при двойном щелчке 

Апз15ег1па 95; 

ТТхгее\м№о4е *М№оае = пем ТТгееМ№оае (№11); 

Моае = ТгееУ1ем1->5е1ескеа; 

// если это файл, а не папка 

1Е (М№оае->ТГтадеТпаех == 1) 


// Формирование полного пути' 
5 = №ае->Техф;. 
\р11е (№ае->РагепЕ != МОЬЬ) 


М№оае = М№оае->РагепЕе; ' 
$ = №оае->ТехЕ + "\\"+$ ; 


} . 
5пе11Ехесифе (Напа1е, "ореп",$.с_з%х(),МОЬЬ, МОЪЬ, $М_$НОМ); 


у01А __Еаз®са11 ТКогм1:; :ТгееУ1ем1Со11арзеа (ТОр)]есе *5епаег, 
ТТгееМоае *М№ае) 


// смена пиктораммы при свертывании узла папки 
1Е (Моае->ТтадеТпаех == 2)  №ае->ТтааеТпаех = 0; 
Моае->5е1естеаТпаех = М№ае->ТтадеТпаех; 


у01Я _ Еаз®са11 ТРогт1: :Тгее\У1ем1Ехрапаея (ТОБ]есЕ *Зепаек, 
ТТкееМоае *Моае) 
{ 
// смена пиктораммы при развертывании узла папки 
1Е (Моае->ТиадчеТпаех == 0) Моае->ТтадеТпраех = 2; 
Моае->5е1есфеЯТпаех = М№оае->ТтадеТпаех; 


// управление видимостью СотроВох1 и $5р1пЕа1&1 
СопроВох1->Епаб1еа = !СВ$512е->СВескеа; 
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уо1а __Газ®са]11 ТЕогиТ: :КСБафаС11сКк(ТОБ)есЕ *5епаег) 


// управление видимостью БаЁеТ1теР1скег]1 и РакеТ1теРр1скег? 
РабетТ1мерР1скКег1->Епаб1еа = (КСрафа->Т$ептТпаех == 4); 

Раф еТ1перР1скег2->Ераб1еа РасеТтзмерР1скег1->Епа1еа; 

} 


Код содержит подробные комментарии, так что можно ограничиться крат- 
кими дополнительными пояснениями. Директива #1теа4е подключает ряд 
файлов, необходимых для. использованных в проекте функций. Файл 
ЕНес1йрр нужен для функции Э@ес Огесогу, вызывающей диалог выбора 
каталога. Файл бйеПАРГ.Й требуется для функции 5Ве|Ехесще, открываю- 
щей выбранный пользователем файл. А файл РДае01И13.Йрр содержит объявле- 
ния функций Оау$3тМоп и ВаузшУеаг, используемых для определения 
числа дней в текущем месяце и году. 

Основная процедура поиска — УлемПтг. Вторым параметром Моде в нее 
передается родительский узел той цапки, в которой ведется поиск. А первым 
параметром Олт в нее передается строка, содержащая текст узла этой папки. 
Для корневого узла это полный каталог или текущий, если пользователь очи- 
стил окно ЕП:. А для всех остальных узлов это относительный каталог, вло- 
женный в каталог родительского узла. Чтобы не восстанавливать полный путь 
к папке и не заносить его в шаблон поиска, первый оператор процедуры делает 
каталог данной папки текущим. Следующий оператор добавляет в дерево узел 
папки как дочерний узел узла Моде. А далее идет поиск функциями ЕщЕ! $$, 
ЕшаМ№ хе, ЕтаС]озе. В начале цикла поиска отсекаются каталоги с именами 
"."и”..”". Это каталоги, соответствующие каталогам верхних уровней, достав- 
шиеся в наследство от ООВ и не отображаемые при работе с У/1т140о\з. Далее 
выражением 


(ЗВ.Абсг & Еар1гес®огу) != 0 


проверяется, является ли найденный элемент каталогом. Если является и по- 
льзователем включен индикатор СВПъ@4е (включать подкаталоги), то осуще- 
ствляется рекурентный вызов той же процедуры У1емПлг. Таким образом, как 
только встретилась вложенная папка, поиск цереключается на нее. И только 
когда поиск в ней закончится, управление вернется в вызвавший экземпляр 
процедуры УлемП!г. 

Если очередной найденный объект является файлом, то осуществляется 
проверка, удовлетворяет ли он условиям, заданным пользователем. Проверка 
даты сводится к следующему. Рассчитывается значение ТВеё1т — нижней до- 
пустимой границы времени. Если пользователь выбрал радиокнопку любая, 
значение ТВег1п задается равным 0. При выборе кнопки последняя неделя зна- 
чение ТВейш равно текущей дате (определяется функцией Оафе), уменьшен- 
ной на 7 дней. Для кнопок последний месяц и последний год текущая дата умень- 
птается соответственно на число дней в текущем месяце и годе. Это число дней 
определяется функциями Вау$шМош В и ВаузшУеаг. Если пользователем за- 
дан диапазон дат и время файла превышает максимально допустимое значе- 
ние, то ТВегт задается превышающим время файла, что обеспечит в дальней- 
шем отбрасывание данного файла. В заключение время файла 5В.Т!те срав- 
нивается с рассчитанным значением ТВезш, чтобы узнать, нужно ли вклю- 
чать в дерево данный файл. 
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Проверка допустимости размера файла 58В..512е осуществляется проще. 
Обратите только внимание на то, как приводятся значения, заданные в компо-. 
ненте ЭршЕЗИ1 в килобайтах, к байтам — с помощью операции сдвига <<. 

Последующее включение узла файла в дерево, вероятно, пояснений не тре- 
бует. После окончания поиска текущий каталог изменяется на родительский 
оператором 


СВО1и(".."); 


Процедура ВЕшАСИеК — обработчик щелчка на кнопке Поиск. В ней сна- 
чала запоминается текущий каталог, который может измениться в процессе 
поиска. Затем очищается дерево, и в переменной О1г формируется строка кор- 
невого каталога. Для этого берется текст окна ЕПг, очищенный функцией 
Тгип от начальных и конечных пробельных символов. Если имя каталога 
не заканчивается слэшем, то в конце добавляется слеш. Если в конце пути нет 
ни одного слэша, то один добавляется. Далее проверяется указанный путь — 
это путь к папке, или нет. Если указан путь к файлу или такой папки просто 
не существует, то пользователю выдается сообщение "Указанная папка не су- 
ществует”, и поиск не выполняется. Поскольку поиск и заполнение дерева мо- 
гут быть довольно длительными процедурами, задается курсор типа “песоч- 
ные часы”. Затем вызывается описанная ранее процедура поиска У1лем Пг. 
В качестве второго параметра в нее передается МО, что обеспечивает отобра- 
жение первого узла как корневого. 

Осталось коротко рассмотреть вспомогательные процедуры. Процедура 
ТгееУ1ем1Сотраге является обработчиком события ОпСотраге компонента 
Тгее\У1е\1. Она обеспечивает сортировку узлов дерева на две группы: сначала 
папки, затем файлы. А внутри каждой группы осуществляется сортировка по 
алфавиту. | , 

Процедура Тгее\У1лем ОЫСПсЕ обрабатывает двойной щелчок пользовате- 
ля на узле дерева. Если узел соответствует файлу, то сначала в переменной 5 
формируется имя файла с полным путем к нему. Для этого в цикле осуществ- 
ляется проход по цепочке родительских узлов, и их имена (имена каталогов) 
заносятся в 5. Затем вызывается функция 5ВеЦЕхесще. Если файл исполняе- 
мый, он будет запущен на выполнение. Если же файл является документом та- 
кого типа, для которого в \У/1т9о\з$ зарегистрировано открывающее его прило- 
жение, то документ будет открыт с помощью этого приложения. Конечно, не 
мешало бы для файла документа предварительно проверить функцией Е!19- 
Ехесшва]е наличие программы, связанной с документом данного типа, и при 
отсутствии такой программы предоставить пользователю возможность указать 
ее. Но я не пошел на подобное усложнение и так довольно громоздкого кода, 
чтобы не затушевывать главного в нем, связанного с поиском и отображением 
файлов. Стоит отметить, что вообще говоря открывать можно и папки, правда 
не во всех версиях \1140%$, так что если все-таки требуется открытие и па- 
пок, то следует закомментировать строку 


1Е (Моае->ТщадеТптаех == 1) 


Процедура ВВгомзеСПесК позволяет пользователю с помощью диалога, 
вызываемого функцией З@ес&ПО1гесфогу, выбрать начальную папку поиска. 
Процедуры Тгее Улем1СоПарзе4 и ТгееУ1лем1Ехрапде4 меняют пиктограммы 
папок на закрытую и открытую при свертывании и развертывании узла. Про- 
цедуры СВЗ12еСПсК и ВСБаваСПеК управляют доступностью тех окон, кото- 
рые должны быть доступны только при соответствующих установках пользо- 
вателя. 
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6.6.2 Поиск по шаблонам по всему дереву каталогов 


Рассмотренный в разд. 6.6.1 пример может использоваться как фрагмент 
самых различных приложений, в которых пользователю надо предоставить 
возможность выбора и доступа к файлам, удовлетворяющим некоторым крите- 
риям. Правда, в этом приложении введены только критерии по дате и разме- 
рам файлов. И нет более существенного критерия — шаблона файлов. Это свя- 
зано с принятым алгоритмом поиска. Для того чтобы охватить поиском все 
вложенные папки, поиск ведется с шаблоном “*.*". И тут уже не остается мес- 
та для шаблона файла. Рассмотрим возможности задания шаблона файла. 
Первый самый простой вариант — заменить в процедуре У1емОл1т оператор 


1гез = Е1паЕ1тг$6 ("*.*", ЕаАпуЕ11е, 58); 
оператором 
1гез = Е1паЕ1Е$Е (01х, ЕаАпуЕ11е, 5ВК) 


Тем самым отсекается поиск во вложенных папках, но зато в заданной 
пользователем папке будет проводиться поиск с учетом заданного шаблона 
файлов. Правда, для открытия пользователем какого-то из найденных файлов 
надо еще несколько переделать процедуру Тгее\У1лем 1 РЫСИЦсК. 

Второй вариант — дополнить в процедуре У1е\О!` проверку условий, ко- 
торым удовлетворяют файлы, проверкой соответствия их шаблону. Это не- 
сколько усложнит код, так как надо будет воспроизвести принятую в \/114о\з 
методику обработки шаблонов. И третий вариант — изменить алгоритм поис- 
ка. Можно в каждой папке сначала проводить поиск файлов по заданному 
шаблону, а затем проводить поиск вложенных папок и рекурсивно вызывать 
в них аналогичный поиск. Правда, это затянет время, так как, фактически, 
потребует двойного поиска. Но о времени поиска будет сказано позднее. 
А пока рассмотрим подобный пример поиска с учетом шаблона файлов. Он со- 
держится на приложенном к книге диске в каталоге РЦез в проекте РЕ©та2. 

Форма проекта во время выполнения показана на рис. 6.9. Она отличается 
от показанной ранее на рис. 6.8 только наличием окна редактирования ЕЦ 


Рис. 6.9 (= Дерево файлов - поиск по шаблону 
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с именем ЕЕ|!еМате, в котором пользователь может задавать шаблон файлов. 
Например, ”*.{фх%” или "Отчет*.4ос”. 

Код приложения отличается от рассмотренного выше в проекте РЕта 
только процедурой У1лемОй:, которая имеет вид: 


У01А __Газса11 \У1емО1х (Ап5156г1па9 ОР1г, ТТгееМмМо4е *Моае ) 

{. 

// основная процедура поиска 

ТбеагсЬВес 5В ; 

1106 1гез, ТВед1п; 

ТТгееМоае *МемМоае; 

ТТгееМоае *РМоае; 

Боо1 1ааа; // указывает, надо ли включать в дерево данный файл 


// смена каталога, чтобы не задавать полный путь к файлам 
СВО1г (21); 
// добавление узла с именем данного каталога 
РМ№оае = Гоги1-> Тгее\У1ем1 ->Тепз->Ааасв11а (М№оае, О1хт); 
// задание пиктограммы закрытой папки 
РМ№оае->ТтадеТпаех = 0; 
РМ№о4е->5е1есфеЯТтаех = РМ№оде->ТтадеТпаех; 
// начало поиска 
1гез = Е1паг1г5% (Гоги1->ЕЁЕ11еМапе->Техе, 
ЕаН1Чаеп+ЁЕа$у$Е1]1е, 58); 
м11е (1гез == 0 ) 
{ 
1Е (5В.АЕЕг != 0х010) 
{ 
// проверка условий, наложенных на файл 
// проверка даты 
$и16ср (Гоги1->ЕКСра$а->Т+епмТпаех) 
{ 
сазе 0: ТВедлп = 0; 
ЬгеаКк; 
сазе 1: ТВед1п = БафеТ1теТоЕ11ерафе (Рафе() - 7); 
БгеаКк; 
сазе 2: ТВеа1п = РаееТ1неТоЕ11ерафе (Рафе() - 
. РаузТпМопЕВ (Рае ())); 
Бгеак; 
сазе 3: ТВед1п 


РафеТ1меТоЕ11ера{фе (Рафе() - 
РаузТпУеах (Рае ())); 
ЬгеаКк; 
сазе 4: 1Е (5В.Т1те > ВафхеТт1теТоЕ11ераее ( 
ЕГогм1 ->РаееТ1теР1сКкег2->рафе) ) 
ТВед1п = 5В.Т1ше + 1000; 
е15е ТВеад1п = ПафеТ1меТоЕ11ера*е ( 
Рогм1 ->ракеТт1теР1сКкКег1->раее); 
БгеаКк; 
ЧеЁаз1е: ТВедлп = 0; 
} // конец $и1ЕСВЬ 
// проверка размера 
1ааа = 5В.Т1ме >= ТВеалп; 
1Е (! Рогт1->СВ$12е->Срескея) 
1Е (Рогт1->СопроВох1->Т$ештпаех == 0) 
1ааа = 1ааа & (5В.512е > (Гогт1-> 
С5р1пЕЯ1{1->Уа1ае << 10)); 
е1зе 1ааа = 1ааа & ($8В.512е < (Еогт1-> 
| С5р1пЕа1*1->Уа1ае << 10)); 
} // конец ТЕ 
1Е (]ааа) 
{ 
// занесение узла в дерево 
МемМоае = Гогп1->Тгее\У1ем1->Тфетз->Ааасв11а (РМоае, 5В.Маме); 
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// задание пиктограммы 
ТЕ ((5В.АбЕг & Еа)О1гесфогу) == 0) 
МеиМ№оае->ТмадетТраех = 1; . 
е1зе МемМоае->ТтадеТптаех = 0; 
МемМоае->5е1есфеяТпаех = МемМоае->1тааеТпаех; 
} 
// продолжение поиска 
1гез = Е1паМехеё (56); 
} // конец иБ11е 
Е1паС1о$е ($8); 
1Е (Коги1->СВТпс1аае->СфтескКеа) 
{ 


1гез =.Е1раЕтгзЕ ("*.*", Еа)1гесбогу, 58); 
ип11е (1гез == 0 ) 
{ | 
1Е ((5В.Маше != ".") &&5 (5В.Матше != "..") && 
((ЗВ.АЕЕг & Еа01гесвоку) != 0)) 


// рекурентный вызов У1еир1г 
У1ем01х ($В.Маме, РМоае); | 
1гхез = ЕРЕ1лрамехЕ ($58); 

} . 
Е1пАС1озе (58); 


у, возврат в предыдущий каталог 
СВОЕ (".."); | 

} . 

Отличие от рассмотренного ранее кода заключается в следующем. Сначала 
в папке проводится поиск файлов, удовлетворяющих шаблону. Для этого пер- 
вым параметром функции Ет@Е!'$6 задается этот шаблон, содержащийся 
в ЕЕ|ЦеМате->Техё. В поиск включены системные и невидимые файлы (атри- 
буты равны Ё#аН1адеп-+!аЗузЕЦе). Сам по себе этот поиск и проверка наложен- 
ных на файлы условий не отличается от рассмотренного ранее. А затем, если _ 
включен индикатор СВшеа4е, идет поиск всех папок и обычных файлов 
(паблон "*.*” и атрибуты гаПгесфогу). При этом с файлами ничего не делает- 
ся, а для каждой папки осуществляется рекурентный вызов Уе\О!.. 

Подобный модуль может быть встроен в различные приложения, в кото- 
рых надо показать пользователю размещение на диске файлов, связанных 
с какой-то темой, если, конечно, их имена задавались в соответствии с ка- 
ким-то шаблоном. А саму процедуру поиска, убрав из нее все, связанное с де- 
ревом, можно использовать, например, для удаления с диска всех файлов с за- 
данным шаблоном. Подобные функции нужны для зачистки мусора — удале- 
ния временных файлов. Ниже приведена такая функция: 
роо1 ЕгазеЕ11ез$ (Ап$13%г1па Теш1афе, Апз15Ек1па р1г) 


{ 
ТбеагсиВес.58В; 
102 1гез; 
Апз15ег1иа Сиагр1г; 
// запоминание текущего каталога 
Сичг)р1х = СееСаггерЕО1хт (); 
// смена каталога, чтобы не задавать полный путь к файлам 
СВОЕ (01); 
// начало поиска файлсв, удовлетворяющих шаблону 
1гез = Е1паЕ1г5$% (Теп1афе, 0, 58); 
мр11е (1хез_== 0) — — 
{ 
Ре1есеЕ11е (5В.Маме); 
1гез = Е1лпамехе (58); 
} 
Р1паС1о$е (58); 
// завершение поиска файлов 
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// начало поиска папок 


1хез = Е1паЕ1и$Е ("*.*", Еар1гесфеогу, 58); 
мр1]е (1хез == 0 ) 
{ 
1Е ((5В.Маме != ".") && (58В.Маме != "..") && 
((ЗВ.АЕСг & Еар1гес®огу) != 0)) 


// рекурентный вызов У1еиП1г 
Егазег11е$ (Тем]абе, ПО1г); 
1тез = Е1зпа№ехЕ (58); 


} 
Е1паСТозе ($К); 


// возврат в текущий каталог 
СПО1х (Саг)тг); 
} 


Если вызвать ее, например, оператором ^ 


ЕгазеЕг11ез ("*.6тр", "О: \\ТЕМР"); 


то будут удалены все файлы с расширением фтр, содержащиеся в папке 
ОЛТЕМР и во всех вложенных папках. А если указать головную папку ваших 
проектов и задать шаблон “*.44$”, то удалятся все файлы .4$ во всех проектах. 
Это сразу очистит на диске много места, так как эти файлы огромные. 


6.6.3 Ускоренный поиск 


Рассмотренные в предыдущих разделах примеры поиска файлов и занесе- 
ния их в дерево имеют два недостатка. Во-первых, все информация хранится 
в дереве — т.е. в памяти компьютера. Если дерево большое, то это может при- 
вести к очень заметным затратам памяти. Кроме того, при большом дереве про- 
цесс его формирования может занимать большое время. А ведь пользователь 
вряд ли будет просматривать все папки дерева. Так что целесообразно сначала 
найти файлы в одной корневой папке, а поиск в остальных папках осуществ- 
лять, только если пользователь захочет открыть ту или иную папку. Такой ал- 
горитм реализован в примере РЕта3, находящемся в каталоге РИез на диске, 
приложенном к книге. Внешне он повторяет пример РЕта, но реализует по- 
очередный поиск в папках. | 

Ниже приведен код трех процедур, отличающихся от примера РЕта: 


Ууо1а __Еазеса11 У1ем01г (Апз15&г1пд О1г, ТТгееМоае *Моае ) 

| | 

// основная процедура поиска 

ТбеагсйВес 58 ; 

106 1ге5, ТВед1п; 

ТТгееМ№оае *МемМоае; 

ТТтееМоае *РМ№оае; 

6оо1 1ааа; // указывает, надо ли включать в дерево данный файл 
Апз15Ск1лпа Сигр1к; 

Сигр1хг = СееСаггеп От (); 

// смена каталога, чтобы не задавать полный путь к файлам 
СООтх (21г); 

// начало поиска . 

1гез = РлпаЕ1г$$ ("*.*", ЕаАпуЕ11е, 58); 

мр11е (1хез == 0 ) и 

{ . 
1= ((5В.Маме != ".") && (5В.Маше !="..")) 
{ 
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1ааа = +гае; 
1Е ((5В.Абег & Еа01гесбоку} == 0) 
{ 
// проверка условий, наложенных на файл 
// проверка даты 
3и1Есп (Еоги1->ВСрафа->Т%*епТпаех) 
{ 
сазе 0: ТВедлп = 0; 
ргеак; 
сазе 1: ТВед1п = РафеТ1меТоЕ11ераке (Рафе() - 7); 
Ьгеак; 
сазе 2: ТВед1п = БакеТ1меТоР11ерасе (Рафе() - 
РаузТпМопЕВ (Рафе ())); 
Ьгеак; 
сазе 3: ТВед1п = РакеТ1щеТоЕ11ерафе (Рафе()} - 
РаузТпУеаг (Рафе()))}; 
Ьгеак; 
сазе 4: 1Е (5В.Т1ме > БабеТ1меТоЕ11ераее ( 
Гоги1->ПБафеТ1терР1скег2->Па*е) ) 
ТВеч1п = 5В.Талме + 1000; 
е1з5е ТВед1п = РафеТ1меТъТоЕ11ераее ( 
Рогт1->РафеТ1мерР1скег1->Пафе); 
Ьгеак; 
ЧеЁац1+: ТВедлп = 0; 
} // конец зи1ЕсВ 
// проверка размера 
1ааа = 5В.Тлме >= ТВед1п; 
1Е (! Рогп1->СВ$12е->Стескеяа) 
1Е (Гогт1->СопроВох1->ТеемТпаех == 0) 
1ааа = 1ааа & (5В.512е > (ЕГоги1->С$р1пЕЯ1Е1->Уа1ае << 10)); 
е15е 1ааа = 1ааа & ($58В.517е < | 
(ЕГоги1->С5р1пЕа11->\Уа1ае << 10)); 
} // конец 1Е 5В.АЕЕГ & ЕаГлгесвогу) == 
1Е (1ааа) 
{ 
// занесение узла в дерево | 
МемМоае = Гогп1->Тгее\У1ем1->ТЕепмз->Ааасв11а (М№оае, 5В.Мапе); 
// задание пиктограммы 
1Е ((3В.АБЕг & ГЕа)1гескоку) ==0) 
МемМо4е->ТтадетТп4ех = 1; | 
е1зе МемМ№оде->ТтадеТпаех = 0; 
МемМоае->5е1есфеаТпаех = МемМ№оае->ТтадеТпаех; 


} 
} // конец 1Е ((5В.Мате != ".") && (5В.Мате !="..") 


// продолжение поиска 
1гез = Е1паМех® (58); 
} // конец ир1Ле 
Е1пС1о$е (58); 
// возврат в предыдущий каталог 
СВО1 Е (".."); 


\01А _ ЁЕаз®са11 ТГогм1 ; :ВЕ1п9С11сК (ТОр]есе *бепаек) 
{ 

// начало поиска 

Апз15ег1па 0101г; 

ТТхгее\№оае *РМоае ; 

// очистка дерева 

ТгееУ1ем1->Ткеп$->С1еах(); 

// снятие сортировки 

Гоги1->Тгее\1еи1->богЕТуре = Сомсет13: : $ЕМопе; 
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{ 


// корневой каталог 
21:г,= Тглм (ЕО1г->Тех®); 


1Е (Оле != "") 
{ 
1Е ( 01г[Р1г.ГепаеЬ()] == '\\\\') 
21г.ре1ефе (21г.ГепаеВ ()-1,1); 
1Е ( 01е[р1г.ТЪепаев()] != '\\') 


1х = Пк + '\\!; 
1Е(! О1гесвогуЕх1 $$ (01г)) 
{ 
ЗПомМеззасве ("Указанная папка не существует"); 
гебагп; 
} 
} 
// курсор "песочные часы" 
бсгееп->Сигзог = скНоцгС1аз$$; 
// добавление узла с именем данного каталога 
РМо4е = Гоги1-> ТгееУ1ем1 ->Т%епз->Ааасв1та (МОТ, 
// задание пиктограммы закрытой папки 
РМ№оае->ТмадетТпаех = 0; 
РМ№оае->5е1есфеЯТпаех = РМ№оае->ТтааеТпаех; 
// уход на поиск 
\У1ем)1т (21хг, РМоае); 
// курсор по умолчанию 
осгееп->Сагзог = сгреЁао1%*; 
// сортировка дерева 
ЕКогм1->Тгее\1ем1->богЕТуре = Сомс®г1$: : $ЕТех%; 
// раскрытие корневего узла 


1Е (ЕГКогм1->ТгееУ1ем1->Т$епз->ТЕеп[0]->НазСЬ11агеп) 


21х); 


Гоги1->Тгее\У1ем1->ТЕепз->Теем [0] ->Ехрапа (Ёа1зе); 


// открытие файла при двойном щелчке 
Ап515Ег1па 95; 

ТТгеемМоае *М№ае1; 

ТТгее\№оае *М№ае; 


М№оае1 = ТгееУ1ем1->5е1есфеа; 
// формирование полного пути 
5 = № ае1->Техе; 

№оае=М№оае1; 

мр11е (№ае->Рагеп® != МО,) 


Моае = №ае->Рагепе; 
$ = М№оае->Техе + "\\" +5 ; 


// если это файл, а не папка 
1Е (М№оае1->ТтадеТпаех == 1) 


5ре11Ехесифе (Напа]1е, "ореп",$.с_з%х(), МОЪЬ, МОЬЬ, $И_$НОМ); 


е1зе 1Е(! М№оае1->НазСв11агеп) 
[ 
Роги1->ТгееУ1ем1->богЕТуре = Сомсет13: : $Мопе; 
//уход на поиск 
У\У1емр1г (5$, М№ое1); 
// сортировка дерева 
Коги1->Тгее\1ем1->боге Туре 
Моае1->Ехрапа (Еа1зе); 


Сошсег1$: : $5ЕТехЕ; 


у01А __Газ®са11 ТЕГогм1: :ТкееУ1ем1051С11сК (ТОБ]есЕ *5епаег) 
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Основное отличие от кода примера РЕт4А заключается в том, что отсутствует 
рекурентный поиск в папках. Очередная найденная папка в процедуре У1ем Ол: 
просто заносится в дерево, но поиск в ней не ведется. А в функции ТгееУ1ем1- 
РЫСПсК введена проверка, не сделал ли пользователь двойной щелчок на узле 
папки, не имеющем дочерних узлов, т.е. еще не раскрывавшейся. Если оказыва- 
ется, что папка не имеет дочерних узлов, то поиск в ней не проводится. 

Сравнив экспериментально приложения РЕта и РЕта3, вы легко увиди- 
те, что там, где пример РЕта долго строит сложное дерево, приложение 
РЕтаз срабатывает моментально. 


6.6.4 Мониторинг каталогов 


Если приложение отображает список файлов и каталогов, как примеры, 
рассмотренные в разд. 6.6.1-—6.6.3, то хотелось бы, чтобы при изменениях фай- 
лов и каталогов на диске их отображение автоматически перестраивалось. Для 
этого нужен мониторинг, реагирующий на создание, удаление, переименова- 
ние файлов и каталогов. Такая возможность в \/114о\з предусмотрена. Мони- 
торинг осуществляется функциями ЕшаЕ $ СВапоеМоййсайоп, ЕшаМех{- 
СВапоеМо 1 ЯсаНоп, ЕшаСюозеСвапсеМонЯса оп. Эти функции и особенно- 
сти их применения подробно рассмотрены в разд. 3.9. Так что остановимся 
только на примере их применения. За основу возьмем проект РР1та3, рассмот- 
ренный в разд. 6.6.3, и добавим в него мониторинг каталогов. Соответствую- 
щую модификацию вы найдете на диске, приложенном к книге, в каталоге 
ЕЦез в проекте РЕ7та4. 

Форма и основной код этого проекта не отличаются от РЕта3. Изменения 
сводятся к добавлению в код одной функции и небольшому изменению функ- 
ции У1емП:г. Ниже приводится код этих изменений. 


НАМОЪЕ БСБапае = МОЬЬ, ВТ = №5; 


РИОКО МТМАРТ Т,хеааГоапс (ЪРУОТО) 
{ 
ПСВапае = Е1паЕ1г5®СРрапдадемо$1Е1сае1ол ( 
| , Когт1->ЕР1г->Техе.с_$6к(), %кие, 
<, "ТЬЕ МОТТЕУ СНАМСЕ ЕТЬЕ МАМЕ | 
. ЕТЬЕ МОТТЕУ СНАМСЕ РТК МАМЕ); 

Ма1ЕГог511091е05)ес® (ПСПапде, ТМЕТМТТЕ); 

Когм]1 ->ВЕ1пас11сК (Гогм1) ;. 

м1] е (Егае) 

{ . 
Е1паМехеСрапдемо$ 1 Е1сае1оп (ПСВапае); 
Иа1ЕГог51па1е0Б)ес* (ПСвапдае, ТМЕТМТТЕ); 
Роги1->ВЕ1паСс11скК (Еогм1); 


кебагп 0; 

} 

ее ннннннннннннннннн-н=-=======- 
\01А __Еаз®са11 У1емр1г (Ап515&г1пд Р1г, ТТкееМо4е *Моае ) 


{ 

// основная процедура поиска 

1Е(! ВТ) 

{ 

РИОКр 1рТЬгеаатТа; 

ПТ = СгеафеТЬгеаа (МОТТ, 0, ТьгеааРапс, №11, 0, &1рТЬтеааТа); 
} 
Тбеагсп Вес 5В ; 
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В проекте вводятся две новые глобальные переменные ВСфапхе и ВТ. Это 
дескрипторы, используемые далее для мониторинга и для создания потока, 
в котором этот мониторинг реализуется. Дело в том, что мониторинг связан 
с ожиданием какого-нибудь события в контролируемом каталоге. Если подоб- 
ное ожидание вставить в основной поток, приложения, то приложение завис- 
нет — остановится, и не будет реагировать ни на какие действия пользователя. 
Это, конечно, недопустимо. Поэтому ожидание организуется в отдельном пото- 
ке, выполняемом параллельно с основным. Переменная ВТ является дескрип- 
тором этого потока. Если все сказанное не очень вам понятно, посмотрите под- 
робнее описание работы с потоками в разд. 3.8. 

Функция ТВгеааГипсе является функцией, с выполнения которой начина- 
ется поток. Первый оператор вызывает функцию ЕшаЕ!' 5 СБапгеМойЙса оп 
(см. разд. 3.9), которая начинает мониторинг и возвращает дескриптор ВСВап- 
хе. Первым аргументом этой функции задается путь к тому каталогу, монито- 
ринг которого требуется осуществлять. В данном. случае этот путь читается из 
окна редактирования с именем ЕП!` формы Еогт1. Второй аргумент указыва- 
ет, надо ли осуществлять мониторинг всего дерева каталогов, начинающегося 
с указанного, или достаточно осуществлять мониторинг только самого указан- 
ного каталога. Указанное в примере значение фгае задает мониторинг дерева. 
Третий аргумент является комбинацией флагов, которые определяют, какие 
именно события надо отслеживать. В примере задан флаг ЕШЕ_ МОТЕ 
ЕУ СНАМСЕ_ЕП.Е_МАМЕ, соответствующий событиям создания, удаления, 
переименования файлов, и флаг ЕП.Е_ МОТТРУ СНАМСЕ_ОТВ_МАМЕ, обес- 
печивающий отслеживание аналогичных событий для папок (каталогов). 

Второй оператор приведенного кода вызывает функцию ожидания М\МаЦ- 
Еог5 те ОБес& (см. разд. 3.1). Она ожидает наступление одного из событий, 
заданных при создании дескриптора ВСВапее. Время ожидания не ограничено 
(второй аргумент функции равен ПМЕТМТТЕ). Если событие произойдет, вызы- 
‚ вается функция данного проекта ВЕшАСИПеК (см. разд. 6.6.3), которая обеспе- 
чивает отображение дерева файлов и папок, 

После этого надо обеспечить ожидание новых событий. Для этого органи- 
зуется бесконечной цикл \Юе, в котором вызывается функция ЕшаМех{- 
СВапзеМойЙсайЙоп, обеспечивающая продолжение отслеживания событий, 
функция ожидания УаЦЕогэЭто1еОес, а при наступлении события — 
функция ВЕш@СПсК. Тело цикла аналогично коду, рассмотренному ранее. 
Только вызов функции т оваввеМон Иса оп. заменяется вызовом 
‚ функции ЕтаМех СВапбеМоййЙса в оп. 

Функция Уле\ПО!:г осуществляет процедуру поиска файлов и каталогов. 
Она подробно рассмотрена в разд. 6.6.3. Приведенный вариант отличается от 
рассмотренного только несколькими первыми операторами. Оператор Ш прове- 
ряет дескриптор потока ВТ. Если он равен нулю, значит, поток еще не созда- 
вался. В этом случае он создается функцией СгеафеТВгеа4 (см. разд. 3.8). В нее 
передается адрес описанной выше функции ТогеаЯРипс, которая начинает 
выполнение потока. Переменная 1рТЬгеа9 ТА и ссылка на нее в вызове Сгеафе- 
'Ггеа@4 указаны только для совместимости кода с \У/т4о\з 98. При работе с бо- 
лее поздними версиями \У/1шо\з это объявление не требуется, и последний ар- 
гумент в вызове СгежфеТЬгеа4 можно задать равным МОТГ. 

Выполните приложения с описанными дополнениями и попробуйте в на- 
блюдаемом каталоге создавать, удалять, переименовывать средствами \УМт- 
4о\з файлы и каталоги. Вы сможете убедиться, что приложение отслеживает 
все эти изменения. 
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6.6.5 Просмотр папок \Мт4о\м/$ на основе 115 \Ме\ми 


Все предыдущие примеры отображали файлы и папки в виде дерева. 
В данном разделе мы рассмотрим пример создания на основе компонента 
Таз Уле\у приложения, в котором файлы отображаются в виде значков, спи- 
сков, таблиц наподобие стандартной программы работы с папками \У/1т4о\з. 
И даже несколько более мощного, поскольку пользователю предоставляется 
возможность отбирать файлы по шаблонам, размеру, дате. 

Этот пример вы найдете на приложенном к книге диске в каталоге РЦез 
в проекте Р/43{Утеш. На рис. 6.10 приведен вид приложения во время выполне- 
ния. 

Основную часть главной формы занимает компонент 11$ Йе\м. Над ним 
находится метка Эф$айеТех&, в которой отображается путь к папке, шаблон 
и условия отбора файлов. Вверху окна расположена инструментальная панель 
ТооВаг с рядом кнопок. Крайняя левая (ее имя в приведенном далее коде 
ТЕо]4ег) открывает диалог выбора папки. В первый момент в 115$ Ул1е\м отобра- 
жается корневой каталог того диска, на котором находится исполняемый 
файл проекта, а затем пользователь может выбрать с помощью кнопки 
ТЕо4ег любую другую папку на любом диске. Вторая слева кнопка (ТВОр) по- 
зволяет перейти в папку, расположенную на ближайшем верхнем уровне. 
Двойной щелчок на значке какой-то папки в окне 11$ У1е\ позволяет посмот- 
реть состав этой папки. Двойной щелчок на значке какого-то файла в окне 
Гл У1лем позволяет выполнить исполняемый файл или вызвать программу, 
обслуживающую выбранный файл документа. 

Следующие четыре кнопки инструментальной панели задают форму ото- 
бражения: крупные значки (имя кнопки ТЕГсоп, пример на рис. 6.10 а), мел- 
кие значки (ТВб5таШсоп, рис. 6.10 6), список (ТВТА$%, рис. 6.10 в), таблица 
(ТВКБерогф, рис. 6.10 г). Для этих четырех кнопок свойство Сгопре4 установ- 
лено равным фгиае, так что в каждый момент времени включена может быть 
только одна из них. В исходном состоянии включена кнопка ТВТсоп, у кото- 
рой свойство Вомп задано равным фгие. 

Крайняя правая кнопка (ТВТоо5) инструментальной панели вызывает 
вспомогательную форму, показанную на рис. 6.10 д. В верхнем окне редакти- 
рования Шаблон (ЕРаЦЙегп) пользователь может задать шаблон, которому 
должны удовлетворять отображаемые файл. По умолчанию шаблон равен 
"*.Х" — все файлы. Ниже окна редактирования расположена панель Размер 
файла. На ней имеется индикатор любой (СВ$12е), включение которого означа- 
ет отсутствие контроля размера файлов. Если же этот индикатор выключен, 
становятся доступными расположенные ниже выпадающий список Сото- 
Вох1 и компонент СЗртЕЯИ1. Список СошфоВох{ содержит две строки: “не 
менее" и "не более", а компонент СЗршЕЯИ1 дает возможность пользователю 
задать граничное значение размера файла. 

В нижней части окна вспомогательной формы находится панель Дата соз- 
дания файла. Она содержит группу радиокнопок с именем ВСО,афа, позволяю- 
щую ограничить отбираемые файлы по дате. Верхняя кнопка “любая” исклю- 
чает отбор по дате. Нижняя кнопка “в диапазоне” делает доступными компо- 
ненты ОафеТ!итеР1сКег1 и ЮОаеТ!ипеР1сКег2, позволяющие пользователю за- 
дать соответственно начальную и конечную дату диапазона. А остальные 
кнопки радиогруппы ВСОафёа позволяю задать различные интервалы времени: 
последняя неделя, месяц, год. 
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Рис. 6.10 
Приложение во время выполнения: 


главная форма в режиме больших (а) КирАВ\: = размер любой: дата жби 


и малых (6) значков, мо г и | == 


Вб 8.40 С++ _Асйм... СВ6.5 
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При закрытии вспомогательной формы занесенная в нее информация пе- 
редается в главную форму, и осуществляется новый поиск файлов с учетом 
введенных пользователем ограничений. 

Вернемся теперь к главной форме. Ее инструментальная панель Тоо!Ваг1 
связана свойством Ппабез со списком изображений ПпадеГ1$%, названным 
в приведенном далее коде именем ПпабеГ!л5{Тоо]Ваг. В этот список помимо 
изображений, использованных в кнопках панели, включена пиктограмма пап- 
ки, используемая при отображении папок в окне [1$ У1е\1 (индекс этой пик- 
тограммы, используемый в приведенном далее коде — 7). Главная форма со- 
держит еще два списка изображений [ПпарбеТ15${ с именами ПпахеГ. 1$ Могта] 
и ПпабеТ!15{Зта|. В эти два списка программно заносятся соответственно 
крупные и мелкие пиктограммы файлов. В списке Ппазе!Г 1$ Могта] размер 
пиктограмм задан равным 32 х 32, а в списке ПпагеГ! 15 Эта — 16х 16. 
Ссылки на эти списки занесены в свойства ГагееГпахез и ЗтаШтахе$ компо- 
нента 115 У1ем1. 

В режиме таблицы в окне 11$ У1е\м1 осуществляется управление сортиров- 
кой. Пользователь может щелкнуть на заголовке одного из столбцов: 
"Файл/Папка”, “Размер”, “Дата”, и сортировка будет производиться в поряд- 
ке возрастания значений в этом столбце. Повторный щелчок на заголовке того 
же столбца поменяет последовательность сортировки на убывающую. В заго- 
ловке столбца, по которому происходит сортировка, ставится символ "+" или 
"-” в зависимости от направления сортировки (см. этот символ в первом столб- 
це на рис. 6.10 г). 

Ниже приведен код главного модуля приложения. 

#1пс1и4е <ус1.6> 


#1пс1аае "Е11еС6г1.6рр" 
#1пс1иае "Рафе0е115.врр" 


ТРГоги1 *ГРогп1; 


Апз15Ег1па 01г; // папка, содержимое которой отображается 
Т1зЕТеем* бе1есфеа; // выделенный элемент 

10 Со1атпТпаех = 0; // индекс упорядочиваемого столбца таблицы 
Ап$15Еглра Т16е1$[3] = {"Файл/Папка ", "Размер ", "Дата "}; 


у01А __Еаз®са11 ТЕогм1: :ТЕо1АегС11сКк (ТОБ)есЕ *5епаег) 
{ 


бе1есЕр1гесфокгу ("Выберите папку", "", 201); 
1Е(2Р1к([Р1к.Бепаев()] != '\\') 

Р1г = Рак + "\\"; | 

Е1па(); 
} 
нннннннннннн-ннн---нн---==============--==---- 


\01А __Еаз®са11 У1емр1хт (уо1а) 

{ 

// основная процедура поиска 

ТбеагсИВес 5В ; 

1п0Е 1гез, ТВед1п; 

ТЬ1зЕТееш *МемтТеем; 

Боо]1 1ааа; // указывает, надо ли отображать данный файл 
Т$5НЕ11еТпЕо Е11е1ТпЕо; 


ТТсоп *Тсоп = пем ТТсоп; 
Гоги1->Тмаает1$&Могма1->С1еаг(); 


Роги1->Тмадчет1$5бта11->С1еаг(); 
Коги1->Тмадер15{Тоо1Ваг->СееТсоп (7, Тсоп); 


у 
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Гогт1->Ттадет1$%Могта1->АадаТсоп (Тсоп); 
Гогт1->Ттаает 1$ 5та11->АааТсоп (Тсоп); 
// вычисление начальной даты 
$м1ЕСН (Роги2->КСрафба->ТбепТпаех) 
сазе 1: ТВеа1п = РафеТтмеТоЕ11ерафе (Рафе () - 7); 
Бгеак; 
сазе 2: ТВеа1п = РафеТ1меТоЕ11ерафе (Рафе () - 
РаузТпМопЕП (Раёе())); 


Бгеак; 
сазе 3: ТВедап = РакеТ1теТоЕ11ераке (Ра®е() - 
РаузТпУеахг (Рафе())); 
Ьгеак; | 
сазе 4; ТВеа1п = РафеТ1щеТоЕ11ерате ( = — 
Еогм2- >Ратет{мер1скег1- ->рафе) ; 
БгеаКк; 


ЧеЁац1%: ТВедлп = 0; 
} 
// смена каталога 
СВО (21); 
// начало поиска 
1гез = ЕРЕ1парг1т5$Е (Гоги2->ЕРаефегп->Техк, 
ЕаН1Ааеп+ЁЕа$у$Е11е, 58); 
мр11е (1хез == 0 )} 
{ 
1Е ((5В.Маме != ".") && (58В.Мапше != "..")) 
{ 
1ааЯ = Егаое; 
1Е ((5В.АбЕг & Еа01гесвогу) == 0) 
{ 
// проверка условий, наложенных на файл 
// проверка даты 
1Е((Гоги2->ВСраба->ТеепТпаех == 4) &&. 
(5В. Т1те > ПабеТт1пеТоЕ11ераее ( 
РКоги2- >РакеТ1теР1скег2- —>рафе))) 
1ааа = Еа1зе; 
е15е 1аа4 = 5$В.Тлме >= ТВед1п; 


// проверка размера 
1Е (! Роги2->СВ$1хе->Срескеа) 
1Е (Роги2->СопЬоВох1->ТепшТпаех == 0) 
1ааа = 1ааа & (58В.517е > (Гоги2->С5р1пЕЯ1е1->Уа]1ае << 10)); 
е15е 1ааа = 1ааа & (5В.512е < (РГогт2->С$р1пЕа1е1->Уа1ае << 10)); 
} 
1Е (1ааа) 
{ 
// занесение элемента в список 
МемТеет = Гогм1->Г1$Е\/1ем1->Т$емз->Ааа (); 
МемТкем->Сар+1оп = $В.Мапе; | 
// задание пиктограмм 
5НбееЕ11еТтЕо ( (2Р1г + 5В.Маме).с 56г(), 0, &Р11етпЕо, 
$17е90Е (ЕР11е1ТпЕо), _ 
З5НСЕТ _ТСОМ | $НСЕТ `ТАВСЕТСОМ) ; 
Тсоп->Напа1е = Е11е1ТтЕо.ИТсоп; 
Гогм1->Ттадет1$ЕМогма1->АаЧТсоп.(Тсоп) ; 
5НбееЕ11етТпРо ( (0201г + $5В.Маме).с_$%г(), 0, &Р11етТпРо, 
$17е0Е (Р11еТпЕо), 
ЗНСЕТ ТСОМ | $ЗНСЕТ _ЗМАБЬТСОМ) ; 
Тсоп->Напа]е = Е11етпЕо.ВТсоп; 
Роги1->Тмадер1$Е5бта11->АааТсоп (Тсоп); | 
МемТсеп->ТтадчеТпаех = Гоги1->Тмтаде1$ЕМогиа1->Соцпе - 1; 


432 Глава 6. Работа с дисками, файлами и каталогами 


// занесение размера файла 
МемТЕещ->барТЕемз->Ааа (5В.512е); 
// занесение даты файла 
МемТсеп->боТепз->Ааа (ВабеТ1теТобег ( 
Е11ерасеТора&еТ1те (5В.Т1пе))); 
// отметка элемента как файла — 
МемТееп->Оуег]ауТпаех = 1; 
} 
} 
// продолжение поиска 
1хез = Елрамехе (58); 
Е1паС1о5е (58); 
// завершение поиска файлов. 


// начало поиска папок 
1гез = Е1паЕ1г$е ("*.*", Еа)р1тгесеогу, 58); 


и11]1е (1гез == 0 ) 
{ 
1Е ((5В.Маме != ".") && (5В.Мате != "..") && 
((ЗВ.АЕСг & Еа)1гесфогу) != 0)) 


{ 
МемТеет = Еогш1->11$6\У1ем1->Т$етмз->АЗа (); 
МемТЕем->Сар®1оп = 5В.Мапе; 
// задание пиктограммы 
МемТ$еп->ТмадеТпаех = 0; 
// пустая строка вместо размера 
№МемиТкеп->5оюТЕемз->Ааа (""); 
// дата папки 
МемТеепт->бабТЕемз->Ааа (рафбеТ1теТоЗ к ( 
'Е1]еракеТтора&еТ1ме (5В.Т1ме))); 

// отметка элемента как файла 
МемТсет->Оуег1ауТпаех = 0; 
} 

1гез = Е1памехе (58); 

} 

Е1паС1озе (58); 


112 _ $аса11 СазкомбогЕРгос (1оп49 Т&ем1, 1опд Теема, 
опа Рагамбог®) 
| 


// Функция, обеспечивающая сортировку 


108 К; 

1Е (Гоги1->Т1$56\У1ем1->Со1аппз->Т6етм$ [Рагамбог®] ->Таач == 0) 
к=1; // нарастающая последовательность 

е1зе К = -1; // убывающая последовательность 


$м16ср (Рагамбог®). 
{ 
сазе 0: 1Е (((ТЬ15ЕТЕет *) ТЕетм1) ->Оуег1ауТпаех == 
((ТЬ15ЕТеем *) Теем2) ->Оуег1ауТпаех) 
гесагп К * Ап$1СопрагеТехе ( 
((ТЪ1зЕТЕем *) Тбеп1) ->Сар®1оп, — 
((ТР1эзеТЕем *) ТЕем2) ->Сар®1оп); 
е1зе гебагп ((ТТлзЕеТеем *) Т6ем1) ->Оуег1ауТпаех - 
| ((ТЪ1зетеем *).Тем2) ->Оуег1ауТпаех; 
сазе 1: 1Е (((ТТ1зеТеем *)Теет1) ->Оуег1]ауТпаех != 
’((ТЬ1зеЕТеем *) Теем2) ->Оуег1аутТпаех) 
гебагп ((ТТ1зеТеем *)ТЕеп1) ->Оуег1ауТпаех - 
| ((ТТ1зеТеешм *)Теем2) ->Оуег1ауТраех; 
е1зе 1Е(((ТЬ1зеТфет *) Тфем1) ->барТеемз->56г1па$[0] == 
((Тт1зЕТеем *) Теем2) ->5арТЕетз->5ег1па$[0]) 
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гесигп Апз1СотрагеТехе® ( | 
((ТЪ1зЕТеем *)Т6ет1) ->Саре топ, 
((ТЪ15ЕТеем *)Теем2) ->Сар®1оп); 
е1зе гебигп К * Сопраге\Уа1ае ( 
ЗЕгТотТпЕ ( 
((ТЬ1зЕТееюм *) Тем!) ->5арТЕет$->56г1па$[0]), 
ЗЕгТотТпЕ ( 
(ТГ1зеТеем *) Теем2) ->5артТ6ем$->56г1па$[0])); 
сазе 2: гефоагп К * СопрагерафеТл1ште ( 
ЗЕгТораЕеТ1те ( 
((ТЪ1тзеТеем *)Теем1) ->5а5 Т$ептз->5Ег1лпа$ [1]), 
ЗЕгТорафеТ1ме ( 
((ТЪ1зеТеею *) Т%ем2) ->5а6 Г емз->5Ег1па$[1])); 


У01А __Еаз®са11 ТРГогм1 : : Р1па (уо1а) 
{ 
// начало блокировки списка 
.156\У1ем1->ТЕет$->Вед1п0Орааее (); 
// очистка списка 
156 У1ем1->Т6етз->С1еат(); 
// снятие сортировки 
.1$6\У1ем1->5богЕТуре = Сомс®г1$: : 5ЕМопе; 
// курсор "песочные часы" 
Зсгееп->Сигзог = сгНочгС1а$$; 
Зсае1сТех®1->Сар®1оп = О1г + РГоги2->ЕРабкегп->Техё + 
"; размер "; 
1Е (Гоги2->СВ$12е->Стескея) 
ЗЕае1сТех*1->Сар®1оп = ЗЕа&1сТехЕ1->Сар®1оп + "любой; дата "; 
е15е ЗЕафе1сТехе1->СарЕ1оп = 5ЗЕаф1сТех®1->Саре1оп + 
ГРоги2->СопроВох1->ТехЕе + " " + 
Коги2->С$р1пЕа1*1->Техё + 
" КБ; дата "; 
ЗЕаф1сТехЕ1->Сар®1оп = бкае1сТехЕ1->СарЕ1оп + 
Роги2->ЕКСрафа->Т$етз->56г1па$ [Гоги2->ВСрРафа->Т+ептпаех]; 
1Е (Еоги2->ВСПГака->ТкетТпаех == 4) 
ЗЕае1сТехЕ1->Сар®1оп = бЕа®1сТехЕ1->Саре1оп + " " +. 
РабеТобЕг (Гогхм2->ПРакетТ1меР1сКкег1->раЕе) + 
" — "+ ОБабеТобег (Рогп2->РабетТ1пеРрР1сКкКегк2->раее); 
// уход на поиск 
У1емО1х (); 
// курсор по умолчанию 
5сгееп->Сагзог = сгреЕац1{; 
// сортировка элементов 
.15&\/У1ем1->богЕТуре = Сомс®г13$: : $ЕТехЕе; | 
156 \/1еи1->Сазбомбог® (СазбомбогЕРгос, Со1аппТпаех); 
// окончание блокировки списка 
.1$5%\У1еи1->Т&емз->ЕпаОрааке(); 


у01А _ Еаз®са11 ТЕГогп1: :ТВТсопС11сК (ТОБ)]есЕ *5епаег) 
{ 

// крупные значки 

Т1$Е\У1ем1->\У1ем5еу1е = у$Тсоп; 


у01А __Еа5®са11 ТРГогм1: :ТВ5ма11ТсопС11сКк (ТОБ)есе *5епаег) 
{ 

// мелкие значки 

.156\/У1ем1->\У1ем5еу1е = \у$бща11Тсоп; 

} 
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Уу01А __ Еазеса11 ТГогм1: : ТВТ1$6С11сК (ТОр)есЕ *5епаег) 
{ . 

// список 

Т1$6\У1ем1 ->\Утембеу1е = 5115; 


// таблица 
// Формирование заголовков столбцов 
ох (10 1 = О; 1 < 3; 1++) 

{ . 

1Е(1 == Со1атпТпаех) 
{ 
1Е (1156 \У1ем1->Со1апп$->1Еемз$ [1] ->Таа == 0) 

11$ \/1ем1->Со1атп$->Т6ем$ [1] ->Сар®1оп = Т16е1$1[1] + "+"; 
е1зе 1Г1$5Е\У1ем1->Со1аппз->Теетз [1] ->Сар®1оп = Т16е1$[1] + 


и_\н. 
Га 


} | 
е1зе 1Т1$%&\У1ем1->Со1аппз->ТтТеем$ [1] ->Сар®1оп = Т16е15$[1]; 


} | 
.1з6\У1ем1->\У1емзеу1е = узВерогф; 

// заказная сортировка 

1$ \/1ем]1 ->СазбомбокЕ (СазбошбогЕРгос, Со1итпТпаех}); 


\01А __Еаз®са11 ТЕогп]1 : : 615ЕУ1ем1Моцизеро\мт (ТОБр)есЕ *5епаекг, 
ТМонзеВаЕ оп Вабоп, Т5В1ЕЕбеаее 5ЗР1ЕЕ, 1пЕ Х, 1пЕ У) 

{ 

// запоминание выделенного элемента 

бе1есфееЯ = Т1$5%\У1ем1->СесТеемаф (Х, У); 


у01а _ Еаз®са11 ТГоги1: :4$\У1ем1061С11сК (ТОБЗесЕ *5епаег) 
{ | . 
// двойной щелчок на элементе 
1Е (бе1есъея) 
{ 
1Е (Зе1ескеа->Оуег1ауТпаех == 0) 
{ 
// раскрытие папки 
21: += 5е1есфеа->Саре1оп + "\\"; 
Еапа (); 
} 
// открытие файла 
е1зе 5Ве11Ехесиее (НапЯ1е, "ореп", 5е1есфеЯ->СарЕ1оп.с_зег(), 
МОГ, МОЬЬ, $М_5$НОМ); 


\01А _ Еаз®са11 ТРогт1 : :ТВОрС11 ск (ТОБ]есе *бепаег) 
{ | | 
1Е (21хг.Бепаев() > 3) 


{ 
1х = О1х.баббЕг1па (0, Р1г.боа556г1пч ( 
| 0, О1х.ТепафВ ()-1) .ТазЕ0е11т1$ек ("\\")); 
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у01А _ Еазса11 ТЁГоги1 : : 6156 /1ем1Со1итпС11сКк (ТОр]есЕ *5епаекг, 
ТЬ1$ЕСо1ати *Со1ати) 


{ 

1Е (СоТаппТпаех == Со1аппл->Тпаех) 
Со1апп->Таз = 1 - Со1атп->Таа; 
е1зе Со1ампТпаех = Со1атп->Тпаех; 
ТВКерокг®С11скК (бепаег) ; 


у0о1Аа __Еазеса11 ТГоги1: : Коги$пом (ТОБ)]есе. *5епаег) 
{ 


// задание начального значения папки П1г 

21ух = ЕхегасеЕ11ергтуе (Арр11саб1оп->ЕхеМапе); 
ТЕ (21х [Р1г.Бепаей ()] == ':') 

Бах += "\\"; 


РГоги2->5помМоаа1 (); 
Е1ра (); 
} 


Функция ТЕо]4егСПеК является обработчиком щелчка на кнопке ТЕо]4ег, 
обеспечивающей задание пользователем папки, содержимое которой он хочет 
посмотреть. Обработчик вызывает функцию 5Э@есПО1гесвогу, рассмотренную 
в разд. 6.5. Выбранный пользователем путь к папке заносится в глобальную 
переменную Пг. Проверяется, является ли последний символ этой перемен- 
ной слэшем. Если нет, то путь дополняется слэшем. В заключение вызывается 
описанная далее функция Е\Ш@, обеспечивающая просмотр и отображение со- 
держимого папки. 

Функция У1е\мО!` обеспечивает поиск в заданной папке. Эта функция в ос- 
новных чертах подобна аналогичным функциям, рассмотренным в разд. 6.6.2 
и 6.6.3. В ней сначала ищутся файлы, удовлетворяющие заданному шаблону 
и ограничениям, а затем ищутся все вложенные папки. 

В начале функции после ряда объявлений создается объект феоп класса 
ТГеоп, который в дальнейшем будет использоваться для получения пикто- 
грамм файлов. Затем очищаются списки изображений Ппазе!1${Могта1 
и ПпайеГ! 1$ {$та| от пиктограмм, использованных при предыдущем поиске. 
Далее в переменную Гоп методом @е Мсоп заносится из списка ПпабеГ1$$- 
Тоо]Ваг пиктограмма с индексом 7. Как было сказано ранее, эта пиктограмма 
используется для отображения папок. Она заносится в предварительно очи- 
щенные списки ПпабеТ. 15 Могта! и ПпабеТ. 15 ЗтаП, так что пиктограмма па- 
пок становится первой в этих списках. 

Затем по состоянию группы радиокнопок ВСБавёа вспомогательной формы 
проверяются заданные критерии отбора по дате. В зависимости от включенной 
радиокнопки устанавливается дата ТВебш, начиная с которой файлы должны 
отбираться. При этом используются функции Вау$шМоп{ В (число дней в ука- 
занном месяце) и ВаузтУеаг (число дней в указанном году), объявленные 
в файле Даёе(Н13.йрр. Поэтому к модулю директивой шеа4е подключен этот 
файл. | | | 
После завершения подготовительных операций идет поиск файлов, уже 
рассмотренный в предыдущих разделах. Отличие заключается в проверках ус- 
ловий, наложенных на поиск. В результате сравнения даты файла с рассчитан- 
ной датой ТВезт и заданной максимальной датой задается значение фгцае или 
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Га]5е переменной 1а44, которая показывает, должен ли отображаться данный 
файл. Затем проверяется, удовлетворяет ли файл заданным ограничениям на 
размер. 

Если файл удовлетворил всем проверкам, то методом Цетз—>А@4 компо- 
нента 11$ У1е\1Т создается новый элемент списка №емЦет. В его надпись 
СарИоп заносится имя файла 5В.Маше. Затем последовательными вызовами 
функции ЗНСе ЕПеП\о (см. разд. 5.4.1) осуществляется доступ к большой 
и малой пиктограмме файла. Возвращенные функцией дескрипторы пикто- 
грамм Е|еП\о.ВТсоп заносятся в качестве дескрипторов объекта Теоп, и этот 
объект добавляется в списки пиктограмм ПпабеТ. 1$ Могта] и Ппазе1.1${Зта|. 
Индексы добавленных пиктограмм задаются как индексы изображений Ппа- 
=ет4ех нового элемента М№емЦет. Далее в качестве дочерних узлов Зи Цетз$ 
элемента М№емЦет задаются строки, соответствующие размеру файла и его 
дате. Эти строки будут появляться в окне 11$%\У1ем1Т в режиме таблицы 
(см. рис. 6.10 г). В заключение в параметр ОуеаутФех элемента МемЦет за- 
носится 1. Этот параметр не используется в приложении по его прямому на- 
значению. Он используется как признак того, что элемент соответствует файлу 
(значение 1), или папке (значение 0). 

После завершения поиска файлов производится поиск папок, включенных 
в данную. Этот поиск достаточно прокомментирован в коде, так что дополни- 
тельные пояснения, вероятно, не требуются. 

Функция СизботзЗог Ргос является функцией, осуществляющей заказ- 
ную сортировку элементов в режиме таблицы. В эту функцию передаются 
в качестве параметров Цет1 и Цет2 пары элементов списка [1$ У1ем1. В ка- 
честве параметра Рагат$Зогф передается индекс столбца, по которому прово- 
дится сортировка. В объектах столбцов (элементах коллекции 11$ У1ем1-> 
Со! 1тп$) свойство Таё используется для задания направления сортировки: 
О — нарастание, 1 — убывание. Функция должна возвращать отрицательное 
число, если элемент Цет1 должен отображаться раньше элемента Цетё, воз- 
вращать положительное число, если элемент Цет1 должен отображаться по- 
сле элемента Цет2, и возвращать 0, если элементы эквивалентны по последо- 
вательности их отображения. 

В начале функции по значению свойства столбца Тай определяется на- 
правление сортировки. Соответственно, в локальную переменную К заносится 
+1 при сортировке по нарастанию, и -—1 при сортировке по убыванию. Затем 
в зависимости от индекса столбца Рагат5огё и значений параметров элемен- 
тов Цетт и Цет2 функция возвращает необходимое значение. Элементы 
Цет1 и Цет2 передаются в функцию как значения типа 1юпх. Поэтому во всех 
сравнениях они явным образом приводятся к типу указателей на объекты 
ТГ 5$ Цет, чтобы можно было обращаться к свойствам элементов. 

В нашем приложении мы хотим, чтобы при сортировке по первому столб- 
цу (Рагат5огё = 0) сначала отображались папки, потом файлы, а в каждой из 
этих двух групп сортировка осуществлялась в прямой или обратной алфавит- 
ной последовательности. Поэтому при равных значениях параметров Оуе1ау- 
Гпдех (напомню, что эти параметры мы используем для отображения типа эле- 
мента: 1 — файл, 0 — папка) осуществляется сравнение надписей элементов 
функцией Ап$1СотрагеТехё, результат которой умножается на К. Это обеспе- 
чивает прямую или обратную алфавитную последовательность. А если значе- 
ния параметров Оуегауш@ех различны, то меньшим считается элемент 
с ОуеауШФех = 0 (папка). 
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При сортировке по второму столбцу (размеру) логика несколько сложнее. 
Так как размеры папок не фиксируются, то для папок параметр За Цетз-—> 
9(1155[0] является пустой строкой. Так что мы по-прежнему хотим, чтобы 
сначала отображались папки, потом файлы, папки упорядочивались по алфа- 
виту, а файлы упорядочивались в возрастающей или убывающей последова- 
тельности их размеров. А если размеры нескольких файлов одинаковы, то они 
должны располагаться по алфавиту. Поэтому сначала проверяются значения 
параметров Оуе ау тех элементов. Если они различны, то меньшим считает- 
ся элемент с Оуе|аутфех = 0 (папка). При одинаковых значениях Оуе1ау- 
[пех проверяется, не равны ли друг другу значения Зи  Цетз$—>5{115$[0]. 
Если равны, то соотношение элементов определяется алфавитной последова- 
тельностью — применяется функция Ап$1СотрагеТех& к надписям (Сарйоп) 
элементов. А при неравных значениях Зи 6 Цет$—>5ит5$[0] они переводятся 
функциями Э%&гТо[щ в целые числа, сравнение которых осуществляется функ- 
цией СотрагеУа]ше, умноженной на К. 

При упорядочивании по третьему столбцу (дате) все проще. Даты перево- 
дятся функциями ЭИ''Тора%4ёеТи!ите в значение типа ТОафеТипе, сравнение ко- 
торых осуществляется функцией СошрагедаеТ!пе, умноженной на К. 

Использованные в этом коде функции СотрагеУаШше и Сотрагера{еТипе 
объявлены в файле Дате0113.Прр, который подключен к модулю директивой 
ше де. 

Функция Е1щ4, объявленная в классе модуля, осуществляет управление 
поиском и отображением списка. Сначала методом Вет Ордафе список 115{- 
\У1е\1 блокируется, чтобы избежать отображения во время поиска и тем са- 
мым сократить затраты времени. Затем список очищается, снимается его сор- 
тировка, курсору придается форма песочных часов. Далее следует ряд доста- 
точно простых, хотя и громоздких, операторов, отображающих в метке За с- 
Тех{1 путь к папке и условия отбора файлов. После этого вызывается описан- 
ная выше функция УемПг. В заключение восстанавливается форма курсора, 
восстанавливается сортировка, в качестве функции заказной сортировки мето- 
дом СизботЭог& задается описанная ранее функция Сизфот ог Ргос, а в каче- 
стве ее последнего аргумента передается глобальная переменная Со ати паех. 
Как будет показано далее, в эту переменную заносится индекс столбца, по ко- 
торому пользователь хочет проводить упорядочивание данных. 

Функции ТМеопСПек, ТВЗтаШеопСПсК и ТВТА$СЦсК являются обра- 
ботчиками щелчков на кнопках, устанавливающих форму отображения в виде 
больших и малых значков и в виде списка. В этих функциях просто задается 
соответствующее значение свойства Уле\у 5 Уе компонента 1,15% У1ем1. Функ- 
ция ТВВерогёСПсК, являющаяся обработчиком щелчка на кнопке, задающей 
форму отображения в виде таблицы, могла бы быть столь же простой. Но она 
осложняется нашим желанием отображать в заголовке столбца, по которому 
проводится упорядочивание, символов "+" или "-", показывающих направле- 
ние упорядочивания. Поэтому в функции содержится цикл, в котором заго- 
ловки столбцов с индексом, отличным от СоатиШФех (переменная, содержа- 
щая индекс столбца, по которому проводится упорядочивание), формируются 
из массива ТЦе]$, содержащего тексты заголовков. А при индексе равном 
Со] итишаех к тексту добавляется символ "+" или "-" в зависимости от значе- 
ние свойства Тай столбца. После формирования заголовков задается стиль ото- 
бражения узВерогё и выполняется заказная сортировка, для чего вызывается 
метод Сизфотбогё, в который передается функция сортировки Сизфотбог&- 
Ргос и индекс столбца Соатп тех. 


438 Глава 6. Работа с дисками, файлами и каталогами 


= вы. 


Функция 11$ У1ем1Моцзедомп является обработчиком события ОпМо- 
и5еДо\мп компонента 1.15 У1ем1. В глобальной переменной Э@аесфе4 запомина- 
ется элемент, над которым находится в этот момент курсор мыши. Этот эле- 
мент определяется методом Се ЦетА{ компонента 11$ У1ем 1. Если под курсо- 
ром элемента нет, то в ЭЩеёфе4 заносится МОШ.. 

Функция 11$ ем 1 РЫСПЦсК является обработчиком события ОпОЫСЦек 
компонента 11$%\У1е\м1. Сначала проверяется, занесен ли элемент в перемен- 
ную Э@есед. Если занесен, те по его свойству ОуеаутФех определяется, со- 
ответствует ли элемент папке или файлу. Если это папка, то ее имя добавляет- 
ся к пути ПИ, так что От становится путем к этой папке. После этого вызыва- 
ется описанная ранее функция Еат@, обеспечивающая отображение содержи- 
мого папки. Если выделенный элемент является файлом, то он открывается 
функцией эве|Ехесфе. Ради этой функции к модулю подключен директивой 
файл ЕИеСт.йрр. 

Функция ТВОрСИЦесК является обработчиком щелчка на кнопке, обеспечи- 
вающей переход в родительскую папку. Сначала проверяется длина пути, за- 
писанного в переменной Ряаг. Если она не больше трех, то это корневой каталог 
диска, так что никакого родительского каталога нет. А если длина строки Ог 
больше трех, то из нее вырезается подстрока, заканчивающаяся предпослед- 
ним слэшем, т.е. отбрасывается ссылка на последнюю папку. Делается это 
так. Внутренний вызов метода Зи 6$ #те в этом операторе создает строку, 
длина которой на 1 меньше длины строки ПО!:г. Тем самым отсекается заключи- 
тельный слэш. К созданной строке применяется метод Газ ОейтЁег, опреде- 
ляющий позицию последнего слэша. А внешний вызов метода Зи 6 фгше вы- 
резает из О!г подстроку, заканчивающуюся в этой позиции, и заносит ее в П!г. 
После формирования нового значения Пг вызывается функция Е1а@, обеспе- 
чивающая отображение содержимого новой папки. 

Функция 11$ У1ем1СоатиСПсК является обработчиком щелчка на заго- 
ловке столбца при отображении папки в виде таблицы. В обработчик передает- 
ся параметр Со]ити, являющийся указателем на объект столбца. Если индекс 
этого столбца совпадает с запомненным индексом Солти шдех, значит, поль-_ 
зователь щелкнул на столбце, по которому и ранее проводилось упорядочива- 
ние. В этом случае требуется изменить направление упорядочивания, для чего 
изменяется значение свойства Таг: оно вычитается из 1, так что 0 заменяется 
на 1, а 1 на 0. Если же щелчок произведен на новом столбце, то его индекс за- 
поминается в переменной Соитит4ех. Затем вызывается описанная ранее 
‘функция ТВВерог СПеК, обеспечивающая отображения с новым вариантом 
упорядочивания. 

Функция ГКогтф®Во\м является обработчиком события ОпЗВо\ формы. 
В нем в качестве начального значения 011 задается корневой каталог того дис- 
ка, с которого запущена программа. Этот каталог вырезается функцией 
ЕхфгасЕЦе)муе из полного имени исполняемого приложения. Затем следует 
вызов функции Ещт@. 

Последняя функция ТВТоо1$СПеК является обработчиком щелчка на 
кнопке, обеспечивающей отображение вспомогательной формы Роги, в кото- 
рой пользователь задает условия отбора файлов. После закрытия этой формы 
вызывается функция Е1т@, обеспечивающая учет новых условий отбора. 

Нам осталось рассмотреть только функции вспомогательной формы. Но 
они предельно просты: 
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У01А __Еаз©са11 ТГогм2::СВ$12еС11ск(ТОБ)]есЕ *5епаег) 
| | 


// управление доступностью СотроВох1 и $р1пЕа1Е1 


СотбоВох1->Епар1еЯ = !СВ$1хе->Слескеа; 
С5р1пЕЯ1$1->Епар1еЧ = !СВ$12е->Сцескеа; 

| 
Нана ---------- 


У01А __ЕазЕса11 ТКГогм2::ВСрафаС11ск (ТОБ]есЕ *5епаек) 
{ . 


// управление доступностью БаеТ1теР1скег1 и БаёеТ1теР1скех2 
РасеТт1теР1скКег1->Епаб1еа = (КСрафа->ТеепТпаех == 4); 
РасеТ1мерР1скег2->ЕпаЪ1еа РасеТт1меР1скКег]1 ->ЕпаБ1еа; 


} 


Эти функции просто управляют доступностью компонентов СошфоВох1, 
ЭршЕЗИ1, ОаёеТипеР1сКег1, ОаеТипеР1сКег2 при щелчках пользователя на 
компонентах СВ517е и ВСОаца. | 

Рассмотренный в данном разделе пример можно, конечно, усовершенство- 
вать. Вы можете добавить в него отображение типов файлов, ввести какие-то 
специфические для конкретной задачи условия отбора файлов и операций 
с ними. Словом, на мой взгляд, это неплохая основа для создания собственной 
программы отображения файлов и папок и работы с ними. 


|| 


6.7 Работа с файлами средствами АР! \Мпдо\м$ 
6.7.1 Описание функций 


Читателю, вероятно, хорошо известны широко используемые функции с03- 
дания, чтения, записи файлов, подробно рассмотренные, в частности, в книгах 
[1] и [2]. Поэтому, не останавливаясь на них, рассмотрим только функции рабо- 
ты с файлами, реализованные в АР1 \У/1т4оу’з. Эти функции используются срав- 
нительно редко, хотя они обладают очень неплохими возможностями. 

Функция СгеафеЕ Пе позволяет создать или открыть самые различные объ- 
екты: файлы, порты (см. разд. 2.5), диски, каталоги (только открыть) и др. 
Она возвращает дескриптор указанного объекта и определяет множество фла- 
гов, регулирующих доступ к нему. 

Функция объявлена в файле идпбазе.й следующим образом: 

НАМОТЕ Сгеа®еЕ11е (ГРСТЗТВ 1рг11еМаме, ОМОВР амрез1геЯАссез$$, 

РИОВКС ачбпахгеМоае, 
ГРЗЕСОВТТУ АТТВТВОТЕ$ 1рбесиг1уАеек1Биеез, 
РИОКО диСхеак1опо15Ех1Баетоп, 


РИОВР амЕ1аазАпаАеЕ1расез, 
НАМОЬЕ БТепр1акеЕ11е); 


Подробное описание функции СгезжфеЕПе см. в гл. 8. А в данном разделе 
рассмотрим только наиболее часто используемые значения ее многочисленных 
параметров. | 

Параметр 1рЕЦеМаште является указателем на полный путь с именем объ- 
екта: открываемого или создаваемого файла, порта и т.п. 

Параметр 9мОез1геЯЧАссе$$ определяет права доступа к объекту. Приложе- 
ние может получить доступ для чтения, доступ для записи, доступ для чтения 
и записи. Параметр может быть комбинацией следующих значений: 


0 Позволяет ‘определить атрибуты устройства, не открывая его. 


п -*— = —_—--- в | 


_ СЕМЕВТС_ ВЕАР. Определяет ‘доступ для чтения и перемещения курсора. 


< 


440 Глава 6. Работа с дисками, файлами и каталогами 


Например, комбинация СЕМЕВ]1С_КВЕАШ | СЕМЕВ1С_\МЕТЕ определяет 
доступ для чтения и записи. 

Параметр Чи5ВагеМоде определяет совместный доступ к объекту, т.е. мож- 
но ли читать и писать в него одновременно нескольким приложениям (напри- 
мер, по сети). Этот параметр может быть комбинацией следующих значений: 


И ——— ОНИ 


‘Совместный доступ невозможен. 


| ЕПЕ_ ЭНАВЕ_ РЕГЕТЕ ' Совместный доступ разрешает удалять файл (только 
‘для Ушаомз МТ). 


| 
р ЕПЕ_ _ЗНАВЕ_ ВЕАО. Совместный доступ для чтения. 


и Ооо 


ЕЩЕ ` ЗНАВЕ М ЕТЕ __ 1 ©0 Совместный доступ для записи. 


Например, комбинация ЕП.Е_$НАВЕ_ВЕАР | ЕПЕ_$НАВЕ_МЕТЕ 
обеспечивает другим приложениям доступ для чтения и записи. 

Параметр 1р%есогЦуА г ще$ является указателем на структуру ТЗеспи- 
г(уАНгш{е$, которая определяет, может ли дескриптор быть использован 
процессами-потомками. См. ее подробное описание в гл. 8. Если 1рЗесогЦуА{- 
$16 ще = МОШ,, дескриптор не может быть унаследован. 

Параметр 4мСгеаНоп 01$ гФиИоп определяет действие с файлом. Значе- 
ние этого параметра может принимать одно и следующих значений: 


СВЕАТЕ_ МЕ\. ' Создает новый файл. Ошибка, если указанный файл 


' 

| 

о __ дуже вуществует. 
Е СВЕАТЕ_ `АТМАУ$ ' Создает новый файл. Переписывает файл, если он | 
м _ уже существует. _ 


Е ИВ ИНО к 


 ОРЕМ_ ЕХАТХ С ‚Открывает файл. Функциональные сбои, если файл 
| ‚не существует. 


-— ОНИ ——-——< 


 ОРЕМ_ АЕМАУЗ ‚ Открывает файл, если он существует. Если файл не 
= И { существует, ‹ функция создает его. 


ТВОМСАТЕ _ ЕХт5ТИМ6 ‚Открывает существующий файл и устанавливает его 

"размер | равным нулю. Файл должен открываться, по 
| крайней мере, с доступом ЧЕМЕВС_МЕЫТЕ. Ошиб- 
| _| ка, если и файл. не существует. 


Рассмотрим часто встречающиеся комбинации флагов и реакцию системы 
на функцию СгежеЕПе с данными комбинациями флагов. Например, если 
включен флаг СКЕАТЕ_МЕ\У и флаги ЕШЕ_ЗНАКЕ_КЕАЬО, ЕЦПЕ_ЗНА- 
ВЕ \ЫМТЕ, СЕМЕЕТС_КВЕАО и СЕМЕВ1С_\УЕЩТЕ при условии что файла не 
существует, система выдаст код ошибки 0, что свидетельствует об успешном 
завершении операции. При тех же условиях, если файл уже существует, то 
система выдаст код ошибки 80, что соответствует сообщению системы “` Файл 
существует ”. Если включен флаг ОРЕМ_АТГМАУ$ и включены те же флаги 
ЕПЕ_ $НАВЕ_ ВЕАО,ЕП.Е_5НАКЕ_\МЕТТЕ, СЕМЕВТС_ВЕАШ и СЕМЕ- 
В!С_\ЩТЕ, то если файла не существует, он создастся и откроется. А если 
файл существует, то он откроется, но почему-то выдастся ошибка номер 183, 
что соответствует сообщению “Невозможно создать файл, так как он уже су- 
ществует”. Странно, но факт. Причем работать с файлом после этого можно. 
При установленном флаге ОРЕМ_ЕХТЗТИМС если файл существует, то он от- 
крывается, а если нет, то выдается ошибка номер 2 и сообщение "Не удается 
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найти указанный файл”. С остальными параметрами и различными комбина- 
циями параметров вы можете сами поэкспериментировать с помощью рассмот- 
ренного далее приложения А_РИез. 

Продолжим описание параметров функции СгежеЕ!е. 

Параметр Ом 1а55Ап1А г, ще$ — определяет атрибуты и флаги файла. 
Можно использовать эти атрибуты в любых сочетаниях, но все их перекрывает 
атрибут ЕП.Е_АТТЕТВОТЕ_ МОВКМАТГ. В асинхронных режимах чтения и за- 
писи в устройства используется также флаг ЕП.Е_ЕГАС_ОУЕКГАРРЕО. Ос- 
тальные флаги посмотрите в описании функции СгезфеЕПе в гл. 8. 

Параметр ВТешр1а{еЕ Пе определяет дескриптор с доступом @ЕМЕЕ1С_ ВЕ- 
АО к шаблону файла и задает шаблону атрибуты созданного файла. Для 
У/1т4о\з 95 этот флаг должен быть равен МОТ... Если вы все-таки зададите его, 
то Се Та$Еггог возвратит значение, равное ЕККОК_МОТ_ЗОРРОВТЕО. 


Функция Сгезж4еЕПе при успешном выполнении возвращает дескриптор 
устройства (файла). Если при вызове функции происходят какие-либо ошиб- 
ки, их код можно определить с помощью функции @ае Таз Еггог. 

Ниже приведен пример оператора создающего файл с именем “Му.%х%" 
в папке "с:\фтр” с доступом к нему для совместного чтения и записи: 

НАМОТЕ Н = СгеафеЕ11е ("с:\\6пр\\Му.Ехе", 

СЕМЕВТС ВБЕАР | СЕМЕВТС МВТТЕ, 
ЕТЬЕ ЗНАВЕ ВЕАР|ЕТТЕ ЗНАВЕ ИВТТЕ, О0, 


СВЕАТЕ _АТГМАУЗ, ЕТТЕ АТТВТВОТЕ МОВМАЬ, 
МОЬЬ); 


Предполагается, что каталог уже существует. Если он отсутствует, то вызов 
функции завершится неудачей. 


`°Для закрытия дескринтора файла, полученного функцией Сгеафе Пе, ис- 
пользуется функция С]1о5еНап Ме: 


ВООГЬ С1озеНапа1е (НАМРОЬЕ ВОБ)ес+) 


В У1194ожз МТ вы можете использовать функцию СгезфеЕ !е для открытия 
дисковода. Функция возвращает указатель на дисковые устройства. Указатель 
может использоваться с функцией Оеу1се!ОСоп4{го] и должны быть выполне- 
ны некоторые требования, которые подробно рассмотрены в разд. 6.1.2. 

Функция СгезжеЕ Пе не может создать папку. Для создания папки надо вы- 
звать функцию СгежеП/!гесфогу или СгежеП!гесфогуЕх. В У/шдомз МТ вы мо- 
жете получить дескриптор к папке, задав в параметре Ом 1а=5АпЧДА вгЮщ\е$ 
флаг ЕП.Е_ЕГАС_ВАСКОР_5ЗЕМАМТТС$. Дескриптор папки можно пере- 
дать некоторым функциям \!1т32 вместо дескриптора файла. 


Мы научились создавать и открывать файл. Теперь рассмотрим функции 
чтения и записи. Они объявлены в файле илпфазе.й следующим образом: 


ВООГ ВеааЕ11е (НАМРЬЕ ВБЕ11е, ГРУОТО 1рВаЕЕег, 
РИОКР пМатрегоЕВусезТоВеаа, 
.РОМОВО 1рМ№ипоегоЕВусезВеаа, 
ГРОУЕВКТАРРЕР 1рОуег1арреа); 


ВООГ Иг1ееЕ11е (НАМОЬЕ №Е11е, ГРСУОТО ]рВаЕЕек, 
РИОКР пМматрегоОЕВуеезТоЙйг1ее, 
ГРОИОВКР 1рМ№ипрегоЕВуеИгтЕЕсеп, 
ТРОУЕВГАРРЕО 1рОуег1арред); 


Чтение и запись начинаются с текущей позиции файла. После операции 
чтения или записи текущая позиция файла сдвигается на число записанных 
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или прочитанных байтов. Правда, это произойдет, только если файл был от- 
крыт функцией СгезжеЕ!е без флага ЕШЕ_ЕГАС_ОУЕВГАРРЕО, т.е. был от- 
крыт в синхронном режиме. При асинхронном режиме изменение позиции 
файла надо производить программно. Подробнее о синхронном и асинхронном 
режимах работы см. далее. 

Параметр ВЕШе — это дескриптор файла, полученный функцией Сгеафе- 
ЕПе. При этом файл должен открываться функцией СгеаёеЕЦе, по крайней 
мере, с параметром 4мОезге4Асеез$ равным СЕМЕВ1С_КЕАО или СЕМЕ- 
НС_\ЕАКГТЕ соответственно. 

Параметр 1рВийЙЁег является указателем на буфер, в который будет читать- 
ся информация из файла или из которого она будет записываться в файл. 

Параметр пМишЬегО{Вуе$ТоКВеа4 указывает число байтов, которые тре- 
буется считать из файла. Это число не должно превышать размер буфера. Па- 
раметр пМитЬегО{ВУе$То\УгЦце указывает, какое число байтов требуется за- 
писать в файл. 

Параметры 1рМашБегО{Вуёе5Кеа4 и 1рМишфегО{Вуе; УгШеп являются 
указателями на переменные, в которые при синхронном чтении и записи вер- 
нется число действительно прочитанных или записанных байтов. 

Параметр 1рОуе]арре# — является указателем на структуру типа 
ОУЕВГАРРЕО. Но прежде, чем говорить о ней, надо рассмотреть два различ- 
ных режима чтения и записи — синхронный и асинхронный. 


Синхронные операции осуществляются, если при открытии файла или 
устройства функцией СгезфеЕЦе не был задан флаг ЕПЕ_ЕТАС_ОУЕВГАР- 
РЕ. При синхронном чтении и записи функции ВеадЕПе и \УгиеЕШе возвра- 
щаются только после окончания операции чтения или записи. На время вы- 
полнения операции приложение «зависает”. По окончании операции осущест- 
вляется сдвиг позиции файла на число записанных или прочитанных байтов. 
В переменные, на которые указывают параметры 1рМипЪегО{ВуёеВеа4 
и рМишбегО Ве Уг1Щеп, возвращается число действительно прочитанных 
или записанных байтов. 

Параметр 1рОуег1арре4 при синхронных операциях может быть равным 
МОЕГ.. Тогда чтение и запись осуществляются, начиная с текущей позиции 
’файла. Текущую позицию файла при желании можно установить функцией 
ЗеЕПеРойцег ‚ объявленной в файле идтфазе.й следующем образом: 

ОИОКО 5ееЕ11еРо1пеех (НАМОТЕ №Е11е, ТГОМС 1Р156апсеТоМоуе, 


РЬОМС 1р015ЕапсеТоМоуеН1оп, 
РИОВР АмМоуеМмеепочд); 


Параметр ВЕПЦе — это дескриптор файла, в котором требуется проводить 
позиционирование. Параметр Шу апсеТоМоуе — число байт, на которое тре- 
буется переместить курсор. Положительная величина соответствует переме- 
щению вперед, к концу файла. Отрицательная величина означает перемеще- 
ние к началу файла. 

Максимальное 32-разрядное значение, которому может равняться ПУ$$ап- 
сеТоМоуе, составляет 232 — 2. Это соответствует размеру файла примерно 
в 4 гигабайта. Если ваш файл укладывается в этот размер, то параметр . 
1рР1$ $ апсеТоМоуеН1 В следует задать равным МОТ.Г.. Если же вы имеете дело 
с файлом большего размера, то можете задать параметр 1рПО1$апсеТоМо- 
уеН1оВ. Он указывает на старшее слово 64-разрядного числа, определяющего 
общее смещение. Таким образом, суммарный сдвиг будет определяться сово- 
купностью значений Шу$апсеТоМоуе и рО1$ф апсеТоМоуеН1е В. Тогда макси- 
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мально возможный сдвиг составит 264 — 2 байтов. Не знаю, как называется та- 

кое огромное число, но надеюсь, что вам его в любом случае хватит. 
Параметр Ч\иМоуеМеШо4 — указывает, относительно какой точки отсчета 

будет произведен сдвиг. Возможны следующие значения этого параметра: 


—_щ—__ ии: аи ат. лее 


ЕП.Е_ВЕСТМ сдвиг относительно начала файла __ о В. 
ЕП.Е_ _СОКВЕМТ 


о 


ЕПЕ_ЕМО 


сдвиг относительно текущей позиции в файле | 


а щ еее 


сдвиг относительно конца файла 


Функция возвращает младшее слово новой позиции в файле. Если вы за- 
давали параметр 1рО1фёфапсеТоМоуеН15В, то в переменную, на которую указы- 
вает этот параметр, заносится старшее слово новой позиции. Если при выпол- 
нении функции произошла ошибка, то возвращается значение ОхЕЕЕЕЕЕЕЕ. 
Тогда причину ошибки можно определить вызовом функции Се Га$&Еггог. 

Как уже был сказано, синхронное чтение и запись осуществляются, начи- 
ная с текущей позиции. Но это происходит только при значении параметра 
]рОуег1арре равном МОШМ.. Вы можете в параметре 1рОуег!арре@4 указать 
структуру рассмотренного далее типа ОУЕВГАРРЕЮ, и в ее полях задать по- 
зицию. Тогда вместо текущей позиции будет использовано смещение, задан- 


ное в ОУЕВГАРРЕО. 


Мы рассмотрели организацию синхронного режима записи и чтения. Асин- 
хронные операции осуществляются, если при открытии файла или устройства 
функцией СгежеЕШе был задан флаг ЕЦП.Е_ ЕГАС_ОУЕВТАРРЕР. Этот режим 
чаще используется при работе с портами (см. разд. 2.5.3), а не с файлами. 
В асинхронном режиме функции ВеааЕПе и У\УгцеЕЦе возвращаются, не ожи- 
дая завершения операции. Нриложение может продолжать выполняться, 
а чтение и запись осуществляются параллельно с работой приложения и сооб- 
щают о своем окончании оговоренным' событием. 

В асинхронном режиме параметр 1рОуег]1арре4 не может быть равным 
МОЁ и должен указать структуру типа ОУЕВГАРРЕО или ТОуеарреч. 
Этот тип объявлен в файле шутфазе.й следующим образом: 

фуреаеЕ зегисеЕ _ОУЕВЬАРРЕО { 

ОТОМС_РТВ Тпбегпа1; 
ОТОМС_РТВ Тпбегпа1Н191; 
аптоп { 

ЗЕхасЕ { 


ПИОВКО ОЕЕзеЕ; 
РМОКР ОЕЕ5ееН1ап; 
}; 
РУОТО Ро1пфек; 
}; 
НАМРЬЕ БЕхепЕ; 
} ОУЕВЬГАРРЕО, *ГРОУЕВГАРРЕО; 


суреаеЕ _ОУЕВТАРРЕО ТОуег1арреа; 
суреаеЕ _ОУЕВТАРРЕР *РОуег]1арреа; 


Поля Пщцегпа1 и Пуцегпа 158 зарезервированы под использование опера- 
ционной системой. | 

Поле ОЁ5е{ указывает позицию файла (точнее, ее младшее слово), начи- 
ная с которой должно происходить чтение или запись. Поле ОЁ5е Н1еВ указы- 
вает старшее слово позиции. Позиция задает число байтов от начала файла. 
Поля ОЁ5е и ОЁЙ5ейН1еВ (может равняться нулю) должны быть заданы до вы- 
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зова функций чтения и записи ВеааЕПе и УгцеЕПе. При чтении из порта 
поля ОЁ5её и ОЁ5е Н1е\№ игнорируются. 

Поле ВЕуеп{ задает дескриптор объекта события (см. разд. 3.5), который бу- 
дет установлен в сигнальное состояние при завершении операции чтения или 
записи. Это поле должно быть задано до вызова функций чтения или записи. 

Впрочем, информацию о завершении операции чтения или записи можно 
получить и не через событие, а периодическим опросом макросом НазОуеар- 
ред4ТоСошр]ееа: 


ВООГ НазОуег1арреЯТоСотр1ефеа (ЪРОУЕВЪАРРЕОР 1рОуег1арреа); 


Параметр 1рОуетарре4 указывает на структуру типа ОУЕВГАРРЕЮ, ис- 
пользованную в операции. Макрос возвращает фгие, если операция завершена. 
Более подробную информацию о состоянии асинхронной операции можно 
получить функцией де Оуегарред Вези (Ц: 
ВООЪ бееОуег1арреЯаяВези1* (ТМ НАМОЬЕ РЕ11е, 
ТМ ГРОУЕВТАРРЕОР 1рОуег1арреа, 


ОЧТ ГРОМОВР 1рМ№итрегоОЕВуеез$ТгапзЕеггеа, 
ТМ ВООЪ БМа1); 


Параметр ВЕШе — дескриптор устройства или файла, параметр 1рОуе1ар- 
ре — адрес структуры типа ТОуеарре4. Параметр 1рМишБегО{ВУе$Тгапз- 
Гегге4 указывает переменную, в которой отображается число записанных или 
прочитанных байтов. Параметр Б\/ай указывает, должна ли функция ждать 
окончания операции чтения или записи. Если задать значение этого парамет- 
ра равным фге, то функция будет ждать окончания соответствующей опера- 
ции, и, следовательно, будет реализован практически синхронный режим. 
А если задать БУМ ай = Ёа1$е, функция немедленно вернет управление. Если 
возвращенное функцией значение равно %&гие, значит соответствующая опера- 
ция записи или чтения завершилась. В этом случае 1рМишегОЁГВУ е$ Тгапз- 
Гегге4 укажет число переданных байтов. Если возвращенное значение равно 
Г{а]5е, значит операция не завершена или получилась ошибка в вызове функ- 
ции Се Оуег]арре4Везий. Различить эти два варианта можно функцией 
Се Газ Еггог. Если она вернет ЕВКОВ_ТО_ТМСОМРГЕТЕ, значит все нор- 
мально, но операция не завершилась. В противном случае — ошибка в вызове 
функции СбеЮОуеарредВезо. 

Выше было рассмотрено асинхронное чтение и запись с помощью функций 
ВеадЕПе и УгцеЕ!е. Имеются также функции ВеадЕПеЕх и УтцеЕ!еЕх, 
специально предназначенные для асинхронного чтения и записи. Их описание 
дается в гл. 8. 

Прервать выполнение асинхронной операции можно функцией СапсеПО: 


ВООГ ИМТМАРТ Сапсе1То (ТМ НАМОЪЕ ВЕ11е); 


Функция прерывает все незавершенные операции чтения и записи файла 
или устройства с дескриптором ВЕШе. Прерываются только операции вызвавше- 
го потока. Операции в других потоках нормально продолжают выполняться. 
| Функция возвращает ненулевое значение, если все операции успешно пре- 

рваны. В противном случае возвращается нуль. Тогда причину ошибки можно 
определить функцией Се Газ Еггог. | 

Завершая рассмотрение записи и чтения, следует отметить еще одну функ- 
цию, использующуюся при записи — Е ЕПеВойЁеге: 


ВОО Е1азрЕ11еВоЕЕетз$ (НАМОГЕ ВЕ1]1е); 
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Она очищает буферы, связанные с данным файлом, и заносит данные из 
них в файл. Дело в том, что запись данных в файл, если только в вызове функ- 
ции СгежеЕЦе не установлены флаги ЕШЕ_ЕГАС_МЕВТТЕ ТНВООСН 
и Е П.Е ЕГАС_МО_ВОЕЕЕВМС, не идет напрямую. Если бы результат каж- 
дого вызова функции УгцеЕЦе немедленно заносился в файл, это увеличива- 
ло бы затраты времени. Запись идет в некие внутренние буферы системы, рас- 
положенные в оперативной памяти. Данные из них переносятся в файл при за- 
полнении буфера, т.е. крупными пакетами. Они переносятся также из буфера 
в файл при вызове функций чтения или функции С]1озеНапе. Использование 
буферов обеспечивает относительно редкое обращение к файлу на диске, за 
счет чего экономится время выполнения. Вызов функции Еа$ВЕПеВоЁег$ 
принудительно синхронизирует содержимое, хранящееся в буфере, с содержи- 
мым файла на диске. При успешном выполнении функция возвращает ненуле- 
вое значение. 


6.7.2 Демонстрационный пример 


Рассмотрим чисто демонстрационное приложение, иллюстрирующее неко- 
торые аспекты работы с файлами, открываемыми функцией Сгезе Ше. Его 
можно найти на приложенном к книге диске в каталоге РИез под именем 
А_РЦез. Окно приложения представлено на рис. 6.11. Оно содержит окно ре- 
дактирования Файл (его имя в приведенном далее коде ЕЕЙе), в котором поль- 
зователь может указать имя файла и путь к нему. В выборе файла ему может 
помочь кнопка Найти (ВЕ1т@а), открывающая стандартный диалог задания фай- 
ла. Кнопка Открыть (ВОреп) открывает файл функцией Сгезж{еЕ Пе. Кнопка За- 
крыть закрывает его функцией СюозеНапШе. Кнопка Удалить (ВО@аее) удаляет 
функцией ВеаееЕПе файл, имя которого записано в окне ЕЕ Пе. 


Рис 6 11 : Работа с файлами ^_ а | 
Текст 
Приложение, иллюстрирующее работу и ИЕ 


с файлами, открываемыми функцией 


Сгеа{еЕ йе Открыт ь | Зак рыть | УЧдаяить | Запись | 


‚ ФиСеабоп0чифивоп ^^^. О адзАпдАЦИЬ ще: - 
°С СВЕАТЕ_МЕМ 7 РЫЕ _АТТВИВОТЕ_МОЯМАЕ 
СВЕАТЕ АНМАУЯ Г` РЕЕ _РАб_МНТЕ_ТНАОЦЧЕН 
ОРЕМ_ ЕТИМ _ Г АЕ ААВ_ОМЕВГАРРЕО 
‚ Г ЕНЕ_РТАб_МО_ВОЕРЕВИМ6 
‚С ОРЕМ АЕМАУЗ ; Г АЕ ААб_ВАМООМ_АССЕ$5 
__ © ТАММСАТЕ Е ИЫ6 ‚С Г- РЫЕ ЛАб_ЗЕЯФЕМПАЕ_5САМ 


Г АЕЕ_РАб_РЕТЕТЕ_ОМ_С10$Е 
‚ Г Р\Е_РТАб_ВАСКУР_5ЕМАМТИС$ 
_Г РЕ _ААб_РОУХ. ЗЕМАМТС$ 


-- ао езнеЧАссезз 
го 


№ СЕМЕНЮС_ВЕАС 
Потокоя | 


м СЕМЕВС_МВИТЕ 
НИ __ - {2 -Не цдается найти указанный файл -= 
0 - Операция успешно завершена 
: ‘дыбьшеМове ` `` ``: Ю- Операция успешное завершена 
‚ Г АЩЕ $НАВЕ_ФОЕБЕТЕ  Пекст для теста 
‚ [5- Отказано в достчпе 
: У ЕНЕ_$НАВЕ_ЯЕАО — |0. Операция успешно завершена 
; | - Операция успешно завершена 


‚© РИЕ_$НАВЕ МАТЕ : К В 


При открытии файла используются задаваемые пользователем параметры 
функции СгежеЕ Пе: амСгеаНоп 015 (гФийоп, 4мЕ1а55АпдАИхгще$, 9м)ез1- 
ге4Ассе5$, 4мЭВагеМоде. Параметр амСгеайоп 15 "ФиНоп задается группой 
радиокнопок а\/СгеанопО5ниноп (ВСамСгеайоп 1 гБиНоп). Параметр 
ЧуЕ1а75АпПЧА г ще$ определяется совокупностью индикаторов, помещен- 
ных на групповой панели Оу/НадзАпаАниощез. Имена этих индикаторов в по- 
следующем коде от СВОмЕ1а5$АпаАНгЬще$ 1 до СВОмЕ1а5АпЧА гие $9. 


446 Глава 6. Работа с дисками, файлами и каталогами 


Параметр 4\ШОезтге4Ассе$$ определяется совокупностью индикаторов, поме- 
щенных на групповой панели 4\/ОезиедАссез$. Имена этих индикаторов в по- 
следующем коде от СВамО)ез1ге4Ассез$1 до СВамОезге4Ассе$$3. Параметр 
Ч\у5ВагеМо4е определяется совокупностью индикаторов, помещенных на 
групповой панели Ч\/бйагеМосае. Имена этих индикаторов в последующем коде 
от СВдмиЗВагеМо4е1 до СВ4\ЗВагеМодез. 

Окно редактирования Текст (ЕТехё) в правом вернем углу формы позволяет 
занести текст, который далее при щелчке на кнопке Запись (ВУтЦе) будет за- 
писан в файл. Щелчок на кнопке Чтение (ВВеа4) позволяет прочитать текст из 
файла. Этот текст будет занесен в окно Протокол (Мето1), расположенное 
в нижнем правом углу формы. В это же окно заносятся результаты выполне- 
ния каждой команды: число, возвращаемое функцией Че Газ Еггог, и его рас- 
шифровка, возвращаемая функцией Зу5ЕггогМеззасе (см. разд. 1.1). 


Ниже приведен код данного предложения. 


НАМОЪЬЕ Н = МОБЬ; 
1пЕ егг; 


У014 __Еаз®са11 ТЕогт1:; :ВОрепС11ск (ТОБ)]есе *бепаек) 
{ 
РИОВР АмПез1геаАссезз = 0; 
ОМОВР ЯмблагеМмоае = 0; , 
ОМОВО амСгеа1оп)1$Еу1раЕтоп = 0; 
РИОВКОР аАмЕ1ачзАпаА Е г1Юоеез$ = 0; 
1Е (СВамре$1гхеадАссе$ $2->СфескКеа) 
Ямрез1геаАссез5 |= СЕМЕВКТС_ВЕАПВ; 
1Е (СВамрез1геаАссе $ 3->СтескКеа) 
ирез1гедАссез$$ |= СЕМЕВТС МВТТЕ; 


1Е (СВам5рагеМмоае1->Спескеа) ам5пагеМмоае |= ЕТЪЕ_ЗНАВЕ РЕТЕТЕ; 
1Е (СВаи5рагеМмоае2?->СЛесКкеа) Чм5рагеМоае |= ЕТЬЕ 5НАКЕ КЕАПО; 
1Е (СВам5рагеМмоае3 ->Спескеа) ам5пагеМоае |= ЕТЬЕ 5НАВЕ ИВТТЕ; 


1: (СВОиЕ] аазАпаАЕ Е х1рисе$1->Срескеа) 


ЯмЕ1ачзАпадАЕ Е г1риеез |= ЕТЬЕ АТТВТВУТЕ МОВМАГ; 
1Е (СВОиуЕ1 аз АпаАЕ г1рафез2->Срескеа) 
ЧиР1ачзАпаАЕеЕ1рифез |= ЕТГЕ РЪАС МВТТЕ_ТНВООСН; 
1Е (СВОмЕ1ачзАпаАЕЕ г1Бафез3->Свескеа) 
ЧмЕ] аазАпЧАЕЕг1БиЕез$ |= ЕТЬЕ РЬАС ОУЕВЪАРРЕО; 
12 (СВБиг]1 аа АпаАЕ Е х1Юисе54->Спескея) 
амЕР1ачзАпЧАЕех1риеез |= ЕТЬЕ ЕЪАС МО ВОЕРЕЕВТМС; 
1Е (СВОмЕ1ачзАпаАЕ Е х1роез5->СпескКеа) 
ЧиуЕ1ачзАпадАе® г1равез |= ЕТЬЕ ЕТАС ВАМРОМ АССЕЗ55; 
1Е (СВОЬиЕ1ач 5 АпаАЕ  г1Боабез6->СпескКеа) 
Чи] асзАпаА& Е глроаеез |= ЕТЬЕ ЕЪТАС ЗЕООЧЕМТТАЬ $САМ; 
1Е (СВОмЕ1аазАпЧАЕЕг1ракез7->СЬескеа) — 
ЯмЕ]ачзАпадАЕЕгаруеез |= ЕТЬЕ ЕТАС РЕТЕТЕ_ ОМ_СЪО$Е; 
1Е (СВОмЕ1ачзАпаАЕ Е г1рафез8->Срескеа) 
ЧиЕ1ачзАпЧАЕЕг1рифез$ |= ЕТЬЕ ЕЪАС ВАСКОР_ ЗЕМАМТТС$; 
1Е (СВРиЕГ1 аа АпаА ( х1риа$ез9->Свескеа) 
ЯиЕ1ачзАпаАСЕк1роеез |= ЕТЬЕ _РЪАС РОЗТХ ЗЕМАМТТС$; 


<м1Еср (ЕКСамСгеае1опр1 $ Е х1БиаЕ1оп->ТЕешТпаех) 


сазе 0: АмСгеа*1о0оп01 5 Е г1БаЕ1оп 
Бгеак; 

сазе 1: АмСгеак1оптр1 $ г1БаЕ1оп 
Ьгеак; 


СКЕАТЕ. МЕИ; 


СВЕАТЕ_ АГМАУЗ; 
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сазе 2: ЧмСгеа®*1опр15Ег1Юие1оп = ОРЕМ_ ЕХТЗТТМС; 
ргеак; 

сазе 3: АмСгеа®*1о0опр15&г1Бие1оп = ОРЕМ_АТМАУЗ; 
ргеак; | 

сазе 4: АмСгеа®1опр15&г1лрие1оп 


} 


ТКОМСАТЕ _ЕХТЗТТМС; 


1Е(! Н) С1озеНапа1е(Н); 

бееГазЕЕгкохг (0); 

Н = СгеакеЕ11е (ЕЁ11е->Техе.с з6г(), АмПез1гедАссезз, 
ЧибПагеМо4е, 0, амСгеа*1оп015Егхлрае1оп, 
ЧмЕ]1ачзАпчА Е гтрифез, МО); 

егг = Сеефаз®Егкгохг (); 

Апз15Ег1па ВаЕЕ =бузЕггогМеззасде (егг); 

Мето1->11пез->АЧа (Апз156г1п9 (егг) + " - " +Апз156Ег1па (ВаЕЕ)); 


01а __Еаз®са11 ТГогм1 : :ВС1озеС11сКк (ТОр]есЕ *5епаег) 

{ 

ЗесГазЕЕггокх (0); 

1Е(! С1озеНапа1е(Н)); 

{ 

егг = Сеераз&Еггох (); 

Ап$156г1па ВаЕЕ =бузЕггогМеззасще (егг); 

Мепо1->11пе5->Ааа (Апз15Ег1па (егг) + " - " +Апз1беЕглра (ВаЕЕ)); 

Н =М0ЬГ; | | 


01а _ Еаз6са11 ТЕКогт1: : КогмС1озе (ТОБ)есе *5епаек, 
ТС1озеАсе1оп &АсЕ1оп) 


\01А __Еаз®са11 ТРГогм1: : ВИг1$еС11ск (ТОр)есф *5епаег) 

{ 

РИОВО Т; 

беегазеЕгкохг (0); , 

Иг1$сег11е(Н, ЕТехе->Техе.с _з6г(), 255, &Т,МОГЬ); 

егг = СесразеЕгкгохг (); 

Ап$156г1лпа ВаЕЕ =бузЕггогМеззаде (егг);. 

Мепо1->1пез->Ааа (Апз15г1па (егг) + " -‘" +Апз15Ег1па (ВаЕЕ)); 


\01Аа _ Еаз®са11 ТГоги1:; :ВВеаЯС11ск (ТОБ]есЕ *5епаег) 
{ 
РИОВО Т; 
сраг $[255]; 
Ап515Ег1па ВаЕЕ; 
бееГазЕЕггог (0); 
бееЕ11еРо1пеек(Н, 0, МОЬ, ЕТЬЕ ВЕСТМ); 
ао | 
{ 
ЗееГазЕггог (0); 
ВеааЕ11е(Н, &5,255,&тТ, МОБ); 
тЕ(Т >О0) 
{ 
Мепо1->11пез->Ааа (5); 
ег = Сера ЕЕггог (); 
ВаЕЁЕ =бузЕггогМеззаце (егг); 
Мето1->Ь1пез->Ааа (Апз15Ег1па (еху) + "-" + 
Апз15Ег1 па (ВаЕЕ)); | 
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} 


} 
мВ11е (Т> 0); 


\У01А _ Еаз6са11 ТГогм1 : : Вре1ебеС11ск (ТОБ]есе *5епаег) 
{ 

ЗесГазЕгкохк (0); 

Ре1екеЕ1 1е (ЕЁГ11е->Тех®); 


егхгх = СесЬазЕЕггох (}; 

Апз156к1тпа ВиЕЕ =бузЕгкогМеззасде (егг); 

Мемо1->11пез->Ааа (Апз156г1па (егг} + " - " +Ап$15Ег1па (ВиЕЕ)); 
} 

Инн ------- 


01а _ Еазеса11 ТЕогм1 : : ВЕ1паС11ск (ТОБ]есе *5епаег) 


{ 
1Е (Орепр1а10о91->Ехесиее ()) 
ЕЕР1]е->Техе = Орепр1а1о9ч1->Е11еМапе; 
} 


В приведенном коде вводится глобальная переменная Н — дескриптор 
файла, и переменная егг — номер ошибки, возвращаемой функцией Се Т.а$$- 
Еггог. 

Функция ВОрепСНсК является обработчиком щелчка на кнопке Открыть. 
Ее первые операторы формируют в локальных переменных 4мОезге4Ассез$, 
4\5ПВагеМоде, 4мСгеайоп 15 Би Ноп и 4иЕ1а5АпЧДАЙгЮще$ значения па- 
раметров функции СгежеЕ Пе, которые будут использованы далее при откры- 
тии файла. Параметры формируются, исходя из индикаторов и радиокнопок, 
включенных пользователем. Затем проверяется значение переменной Н. Если 
оно не равно нулю, значит, приложение работает в данный момент с каким-то 
другим файлом. Тогда прежний дескриптор закрывается функцией С1озе- 
Нап е. После этого вызывается функция Зе Газ Еггог, очищающая значение 
ошибки, заданное какими-то предыдущими операциями. Это всегда полезно 
делать, если в дальнейшем планируется вызывать функцию Се Га$Еггог для 
очередной операции. После всех этих подготовительных операций вызывается 
функция Сгеж4е Пе, и в переменную Н записывается дескриптор файла. Затем 
с помощью функции @еТа$ Еггог определяется код ошибки, с помощью 
функции 5у5ЕггогМе5захе находится соответствующее ему сообщение, и все 
это заносится в окно протокола Мето1. 

Функция ВАюозеСИсК является обработчиком щелчка на кнопке Закрыть. 
Она закрывает дескриптор файла функцией С1о5еНапе и заносит в протокол 
так же, как в описанный выше функции, код ошибки. Функция Еогт(]озе яв- 
ляется обработчиком события ОпС]1озе формы. В этом обработчике закрывает- 
ся дескриптор файла, если он не был закрыт ранее пользователем, щелкнув- 
шим на кнопке Закрыть. 

Функция В\УгцеСЦеК является обработчиком щелчка на кнопке Запись. 
В этой функции текст, занесенный пользователем в окно ЕТехф, записывается 
в файл, начиная с текущей позиции. Функция ВВеааСПсК является обработ- 
чиком щелчка на кнопке Чтение. В ней вызовом функции Зе Е ПеРойцег кур- 
сор устанавливается на начало файла. Затем в цикле функцией Веа4ЕПе чита- 
ется информация и заносится в окно Мето1. При этом контролируется число 
прочитанных символов, заносимое в переменную Т. Цикл заканчивается, ко- 
гда после чтения очередной порции данных Т = 0, т.е. достигнут конец файла. 

Функция ВРаееСПесК является обработчиком щелчка на кнопке Удалить. 
В ней функцией ВеееЕШе удаляется файл, имя которого записано в окне 
ЕЕПе. При этом дескриптор файла не используется. Функция ВЕШаСЦсК яв- 
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ляется обработчиком щелчка на кнопке Найти и позволяет пользователю 
в обычном диалоге ОрепП1а10о51 найти требуемый ему файл. Полное имя най- 
денного файла заносится в окно ЕЕ Пе. , 

Опробуйте это приложение при различных сочетаниях флагов. При этом 
полезно запустить средствами У! то\з пару экземпляров приложения, чтобы 
исследовать совместный доступ к файлу нескольких процессов. Протокол по- 
зволит вам определить коды ошибок, которые могут возникать в различных 
ситуациях. В ряде случаев вы с удивлением сможете обнаружить, что успеш- 
ное выполнение операции не всегда приводит к нулевому коду ошибки. Не со- 
всем понятно, зачем это сделано, но это уже вопрос к творцам У!14о\з — 
к М1сгозо{Ё 4. 


6.7.3 Игра «Морской бой» — организация 
совместного доступа к файлу 


Скорее всего, каждый человек в свой жизни играл в эту замечательную 
игру, расчерчивал на уроке математики вместо декартовых координат 2 поля 
1Ох 10, расставлял на своем поле 10 кораблей, и слышал от друга «ранил», 
«убил», «мимо». Давайте теперь попробуем создать программу, с помощью ко- 
торой мы сможем продолжать эту игру, но на компьютере и по сети. Коротко 
напомню сначала основные правила игры. 

Играют два соперника. Перед каждым игроком два поля 10 х 10 — свое, 
и партнера. На своем поле игрок должен разместить четыре 1-клеточных ко- 
рабля, три 2-клеточных, два 3-клеточных и один 4-клеточный. Корабли не 
должны соприкасаться друг с другом. Далее первый игрок делает на поле про- 
тивника свой ход — указывает клетку. Если удар попал в корабль, противник 
говорит «ранен», если корабль еще не уничтожен, или «убил», если уже все 
клетки корабля подверглись ударам. В обоих случаях удачливый игрок делает 
еще один ход. Если же сделанный ход не накрывает ни один корабль, против- 
ник говорит «мимо», и ход переходит к нему. Игра заканчивается, когда один 
из игроков убил все корабли противника. 

При любом взаимодействии нескольких приложений надо, прежде всего, 
разработать протокол, с помощью которого приложения будут обмениваться 
информацией. Но для этого сначала надо четко представить себе все ситуации, 
которые могут возникнуть в игре. В данном примере мы будем предполагать, 
что обмен информацией производится регулярным опросом файла, общего для 
двух экземпляров приложения. По-видимому, в каждом экземпляре приложе- 
ния могут наступать следующие события, реакция на которые должна преду- 
сматривать следующие операции: 


С . 


обытие _| Операции 


| 
Расстановка на своем поле По окончании проверить, имеется ли файл, че- | 
кораблей рез который по договоренности производится 
обмен информацией (в начале работы приложе- 
‘ния этот файл уничтожается). Если файла нет, | 
значит игрок успел расставить корабли раньше 
противника и имеет право первого хода. Тогда 
надо начать опрос файла, чтобы установить, что | 
противник тоже готов к игре. Если же файл 
уже есть, значит первый ход за противником. 
Надо известить его, что можно начинать игру, 


_| и ждать сообщения о его ходе. 


ИВ ИИ 
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Событие Операции 


Получение сообщения о том, | Предложить игроку сделать ход. Когда он сде- 
что противник завершил рас- | лан, отметить его на поле противника и послать 
становку своих кораблей в файл. Ждать ответа противника. ` 


Получение сообщения «ра- Отметить ранение на поле противника. Предло- 

нил» в ответ на свой ход жить игроку делать очередной ход. Когда он _ 
сделан, отметить его на поле противника и по- 
слать в файл. Ждать ответа противника. 


Получение сообщения «убил» | Отметить убитый корабль на поле противника. 
в ответ на свой ход Если все корабли убиты, поздравить игрока 
с победой. Иначе предложить игроку делать 
очередной ход. Когда он сделан, отметить его на 
поле противника и послать в файл. Ждать от- 
вета противника. | 


Получение сообщения Известить игрока, что будет ход противника, 
«мимо» в ответ на свой ход |и ждать сообщения о его ходе. 


Получение сообщения о ходе |Проанализировать ход. Если попадание в ко- 

противника рабль, то отметить это на своем поле, послать 
сообщение «ранил» или «убил». Если все кораб- 
ли убиты, сообщить игроку о поражении. Ина- 
че, ждать сообщения о следующем ходе против- 
ника. Если попадания нет, послать сообщение 
«мимо», отметить ход на своем поле. Предло- 
жить игроку делать очередной ход. Когда он 
сделан, отметить его на поле противника и по- 
слать в файл. Ждать ответа противника. 


Таким образом, получается 5 сообщений: о начале игры, «ранил», «убил», 
«мимо», получение. координат хода. В проведенном анализе мы не предусмот- 
рели еще вызов противника на поединок — извещение всех потенциальных 
игроков, что кто-то хочет сразиться. Но не будем усложнять себе жизнь, и по- 
считаем, что о начале игры противники договариваются устно или с помощью 
рассмотренных в последующих главах средств коммуникации в сети. Точно 
так же будем считать, что они заранее договариваются о полном имени файла, 
с помощью которого они будут общаться. 

Теперь можно приступить к разработке протокола, алгоритма работы 
и принципов кодировки. Файл, через который осуществляется обмен инфор- 
мацией, может содержать 3 числа: код, извещающий о событии, и два числа, 
обозначающие координаты сделанного хода. Давайте договоримся о следую- 
щем наборе кодов: 


Коды игрока 1 | Коды игрока 2 | Значение кода _ 
0 Сообщение о готовности к началу игры. 


Сообщение о сделанном ходе. 


Сообщение «мимо» в ответ на сделанный ход. 


Сообщение «ранил» в ответ на сделанный ход. 


Сообщение «убил» в ответ на сделанный ход. 


Такой набор, в котором одноименные коды различаются на постоянное 
число 10, удобны для организации программы. Например, в приложение мож- 
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но ввести переменную р1ауег, обозначающую игрока, и в одном экземпляре 
приложения задать ей значение 0 — первый игрок, а в другом экземпляре при- 
ложения задать 10 — второй игрок. Тогда при отправке сообщения код можно 
формировать из значений от 0 до 4 (первый столбец таблицы), прибавляя 
к ним переменную р1ауег. В результате от первого игрока пойдут коды от 0 до 
4, аот второго — от 10 до 14. Принимая сообщение, к принятому коду можно 
тоже добавлять рауег. Тогда результирующие коды, принятые от противни- 
ка, всегда будут иметь значения от 10 до 14 (второй столбец таблицы). И далее 
эти коды можно анализировать, не задумываясь о том, какой из игроков рабо- 
тает с данным экземпляром приложения. Подробнее это будет рассмотрено 
при обсуждении кода данного приложения. Там на конкретных примерах бу- 
дет показано, как работает такой протокол. 

Из проведенного анализа взаимодействия приложений следует, что прило- 
жение может находиться в одном из трех состояний: расстановка кораблей 
в начале игры — назовем его $1р$, ожидание ответа — ма\, ввод очередного 
хода — тоуе. Эти состояния различаются действиями приложения и игрока: 


Состояние ; Действия 


$01р5 ‘Расстановка игроком кораблей на своем поле. Поле противника не- 
‚доступно. В конце расстановки определение номера игрока (по 
‘тому, кто быстрее расставил), создание или открытие файла, по- 

‚ сылка сообщения о готовности к игре. Переход в состояние май. 
`Начало периодического опроса файла. 


ма Периодический опрос файла. Недоступны оба поля — свое и против- 
ника. После получения сообщения анализ его. При коде (с учетом 
| номера игрока) равном 10 — переход в режим тоуе для ввода оче- 
‚ редного кода. При кодах 12, 13, 14 (ответ на предшествующий ход 
' игрока) — отметка результатов попадания или промаха на поле про- 
‘тивника. При попадании (13, 14) переход в режим тоуе для ввода 
‹ очередного хода. При промахе (12) продолжение режима май. При 
‘коде 11 (ход противника) анализ попадания или промаха. Посылка 
сообщения о результатах анализа. Отметка результата на своем 
поле. При промахе противника переход в режим тоуе для ввода 

‚ очередного хода. При попадании продолжение режима май. 


| - 

Прекращение опроса файла. Ввод пользователем нового хода на 
‘поле противника. Свое поле недоступно. После ввода посылка сооб- 
| щения и переход в режим ма. 


Приведенная таблица фактически является схемой алгоритма. Остается 
продумать кодировку, обеспечивающую хранение, анализ и отображение ин- 
формации о кораблях и ходах своих и противника. Будем хранить в приложе- 
нии две матрицы, отображающие свое поле и поле противника. На своем поле 
пользователь в начале игры расставляет корабли, а в процессе игры на нем 
отображаются результаты ходов противника. Так что каждый элемент может 
быть или пустым, или соответствовать промаху противника, или быть заня- 
тым кораблем, в который противник еще не попал, или быть занятым кораб- 
лем, в который противник уже попал. На поле противника корабли размеще- 
ны в неизвестных местах. Так что там каждый элемент может быть или неиз- 
вестным, или соответствовать сделанному промаху, или быть занятым кораб- 
лем, в который игрок уже попал. 

В соответствии с этим примем следующую кодировку ячеек полей (элемен- 
тов матриц): 
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Код | Пояснение _ ООО ООО 
ЕЕ - 


устая ячеика на своем поле или неизвестная ячейка на поле противника. 


| —_ 
ЫУ———— о УИ 

—2. | Пустая ячейка с отметкой об ударе противника на своем поле или от- 

| ‚ метка о промахе на поле противника. | 

— И рУр————РЫбФ тт 

—3 Ячейка корабля, пораженная попаданием, на своем поле или поле про- | 

тивника. | 


—-—— 
—4 Последняя ячейка корабля, пораженная попаданием, на своем поле или 
поле противника. Наличие индикации подобной ячейки позволяет легко | 


“що А. В а в о я ан: д а ее ен еее ое д ен. | 
| 
| 
| 


отличить раненый корабль от уничтоженного. 


,-> Только на свс НГО = 


0—9 Только на своем поле — ячейка, занятая кораблем и и не пораженная по- 
| ‚ паданием. Код обозначает номер корабля. 


Номера кораблей — это их индекс в одномерном массиве, содержащем 
число клеточек в каждом корабле. Этот массив может иметь вид: 


В этом случае предполагается четыре 1-клеточных корабля с индексами от 
О до 3, три 2-клеточных корабля с индексами от 4 до 6, два 3-клеточных кораб- 
ля с индексами 1 и 8, один 4-клеточный корабль с индексом 9. 
_ Например, матрица своего поля в некоторый момент может иметь следую- 
щий вид: 


Такая матрица означает, что, например, в ячейках А5-АЗ размещен 
4-клеточный корабль с индексом 9. В ячейках Г2-Н2 размещен 3-клеточный 
корабль с индексом Т, но его средняя ячейка С2 уже поражена выстрелом про- 
тивника (код —3). В ячейки 41 и Е4 тоже были произведены выстрелы против- 
ника (коды —2), но они не попали в цель. 


Я остановился столь подробно на описании протокола обмена, алгоритма 
и кодировки, чтобы на этом примере показать обычную цепь рассуждений, ко- 
торая должна предшествовать разработке сколько-нибудь сложного приложе- 
ния. А теперь можно перейти к описанию самого приложения. Вы можете най- 
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ти его в каталоге беаУ’аг в проекте беа\аг на приложенном к книге диске. 
На рис. 6.12 приложение показано во время выполнения. 


Рис. 6.12 ‚7 Морской бой, обмен информацией через 4 ая о т 


Приложение Состояние [Все корабли расставлены. Нажмите кнопку Готов кире" = 
«Морской бой» | 
в режиме ввода 
кораблей (а) 

и в разгар игры (6) 


Все корабли расставлены 


Отменить корабль 


Очистить все поле 


‚7 Морской бой, обмен информацией через 


Состояние [Противник ранил. Ход противника 


В момент запуска приложения перед пользователем открывается. стан- 
дартное окно диалога выбора файла, в котором пользователь должен указать 
заранее согласованное с партнером полное имя файла. Указанный файл снача- 
ла может отсутствовать в выбранном каталоге. Он будет создан далее автома- 
тически. 

После выбора файла открывается главное окно программы. На нем распо- 
ложены 2 одинаковых по своим свойствам компонента типа Згте@а: 
$#120г191 — свое поле, на котором расположены ваши корабли, (слева 
на рис. 6.12) и 54т1щтеСг192 — поле противника (справа на рис. 6.12 6). Но сна- 
чала поле противника загорожено панелью Рапе1 с тремя кнопками, которую 
вы можете видеть на рис. 6.12 а. Дело в том, что прежде, чем начинать игру, 
пользователь должен расставить корабли на своем поле. И при этом поле про- 
тивника может его только мешать. 

В процессе ввода кораблей в верхней части окна в компоненте Е91\1 ото- 
бражается, сколько кораблей данного типа требуется разместить. Например, 
в начале расстановки в нем будет отображаться сообщение "Введите 4 1-кле- 
точных корабля”. Соответственно в метке ГаБе!1, расположенной на панели, 
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отображается число расставленных кораблей данного типа. Например, для на- 
чального состояния будет показано сообщение “Введено 1-клеточных кораб- 
лей 0”. Далее щелчками мыши в поле $4гштеСт191 и следуя указаниям из вы- 
шеприведенных окон, вы расставляете корабли. Корабли не могут быть раз- 
рывным, поставленными не по прямой и соприкасающимися друг с другом. 
Эти условия проверяются в коде, но об этом несколько позже. В случае, если 
будут попытки поставить корабль в уже занятую ячейку, пользователю высве- 
тится сообщение: “Вы ошиблись, поле не свободно". Аналогично, если вы по- 
пытаетесь поставить корабли рядом или не по одной прямой, то высветятся со- 
общения: "Вы ошиблись и контактируете с другим кораблем" или “Вы ошиб- 
лись, клеточки корабля должны стоять рядом”. 

Если вам не нравится, как вы расставили корабли, то в любой момент вы 
можете очистить все поле целиком кнопкой Очистить все поле (ее имя ВЩеаг). 
Вы можете также удалить корабль, который начали размещать, кнопкой От- 
менить корабль (ВЕгее Вр). После расстановки кораблей, вы нажимаете кноп- 
ку Готов к игре (ВОК), и панель Рапе!1 исчезает. Если вы успели расставить 
свои корабли раньше соперника, в верхней части экрана в ЕЧЯИ1 высветится 
‚сообщение: “Ватт ход будет первым, но противник еще не готов”. В этом слу- 
чае вы ждете пока противник расставит свои корабли. Как только он расста- 
вит, вы увидите сообщение: "Теперь Ваш ход”. После этого можете наносить 
удары по кораблям противника. 

Обмен между приложениями организован по выше оговоренному прото- 
колу. Вы щелкаете мышкой на клеточке поля противника, и если у противни- 
ка там корабль, то эта клетка подсвечивается ярко-красным цветом, и вы по- 
лучаете сообщение в окне ЕЧЁ1: “Вы ранили. Опять Ваш ход”. Если вы добили 
корабль, то последняя его клетка подсвечивается темно красным цветом. Если 
вы промахнулись — то клетка помечается “крестиком”, и вы получаете сооб- 
щение, что ход перешел к противнику. Пока противник делает свои ходы, они 
отмечаются на вашем поле. Как только противник промахнется, ход опять пе- 
рейдет к вам. 

Теперь несколько слов о компонентах и их настройках. В Эи`те(т1а1 
и 54гщ2Сг192 свойство ВеЁаи {Югамт? задано равным #а15е. Это сделано по- 
тому, что мы хотим окрашивать клетки различными цветами в зависимости от 
их типа. Подобная заказная прорисовка ячеек возможна в обработчике собы- 
тий ОпОгамСей|, которые возникают только при Оеёаи ЮОгамто = Ёа[5е. 

Панель Рапе!1 в начале выполнения приложения должна закрывать ком- 
понент 5%4г11#Ст192. Поэтому она расположена поверх 53#т#0г142 и имеет тот 
же размер. В дальнейшем программно она делается невидимой, и становится 
виден компонент 5$г112Сг142, расположенный под панелью. Кнопка Готов к иг- 
ре (ВОК), расположенная на панели Рапе]!1, в первый момент недоступна 
(Епа]е@ = Ра]5е), чтобы пользователь не мог ее нажать, пока не расставил все 
корабли. 

Для задания интервалов времени, через которые производится опрос фай- 
ла, в приложение введен таймер Типег1. Его свойство Пщфегуа1 = 1000 — сра- 
батывание раз в секунду. Свойство Епае4 таймера равно #а15е, так как снача- 
ла он не должен работать. Он будет включаться программно в те моменты вре- 
мени, когда надо будет получать ответ от приложения противника. 

Для вызова диалога выбора файла используется компонент ОрепП1а]1051 
с фильтром, предусматривающим отбор файлов .{хф и всех файлов, и расшире- 
нием по умолчанию %$х& (свойство Рай ЦЕх®). 
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Ниже приведен код этого приложения. 


сопзЕ №=10; // размер поля 
сопзЕ К=10; // число кораблей 
1106 пк К]={1, 1, 1, 1, 2, 2, 2, 3, 3, 4}; // массив кораблей 
епим {$61рз, ма1е, моуе} моае; // состояния приложения 
ВуЕе р1ауег;// номер игрока: 0 - первый, 10 - второй 
Вубе пк=0; // число введенных кораблей, и убитых противником 
Вубе пк2=0; // число убитых кораблей противника 
Вуфе 1,7; // индексы, используемые при вводе кораблей 
НАМОГЕ Н; // дескриптор файла 
‘’Боо1 Е1кзЕРо1пе;// вводится ли первая, или последующие клеточки 


\уо1А 5епа (Вуфе соае, Вуке х, Вуее у) 

{ 
// отправка сообщения 
ОМОВКО Еепр; 
ЗеЕеЕ11еРо1пЕет (Н, 0, МОЦИ, ЕТЬЕ ВЕСТМ); 
Мт1$сеЕ11е(Н, &соае, 1, &Еетшр, МОТ); 
Иг1ЕеЕ11е(Н, &х, 1, &бетр, МОГ); 
Иг1$еЕ11е(Н, &у, 1, &бетр, МОЪГ); 
Е] а$рР11еВаЕЕехтз (Н); | 


у014 __Еаз®са11 ТГогм1 : :Гогибпом (ТОБ]есе *5епаег) 
{ 

// задание файла 

Орепр1а1о031->ЕГ11еМатме = "беа.®хё"; 

Орепр1а1091->1п1{1а101г = Ехегас&Е11еРафй (Арр11са*1оп->ЕхеМаме); 

Орепр1а1о91->Т1%1е = 

"Укажите согласованный вами с соперником файл"; 

Орепр1а1о31->Ехесиее (); 

// удаление файла 

Ре1ефеЕ11е (Орепр1а1031->Е11еМапе); 

// задание размеров полей 

5Ег1паСгЕ1а1->Со1Сойп® = 

ЗЕг1паСсг1А2->Со1СоипЕ = 

5Ег1п9СгЕ1а1->ВомСоцпе 

5Ех109бЕ1а2->ВомСочп® = 

//очистка полей 

Бог (1=1; 1 <= М; 1++) 

{ 
5Ег1п49СгЕ191->Се11$ [1 
56х11п96Е1а1->Се113[ 
56:11096Е1а2->Се11$ [1 
5г1196х142->Се11$ | 
Еог (1106 )=1; ) <= М; 
{ 


<. . чо 


ко НН 
< 


| 
у 
+++ + 


= (сБаг) ((апз1апеЯ сваг)'А'! + 1 -1); 
1; 

(сраг) ((ипз1апеЯ сраг)'А' +1 -1); 
= 1; 


еее 

+ --о=- о 

+ еее 
| 


5Ег1п9СгЕ1а1->Се11$[1] [75] = "-1"; 
5$Ег11п9Сбг1а2->Се11$[1] [53] = "-1"; 
} | ’ 
} 
ЗЕг1паСг1а1->Се11$[0] [0] = ""; 
5&:11п9Сг1а2->Се11$[0] [0] = ""; 


1 =) =0; 
Еа11->ТехЕ = "Введите " + ТоЕТо$к (5 - шк 7 1]) +" "+ 
ТгеТозек (мк [1]).+ "-клеточных корабля"; 
Табе11->Саре1оп = "Введено " + ТпЕТобЕк (шк[1]) + 
"-клеточных кораблей 0"; 
Е1х5ЕРо1пЕ = 6гие; 
поае = $01рз; 
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Уу014 _ ЕазЕса11 ТКогп1: : 56 г1п96бг1915е1есеСе11 (ТОБ)есе *5епаек, 


{ 


106 АСо1, 116 АВом, Боо1 &Сапзе1ес®) 


// выделение клетки в $Ег1п9Сг1а1 - ввод корабля 
12 (поае == з51рз) //если заполнение поля кораблями 
{ 

1Е (5Ег1п096г1а1->Се11$ [АСо1] [АКом] != "-1") 


{ 


ЗПомМеззаае ("Вы ошиблись, поле не свободно"); 
гебигп; 


} 


1Е(((АСо1 > 1) && (5Е:1096:1а1->Се11$ [АСо1-1] [АВом] = "-]и) 
&& (56г1п9Сг1а1->Се11$[АСо1-1] [АВом] != ТрЕТобек (1))) | 
((АСо1 < 10) && (5Ег140а6г191->Се11$[АСо1+1] [АВом] != "-1") 
&& (56 г1п9Сг1а1->Се11$ [АСо1+1] [АВом] != ТпЕТобех (1))) | 
((АВом > 1) && (56г1п9Сбг1а1->Се11$[АСо1] [АВом-1] 1!= "-1") 
&& (5Ег1п9СгЕ1а1->Се11$ [АСо1] [АВом-1] != ТоЕТо5Зекг (1))) 
((АВБом < 10) && (5Ег1паСг1а1->Се11$[АСо1] [АКом+1] != "-1") 
&& (ЗЕ г1п9СЕ1а1->Се11.-$ [АСо1] [АВом+1] != ТроЕТо3Зек (1))) 


((АСо1 > 1) _&& (АКом > 1) && .. 
(ЗЕг1п9Сг1а1->Се11$ [АСо1-1] [АКом-1] ! 


— "-1")) 
((АСо1Т < 10) && (АВом > 1) && 
(3Ег1п9Сг1а1->Се11$ [АСо1+1] [АВом-1] != "-1")) 
((АСо1 > 1) && (АВом < 9) && 
(ЗЕг1п9Сх191->Се11$ [АСо1-1] [АВои+1] != "-1")) 
((АСо1 < 10) && (АВом < 9) &&. 
(ЗЕг1паСг1491->Се11$ [АСо1+1] [АВом+1] != "-1"))) 


{ 


ЗПомМеззаае ("Вы ошиблись и контактируете с другим кораблем 
гебагп; : 
} 
1Е (Е1узЕРо1пь) 
ЕГ1узеРо1пЕ = Еа]1зе; 
е1зе 
1Е(! (((АСо1 > 1) && (56 х1п9Сг1а1->Се11$ [АСо1-1] [АВом] == 
ТпЕТобекг (1))) || | 
((АСо1 < 10): && (5Е:11п9Сг1а1->Се11$ [АСо1+1] [АВом] == 
ТпеТобек (1))) || о 
((АВом > 1) && (5Ег1п9СгЕ1а1->Се11$ [АСо1] [АВКом-1] == 
ТпЕТобех (1))) || | 
((АВом < 10) && (5Ег1паСбг1а1->Се11$ [АСо1] [АВом+1] == 
ТпЕТобеЕх (1))))) 
{ 


ЗпоиМеззаде ( 


"Вы ошиблись, клеточки корабля должны стоять рядом"); 


гебеацгп; 


} о 
5Ег1па9Сг191->Се11$ [АСо1] [АБКом] = 1; 


1Е() == пк] 1]) // корабль завершен 


1Е(1 < К) 

{ 

ЕЯ 1->ТехЕ = "Введите " + ТоЕТоЗЕк (5 - шк [Г 1]) +" "+ 
То Ток (шк[1]) + "-клеточных корабля"; 

1Е (шКк( 1] == пКк[1-1]) // корабль прежнего типа 


"); 
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Тафе11->СарЕ1оп = "Введено " + ТпЕТобег (шК[ 1]) + 
| "-клеточных кораблей " + ТпЕТобек (пК); 
е1 зе // корабль нового типа 
{ 

Таре11->Сар®1оп = "Введено " + ТпЕТобег (шкК[1]) + 

"-клеточных кораблей 0"; 

пк = 0; 

} 

Е1узСсРо1пЕ = Егце; 

} 

е15е 

{ , 
Таре11->Сар®1оп = "Все корабли расставлены"; 
Е91%1->ТехЕ = "Все ‘корабли расставлены." 


" Нажмите кнопку "Готов к игре!"; 
ВОК->ЕпаЪ1еа = $гие; 
}//конец е15е (1<К) 
} //конец ‘е]зе (корабль завершен) 
}//конец 1Е($61р5) 


у01а _ Раз®са11 ТЕогт1: :ВОКС11 ск (ТОБЗесе *5еп4ег) 
{ 
.// удаление панели 

Рапе11->\У1$11е = РГа15е; 

// определение номера игрока 

1Е (ЕРЕ11еЕх15%$ (Орепр1а10о91->Е11]1еМапе)) 

{ 


р1ауег = 10; 

Е91Е1->Тех$="Ход противника"; 

} 

е1 зе . 

{ `` 

р1ауег = 0; 
Еа11->Техф = "Ваш ход будет первым, но противник еще не готов"; 


} 

// создание дескриптора файла 

Н = СгеафеЕ11е (Орепр1а1091->Е11еМмаме.с_з6г(), 
СЕМЕВТС ВЕАР | СЕМЕКТС ИВТТЕ, 
ЕТТЕ_ЗНАВЕ_ВЕАР | ЕТЬЕ ЗНАВЕ МВТТЕ, 
МОЪЬ, ОРЕМ АЬМАУЗ$, ЕТГЬЕ АТТЕТВУОТЕ МОВМАТ, №11); 

// начальное послание 

бепа (р1ауег, О, 0); 

пк = пКк2 = 0; 

поае = ма1*; 

Т1мехг1->Епар1еа = +гае; 


\01А _ Газ®са11 ТГогм1: :Т1мег1Т1тег (ТОБ]есе *5епаег) 
{ 
// опрос файла 
РМОВКО фепр; 
Вуфе соае, х, у; 
10 9; 
зееЕ1 1еРо1псек (Н,0, МОТТ, ЕТЬЕ ВЕСТМ); 
ВеааЕ11е(Н, &соае, 1, &Еетр, МОТ); 
КеааЕ11е(Н, &х, 1, &кетр, МО); 
ВеааЕ11е(Н, &у, 1, &Еетр, МОЪЬ); 
соае += р1ауег; 
$м1 ср (соае) 
{ 


сазе 10: // противник готов к игрё 


458 | Глава 6. Работа с дисками, файлами и каталогами 


Т1иег1->ЕпаЪ1еа = ЕЁа15$е; 
поае = поуе; 
Еа1*1->Тех+*="Теперь Ваш ход"; 
Бгеак; | 
сазе 11: // пришло сообщение о ходе противника 
ЗЧ = 5Ег1пабг1а1->Се11$[х] [у] .Тотпё(); 
1Е(У >= 0)//какой-то корабль 
| 
5Ег1п96г1а1->Се11$[х] [у] = "-3"; 
шк [9] --; | 
12 (пк[9] > 0) //ранил 
{ 
бепа (р1ауег + 3, х, У); 
Еа1*1->ТехЕ = "Противник ранил. Ход противника"; 
} // конец "ранил" 
е1зе //убил 
{ 


пк++; 
Зепа (р1ауег + 4, х, у); 
1Е (пк == К) // конец игры, проигрыш 


{ 
Т1мехг1->Епаб1еа = Ёа1зе; 
Еа1*1->Тех*="Конец игры. Увы, Вы проиграли."; 


ЗРомМеззасде ("Увы, Вы проиграли!!!"); 
. гесагп; 
} 
е15е 
{ 
Еа1$1->Техе = "Противник убил. Ход противника"; 
} 
} // конец "убил" 
} // конец попадания в корабль 


е1зе // мимо 


{ 
Т1пег1->Епаб]1еа = ЁЕа1$е; 
поае = поу\уе; 


5Е:11096Е191->Се11$[х] [у] = "-2"; 
бепа (р1ауег + 2, х, у); —- 
Еа1*1->Техе = "Противник промазал." 


"Теперь Ваш ход"; 


} 


Бгеак; 
сазе 12: // вы промахнулись 
ЕЗ11=->ТехЕ = "Вы промахнулись." 
" Теперь ход противника"; 
Бгеак; 
сазе 13: // вы ранили 


Т1пег1->Епаб1еа = Еа1$е; 

поае = моуе; 

Еа1*1->ТехЕ = "Вы ранили на " + 
5Ег11па6сгЕ1а2->Се11$[х] [0] + 
$ЕЕ1пабг1а2->Се11$[0] [у] + 
". Опять Ваш ход"; 

ЗЕг1паСсг1а2->Се11$[х] [у] = "-3"; 

‘ргеак; 
сазе 14: // вы убили 

Т1мех’1->Епар1еа = Ёа1зе; 

поае = моуе; 

пк2++; 

1Е(пк2 == К) // конец игры, выигрыш 

{ 

Еа1$<1->Техе="Конец игры. Вы выиграли."; 
ЗРомМеззаае ("Ура!!! Вы выиграли!!!"); 
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гебагп; 


} 
Еа11->Тех&="Вы убили. Опять Ваш ход"; 


5Ег1паСг1а2->Се11$[х] [у] = "-4"; 
Бгеак; 


Ууо1а _ Еаз®са11 ТГогим1:; : 56 х1п96г141ОгамСе11 (ТОр]есЕ *5епаег, 
106 АСо], 1пЕ АВКом, ТКес® &ВКесе, Тбсг1аргамзбафе 5кафе) 


{ 


// прорисовка клеток полей 


1Е ((АСо1 == 0) || (АВом == 0)) 
((ТЗЕг1паСсг1а *) бепаег)} ->Сапуаз->ВгизВ->Со1ог = с1В%пРасе; 
е1 зе 
зм1ЕСН (((Т5Ег1паСк1а *) бепаег) ->Се115[АСо1] [АВом] .Тотпь()) 


{ 
сазе -1: сазе -2: // пустая или удар мимо 
((ТЗЕхг1паСк1а *) бепаек) ->Сапуаз->ВгазВ->Со1ох = 
с1и\Р1е; 


Бгеак; 
сазе -3: // попадание в корабль 
((ТЗЕг1лпаСг1аА *) бепаег) ->Сапуаз->ВгизВ->Со1ог = 
с1Веа; 


Бгеак; 
сазе -4: // последнее попадание в корабль 
((ТЗЕг1паСг1а *) бепаег) ->Сапуаз->Вгаз->Со1ог = 
с1Магооп; 


Ьгеак; 
ЧеЁаз1+: // нетронутый корабль 
((ТЗЕг1паСг1а *) Зепаег) ->Сапуаз->Вгазв->Со]1ог = 
с1сгау; 


} 
((ТЗЕг1паСг1а *) бепаег) ->Сапуаз->Е111Вес® (Вес®); 


1Е ((АСо1 == 0) || (АВом == О0)) 
((ТЗЕг1паСг1а *) Зепаег) ->Сапуаз->ТехЕО<цЕ (Кесе.теЕЕ + 2, 
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ВКесе.Тор + 2, ( (ТЗ г1лпаСг1а *) бепаег) ->Се11$ [АСо1] [АВом]); 


е1зе 1Е ( ((Т5Ег1паСг1а *) Зепаег) ->Се11$ [АСо1] [АВом] == "-2") 
| ((Т5$Ег1паСг1а *) бепаег) ->Сапуаз->ТехеОц& (Весе.ЪеЕЕ + 2, 


Весе.Тор +2, "Х"); 


014 __Раз®са11 ТГоги]1 : :5$&г1п196Е1925е1ес®Се11 (ТОБ)ес& *5епаег, 
. 10$ АСо1,1п6 АКом, Боо1 &Сапбе1ес+) 


{ 


// выделение клетки в 5%г1п96х142 - задание хода 


1Е (поае == мохуе) 
{ 
1Е (5Ег1п96г1а2->Се11$[АСо1] [АКом] != -1) 
ЗпомМез$заае ("Вы ошиблись, поле не свободно"); 
е1 зе 
{ 
5ЗЕг1паСг1а2->Се11$ [АСо1] [АВом] = -2; 


Зепа (р1ауег + 1, АСо1, АВом); 
Т1иехг1->Епаю1еа = +гае; 
поае = ма1*; 
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у01А _ ЕазЕса11 ТРоги]1: :ВЕгее5й1рС11ск (ТОБ]ес® *5епаег) 
{ 
// удаление корабля 1 
ог (110е 11=1; 11 <= М; 11++) 
Гог (1пЕ 71=1; 71 <= М; 711++) 


1Е (56 х1п9Сбх1а1->Се11$[11] [71] == ТоЕТобек (1)) 
ЗЕг1паСсг191->Се11$[11] [51] = -1; 
= 9; 


‚ Е1ЕзеРо1пе = %гие; 


У01А _ Еазеса11 ТРГогм1 : :ВС1еагС11сК (ТОБ)ес® *Зепаег) 
{ . 

// очистка поля | 

Еох (1пЕ 11=1; 11 <= М; 11++) 
Бок (1пЕ 71=1; 791 <= №; 71++) 


5Ег1паСсг1а1->Се11$ [11] [51] = -1; 
=] = ПК = 0; | 
Еа161->ТехЕ = "Введите " + ТпЕТоЗЕк (5 - шк д 1]) +" "+ 
То Тобег (мк [1]) + "-клеточных корабля"; 
Тафе]11->Сар®1оп = "Введено " + ТпЕТобек (шКк[1]) + 


"-клеточных кораблей 0"; 
РЕ1езЕРо1пЕ = гие; 


} 


В начале приведенного кода объявлены глобальные константы и перемен- 
‚ные. Константы М и К задают соответственно размер поля и число кораблей. 
Стандартная игра проходит на поле размера 10 х 10 и предусматривает расста- 
новку десяти кораблей. Но при желании вы можете изменить это и задать дру- 
гие значения констант для нестандартной игры. Массив шК перечисляет число 
клеточек в каждом корабле. При желании вы можете изменить и этот стандарт. 

Переменная то4е перечислимого типа соответствует описанным ранее 
возможным состояниям приложения. Назначение остальных глобальных пе- 
ременных поясняется комментариями и будет более ясным при дальнейшем 
обсуждении кода. 

Функция Зеп4 записывает в файл, заданный своим дескриптором Н, чис- 
ла, переданные как параметры софе, х иу. Смысл этих чисел обсуждался ра- 
нее: код и координаты очередного хода. Сначала функцией Зе ЕПеРойфег 
курсор файла устанавливается в первую позицию. Затем вызовами функции 
У’гцеЕЦе в файл записывается три числа. В заключение функцией НазвЕШе- 
ВоЁег$ эти числа переносятся в файл на диске. 

Функция Еогт5Во\ является обработчиком события Оп5Во\ формы. Это 
событие происходит при открытии приложения в момент перед тем, как фор- 
ма станет видна. Первый оператор функции задает в диалог Ореп 0 1а10о51 имя 
файла по умолчанию: "Беа.{х%”. Второй оператор задает в качестве каталога по 
умолчанию каталог, из которого запущено приложение. Этот каталог извлека- 
ется функцией Ехёгас  ЕПеРа{ И из полного имени файла — свойства Арр|Пеа- 
ИЙоп->ЕхеМате. Третий оператор задает заголовок диалога: “Укажите согла- 
сованный вами с соперником файл”. Предполагается, что игроки заранее дого- 
ворились об имени и каталоге размещения файла, через который они будут об- 
мениваться информацией. Четвертый оператор вызывает диалог, в котором 
пользователь может изменить имя файла или согласиться с именем по умолча- 
нию. Следующий оператор удаляет этот файл функцией еее Пе. Сделано 
это для того, чтобы не получилось путаницы, если этим файлом пользовались 
в предыдущей игре. Если не удалить такой файл, то в дальнейшем приложе- 
ние может начать читать из него информацию, относящуюся к прошлой игре. 
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Файл опять будет создан, когда пользователь закончит расстановку своих ко- 
раблей. Впрочем, если противник расставил свои корабли раньше, чем данный 
экземпляр приложения был запущен, то файл будет создан приложением про- 
тивника и захвачен им. Тогда функция ЭееёеЕ Ще в данном экземпляре прило- 
жения не сможет удалить файл. И это хорошо, так как не погибнет начальная 
информация, записанная в файл противником. 

Следующие операторы настраивают компоненты игровых полей Эите- 
Сг191 и Эт 1а2. В соответствии с заданным размером полей М задается 
размер компонентов: М + 1 строк и столько же столбцов, учитывая один стол- 
бец и одну строку на заголовки. Затем во внутренние ячейки полей заносится 
текст "-1", а в первый столбец и первую строку заносятся соответственно циф- 
ры от 1 до 10 и буквы от “А” до”. | 

После этих предварительных настроек в окно ЕЯ выводится предложе- 
ние пользователю ввести соответствующее число кораблей (при значениях кон- 
стант, заложенных в приложении, это текст: “Введите 4 1-клеточных кораб- 
ля”). В метку ГаБе!1 на панели выводится сообщение, что пока введено 0 кораб- 
лей. Переменным Ти ] задается значение 0. Переменная 1 — это индекс вводимо- 
го корабля в массиве тК. А переменная 1 будет использоваться как счетчик чис- 
ла введенных пользователем ячеек данного корабля. Далее значение перемен- 
ной Е!’ Рош задается равным %гие, что свидетельствует о том, что будет вво- 
диться первая ячейка корабля. Эта переменная будет использована в описанной 
далее функции 5$й1п#От191$е]ес Се! при контроле неразрывности ячеек ко- 
рабля. Затем переменной тоде задается значение $В1р$. Это означает, что при- 
ложение перешло в режим размещения пользователем кораблей. 

При размещении пользователь щелкает на ячейке своего поля, которую он 
хочет добавить к очередному кораблю. При этом в компоненте ЗёгтеСта1 
возникает событие ОпЗеес& Се, которое обрабатывает функция Это т1а1- 
Зе@ес{Се|. Передаваемые в эту функцию параметры АСо]| и АКом — это ин- 
дексы столбца и строки ячейки, на которой щелкнул пользователь. Обработка 
щелчка начинается с проверки состояния приложения. Если состояние то4е 
не равно $В1р$, то никакая дальнейшая обработка не производится. Так что 
фактически поле 54гштеСт191 доступно пользователю только в процессе рас- 
становки кораблей. Далее проверяется, записано ли в ячейке значение -1. 
Если нет, значит ячейка не свободна. Об этом пользователю дается соответст- 
вующее предупреждение, и обработка прерывается. Затем проверяются все 
ячейки вокруг той, на которой щелкнул пользователь, исключая ячейки пер- 
вого столбца и первой строки. Содержимое всех окружающих ячеек должно 
равняться или -—1 (свободна), или 1 (ячейка того же корабля). Если встретилась 
ячейка с другим содержимым, значит ячейка, указанная пользователем, кон- 
тактирует с другим кораблем. Это не разрешается правилами. Так что в этом 
случае пользователю делается соответствующее замечание, и обработка ячей- 
ки завершается. Последняя проверка связана с требованием неразрывности 
последовательности ячеек, описывающих корабль. Если вводится первая 
ячейка корабля (Е1г$ Рошф = фгие), то проверка неразрывности не ведется, 
а значение Е1'5Ротё задается равным #а15е. В противном случае проверяются 
ячейки, лежащие слева, справа, сверху и снизу от ячейки, указанной пользо- 
вателем. Если ни в одной из них значение не равно 1, значит неразрывность не 
обеспечена, и пользователю выдается соответствующее замечание. 

Если ячейка, указанная пользователем, прошла все проверки, ее можно 
фиксировать как ячейку корабля. В строку этой ячейки заносится номер кораб- 
ля 1, а число введенных ячеек } увеличивается на 1. Потом проверяется, равня- 
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ется ли значение 1 величине тК[1| — числу клеток данного корабля. Если рав- 
няется, значит, ввод корабля закончен. Тогда увеличивается на 1 число введен- 
ных кораблей данного типа пК и индекс очередного корабля 1. Сбрасывается в 0 
число введенных клеток корабля }. Сравнением значений 1и К проверяется, все 
ли корабли введены. Если не все, то в окно ЕЯИ1 выводится сообщение: “"Введи- 
Те ... ...-клеточных кораблей”. Вместо второго многоточия подставляется значе- 
ние шк] — число клеток в корабле. А вместо первого многоточия подставляет- 
ся 5 минус число клеток в корабле. Следует отметить, что этот оператор пра- 
вильно сработает только для стандартной игры, в которой число кораблей каж- 
дого типа определяется такой формулой. Если вы надумаете обеспечить нестан- 
дартную игру, то это единственный оператор, который вам придется изменить. 
После выдачи сообщения о числе кораблей проверяется, равно ли число клеток 
нового корабля числу клеток предыдущего, иначе говоря — является ли новый 
корабль кораблем того же типа. Если является, то в метку Гафбе!1 выводится со- 
общение о том, сколько кораблей данного типа уже введено. Если же новый ко- 
рабль является кораблем нового типа, то в ту же метку выводится сообщение 
о том, что пока введено 0 кораблей этого типа, и переменной пК задается нуле- 
вое значение. Затем переменной Е1г$ Рош задается значение фгае, так как да- 
лее будет указываться первая клетка следующего корабля. Все эти сообщения, 
конечно, можно было бы убрать, упростив код. Но они здорово помогают поль- 
зователю ориентироваться в текущей ситуации при вводе кораблей. 

Если все корабли уже расставлены, пользователю выдается сообщение об 
этом. Кнопка ВОК ("Готов к игре”) делается доступной, и пользователю пред- 
лагается нажать эту кнопку, сообщая о том, что он готов начинать игру. 

Функция ВОКСПсК является обработчиком щелчка на кнопке Готов к игре. 
Первый оператор функции делает невидимой панель Рапе!1, и под ней стано- 
вится видимым поле противника. Затем проверяется, существует ли файл, 
указанный пользователем в момент открытия приложения. Напомню, что этот 
файл тогда же был удален. Так что если этот файл существует, значит, против- 
ник успел раньше расставить свои корабли и создать этот файл. Тогда правом 
первого хода обладает противник, и об этом заносится сообщение в окно ЕЧЦ1. 
Переменной р1ауег присваивается значение 10 — второй игрок (см. рассмот- 
ренные ранее соглашения о принимаемом протоколе). Если файл, через кото- 
рый происходит обмен информацией, отсутствует, значит, противник не успел 
еще расставить свои корабли, а может быть, даже еще и не начинал работать. 
В этом случае данный игрок обладает правом первого хода, но ему надо подож- 
дать, пока противник расставит свои корабли. В окно ЕЯЩ1 выдается сообще- 
ние об этом, а переменной рауег присваивается значение 0 — первый игрок. 

Затем функцией Сгеа&еЕПе файл открывается или создается, и его деск- 
риптор заносится в переменную Н. Файл открывается с атрибутами @ЕМЕ- 
ВТС_ВЕАРО и СЕМЕВТС_МЕТЕ, что означает его использование как для чте- 
ния, так и для записи. Флаги ЕП.Е_ЭНАВЕ_КЕАО и ЕПШЕ ЗНАКЕ_МЮМТЕ 
означают, что файл будет доступен для совместного чтения и совместной запи- 
си в него сообщений. Флаг ОРЕМ_АГМ\МАУТХ5 означает, что если файл не суще- 
ствует, то он будет создан, а если существует — будет просто открыт. 

Затем описанной ранее функцией Эепа в файл посылается сообщение о го- 
товности к игре. Обнуляются переменные пК и пК2, которые в дальнейшем бу- 
дут использоваться для подсчета числа кораблей, убитых противником 
и вами. Приложение переводится в состояние май — ожидание сообщения от 
противника. Запускается таймер Типег1, который будет каждую секунду оп- 
рашивать файл. _ 
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Функция Типег1Типег является обработчиком события таймера ОпТ!тег. 
В этой функции проводится чтение информации из файла и ее обработка. 
Функцией Зе ЕПеРопцег курсор файла устанавливается на первую позицию. 
Затем вызовами функции Веа4ЕПе читается код соде и координаты хода хиу. 
После этого к прочитанному коду добавляется значение переменной рауег. 
Ранее при обсуждении протокола уже было рассказано, что такой подход по- 
зволяет анализировать принятые коды одинаково для первого и второго игро- 
ка. Посмотрим это на примере. 

Путь с данным экземпляром приложения работает первый игрок, у кото- 
рого переменная рЙауег равна 0. Послав сообщение о своей готовности к игре, 
он записал в файл свое значение р!ауег — 0. У его противника значение р!ауег 
равно 10 и такое число он записал в файл, когда послал сообщение о своей го- 
товности к игре. Первый игрок прочитал это число, прибавил к нему нулевое 
значение рЙауег и получил 10 — код сообщения о готовности противника 
к игре. Теперь рассмотрим другой случай, когда с данным экземпляром прило- 
жения работает второй игрок, у которого переменная р1ауег равна 10. Тогда 
у его противника значение р]ауег равно 0 и такое число он записал в файл, ко- 
гда послал сообщение о своей готовности к игре. Второй игрок прочитал это 
число, прибавил к нему свое значение р1ауег и получил в результате 10 — код 
сообщения о готовности противника к игре. Таким образом, любой игрок, при- 
бавляя к коду значение рауег, получает числа от 10 до 14. Наличие любого 
другого числа говорит о том, что в файле лежит не ответ противника, а собст- 
венное предыдущее послание. 

Теперь рассмотрим анализ структурой змЦей полученного кода. Случай, 
когда со4е = 10, как мы только что рассмотрели, соответствует сообщению о го- 
‘товности противника к игре. Такое послание может получить только первый иг- 
рок. При получении такого сообщения игроку надо делать свой ход. В этом слу- 
чае таймер выключается, состояние приложения переводится в тоуе — воз- 
можность сделать ход, и пользователю выдается сообщение, что теперь его ход. 

Значение со4е = 11 соответствует сообщению о ходе противника. В пере- 
менную + заносится число, хранящееся в ячейке поля 5%гт8@(г1а1, которую 
указал противник. Если это не отрицательное число, значит, противник попал 
в какой-то корабль, точнее, в корабль с индексом +. В ячейку заносится число 
—3, свидетельствующее о попадании (см. рассмотренные ранее принципы ко- 
дировки). Число, лежащее в элементе массива шК, соответствующем кораблю 
у, уменьшается на 1. Напомню, что первоначально в элементах массива шК 
хранится число клеток в кораблях. Так что уменьшение этого числа при каж- 
дом попадании позволяет определить момент, когда корабль будет убит, т.е. 
все его клетки будут поражены. Оператор Ш проверяет, остались ли еще в ко- 
рабле непораженные клетки. Если остались, значит корабль только ранен. То- 
гда противнику посылается сообщение об этом (число 3 плюс значение рауег), 
а пользователю выдается сообщение о ранении. Приложение остается в состоя- 
нии ожидания ответа ма. Если проверка оператором ! установила, что в эле- 
менте шт] ;] не осталось непораженных клеток, значит, корабль уничтожен — 
убит. Тогда счетчик убитых кораблей пК увеличивается на 1. Противнику по- 
сылается сообщение о его удаче (число 4 плюс значение рауег). Сравнением 
пк и К проверяется, все ли корабли уничтожены. Если все, то таймер останав- 
ливается, пользователю выдается сообщение о проигрыше и игра завертается. 
Если же корабли еще остались, пользователю выдается сообщение об уничто- 
жении его корабля и приложение остается в режиме ожидания следующего со- 
общения противника. 
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Мы рассмотрели реакцию на удачный ход противника. Если же он про- 
махнулся, то таймер останавливается и приложение переводится в состояние 
тоуе, в котором пользователь может делать свой ход. В ячейку поля 
эише@г1а1 заносится —2, свидетельствуя о промахе противника. Посылается 
сообщение о промахе (число 2 плюс значение рауег). 

Остальные возможные значения со4е — это ответы на посланный против- 
нику код. Значение 12 извещает о промахе. В этом случае пользователю выдает- 
ся соответствующее сообщение, и приложение остается в режиме ожидания со- 
‚ общения о ходе противника. Значение со4е = 13 извещает о ранении корабля 
противника. Пользователю выдается соответствующее сообщение, таймер оста- 
навливается, состояние приложения переводится в шоуе — возможность сде- 
лать ход. В ячейку поля противника 5411#Сг1а2 заносится значение -3. Значе- 
ние соде = 14 извещает о гибели корабля противника. Таймер останавливается, 
состояние приложения переводится в тоуе — возможность сделать ход. Число 
уничтоженных кораблей пК2 увеличивается на 1. Проверяется, все ли корабли 
противника уничтожены. Если все, пользователю выдается поздравление с вы- 
игрышем, и игра завершается. Если же еще остались не уничтоженные корабли 
противника, пользователь извещается об уничтожении очередного корабля, а 
в ячейку поля противника 5%4г11#Сг142 заносится значение —4. 

Функция ЭгтеСг191ОгамСе! является совместным обработчиком собы- 
тий ОпОгау’Се| компонентов 5фг1т@а1 и 54гштеОг142. В этом обработчике 
производится нестандартная прорисовка ячеек. Передаваемые в функцию па- 
раметры АСо] и АВо\м определяют индексы ячейки, а параметр Вес& — это об- 
ласть канвы данной ячейки. Поскольку обработчик общий для обоих компо- 
нентов Э%ёгтеСг1Ч, то обращение к конкретному компоненту производится. 
с помощью конструкции ((ТЭигтеСга *)5еп4ег). Сначала в зависимости от 
характера ячейки производится задание цвета кисти канвы: ©1ВфтРасе для 
первого столбца и первой строки, МВ Це для пустой ячейки или ячейки, со- 
‚ ответствующей промаху, ©1Ве4 для ячейки раненого корабля и «1Магооп для 
ячейки, завершившей уничтожение корабля. Для остальных ячеек (а это не- 
тронутые ячейки кораблей) задается цвет @Сгау. 

После задания цветов методом ЕШВес+{ область ячейки закрашивается со- 
ответствующим цветом. Далее в ячейках первого столбца и первой строки ме- 
тодом Тех{Опф записывается текст, хранящийся в этих ячейках: цифры строк 
и буквы столбцов. А в ячейки, хранящие -—2 (удары, не попавшие в корабли), 
записывается символ “Х^” 

Функция 54гтеСг925@есСе! является обработчиком события ОпЗе- 
]ес{Се|, возникающего в компоненте 8#'т#Сг192 при щелчке пользователя. 
Такой щелчок допустим только в состоянии тоуе, когда пользователь делает 
свой ход. Поэтому прежде всего проверяется состояние приложения тофде. 
Если состояние равно тоуе, то проверяется, свободна ли ячейка. Если нет, 
пользователю выдается замечание и обработка события прекращается. Тем са- 
мым мы предотвращаем возможность ошибки пользователя — повторение уже 
сделанного хода. Если указана пустая ячейка, в нее заносится число —2, посы- 
лается сообщение о сделанном ходе (число 1 плюс значение рауег), запускает- 
ся таймер и задается режим ожидания май. 

Мы рассмотрели основные функции приложения. Остались обработчики 
ВЁЕгее рСПеК и ВЦЩеагСИеК событий, связанных со щелчками на кнопках 
Отменить корабль и Очистить все поле. В первом из них просматриваются все 
ячейки поля, и те, которые относятся к вводимому в данный момент кораблю 
с индексом 1, обозначаются как пустые — в них записывается значение —1. За- 
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тем число введенных клеток } задается равным 0, и задается Е1г5 Рот = фгое, 
т.е. подготавливается введение первой точки корабля. В обработчике ВЩеаг- 
СПскК все ячейки помечаются как пустые, обнуляется число введенных кораб- 
лей, и все подготавливается к новому вводу всех кораблей. 


6.8 Копирование, удаление, перемещение 
файлов средствами языка С++ 


Рассмотренные в этом разделе способы работы с файлами универсальны 
в том смысле, что могут использоваться в приложениях любых версий У/т- 
4о\з, в консольных приложениях, и даже в приложениях, созданных на 
УС-+-. Но по эффективности и сервису они, конечно, несопоставимы с возмож- 
ностями, рассмотренными в разд. 6.10. 

Удаление файла с диска осуществляется функцией О@аее Е 1е. Она опреде- 
лена следующим образом: 


Боо1 Бе1ефеЕ11е (сопз® буз®ем: :Ап$15&г1па Е11еМапе) 


Функция удаляет файл с именем ЕПеМате. Если удалить файл невозмож- 
но или указанного файла нет, функция возвращает #а[5е. 

Сочетание функции РеаееЕЙе с функциями поиска файлов (см. разд. 6.6) 
легко позволяет организовать удаление из заданного каталога всех файлов, 
удовлетворяющих некоторому шаблону: 


1пе Муре1ете (Апз15ег1па Тем1афе,Ап$156г1па &птр) 

{ 

ТбеагсИКес 585; 

106 1гез; 

СВО1т (Теп1аее); 

1гез = ЕлпаЕтг$$ ($пр, 0, 58); 

мр11]е (1хез == 0) 

{ 

Ре1ефсеЕ11е (5К.Мапме); 
1гез = ЕРЕтраМехЕ ($58); 


} 
Е1паС1озе ($58); 


} 
Например, вызов такой процедуры оператором 
Муре1еке ("С:\\Епр\\","*.6пр"); 


удалит из каталога с:\?тр\ все файлы с расширением „.{тр. Подобные процеду- 
ры широко используются при завершении приложения для зачистки мусо- 
ра — удаления с диска временных файлов. В разд. 6.6 приведена более слож- 
ная процедура, обеспечивающая удаление файлов, удовлетворяющих шабло- 
ну, не только из указанной папки, но и изо всех папок, вложенных в нее. 

Еще один вариант удаления файла возможен с помощью функции гетоуе, 
объявленной в файле 51аю.Й следующим образом 


10Е'’гемтоуе (сопзЕ сраг *Ё1]епапе) 


Ее использование и результат аналогичен функции РеаееЕ Пе. Возвращае- 
мые значения 0 или —1 (при ошибке). Например, ее вызов 


хетохе ("с:\\Етр\\6тр.кпр"); 


удалит из папки ТМР файл ипрАтр. 
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Удаление файла можно также провести с помощью функции _ ип ВК, объ- 
явленной в файле ГО.Й следующим образом 


116 _оп11пК(сопзе сраг *Е11]епапе) 


Две последние функции возвращают 0 в случае успешного завершения. 
При ошибке возвращается -1. Тогда причину ошибки можно узнать по значе- 
нию переменной еггпо: ЕАССЕЗ — не разрешен доступ к файлу для соверше- 
ния операции удаления, ЕМОЕМТ — файл с указанным путем и именем не 
найден. Таким образом, удаления файла с учетом возможных ошибок может 
быть оформлено следующим образом: 


Ап$156г1па Е11е; | 


1Е(! гемоуе (Е11е.с_56г()) == 0) 

1Е (егхгпо == ЕАССЕБ) 

‚ оромМез$засе ( 

"Не разрешен доступ к файлу для операции удаления"); 
е15е 1Ё (еггпо == ЕМОЕМТ) ЗВомМеззаде ("Файл не найден"); 


Удаление файлов рассмотренными функциями приводит к их полному 
удалению, а не к перемещению в корзину, из которой их потом можно восста- 
новить. Удаления файлов с переносом их в корзину рассмотрено в разд. 6.10. 

Копирование файлов средствами функций С/С++ может сводиться к соз- 
данию файла-приемника, после чего содержимое файла-источника читается 
по частям или целиком в некоторый буфер и записывается в файл-приемник. 
Следующая функция осуществляет подобный подход: 


Боо1 Сору(Апз15Еглпа Е11е1, Апз156г1па Е11е2, Роо1 Ре1) 
{ . 
сопзЕ $512е = 1000; 

ЕТЬЕ *Е1, *Е2; 

Бубе ВоЕ[$12е]; 

106 Вез, ТО; 

Ап$156г1па СигО1г, Р1г; 


// проверка корректности задания 
Егу 
{ 
1Е (ЕР11е1 == Е11е2) 
{ 
Арр11са®*1оп->МеззавевВох ( 
"Нельзя копировать файл сам в себя", 
"Копирование невозможно" ‚МВ_ТСОМЕХСТАМАТТОМ+МВ_ОК); 
гебагп Еа15зе; 


Арр11са&1оп->МеззадеВох ("Не задан файл - приемник", 
"Копирование невозможно", 
| МВ_ТСОМЕХСТАМАТТОМ + МВ_ОК); 
гесагп Еа15е; 
} . 
ТЕ (12Р11еЕх1$6$ (Е11е1)) 
{ 
Арр11са®1оп->МеззадеВох ("Не найден файл - источник", 
"Копирование невозможно", 
МВ _ТСОМЕХСТАМАТТОМ + МВ _ОК); 
гесигп Еа1$е; 
} . 
1Е (Р11еЕх15$$$ (Е11е2)) 
1Е (Арр11са®1оп->МеззааевВох ( 
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"Файл уже существует. Продолжать?", 
"Ответьте", МВ_ТСОМОЧЕЗТТОМ + МВ _УЕЗМО) 
| == ТОМО) 
{ 
Арр11са*1оп->МеззасдевВох ( 
"Копирование прервано, так как файл уже существует", 
"Ошибка копирования", МВ_ТСОМЕХСТАМАТТОМ + МВ ОК); 
гесигп Еа15е; 
} 
// создание копии „Бак 
е]1 зе 
{ 
// удаление прежней копии „Бак, если она существует 
1Е (Е11еЕх156$ (СБапаеЕ11еЕ хе (Е11е2, ".Бак"))) 
Ре1ефеЁ11е (СпапдеЕ11еЕ хе (Е11е2, ".Бак")); 
// создание новой копии 
ВепатмеЕ11е (Е11е2, СпапдеЕ11еЕхе (Р11е2, ".Бак")); 
Саяг)1х = СееСиггеп Е )1хт(); 
1х = Ехегас®Е11ер1к (Е11е2); 
1Е (Оле != "") 
` { 
— СВОЕ (Р1г); 
ТО = ТОВез$а1% (); 
СИО1г (Сигр1г); 
1Е (10 != 0) | 
1Е (Арр11са&1оп->МеззасвевВосх ( 
"Заданная для копирования папка отсутствует. Создать?", 
"Ответьте на вопрос", МВ_УЕЗМО + МВ_ТСОМОЧЕЗТТОМ) 
== ТРУЕб) 
МКО1 г (21); 
е1 зе 
{ 
Арр11са*1оп->МеззасдевВох ( 
"Копирование прервано, так как папка отсутствует", 
"Ошибка копирования", МВ_ТСОМЕХСТАМАТТОМ + МВ_ОК); 
гесоигп Еа15е; 
} 
} 
САО1г (Сагр1 т); 
ЕКоги1->Сагзог = сгНойгС1аз$$; 
Е1 = Еореп( Е11е1.с з%г(),"кр"); 
‚ Е2 = Еореп( Е11е2.с з%г(),"мЬ"); 
мр11е (! ЕеоЕ(Е1)) 
{ 
Кез = Егеаа (&5ВоЁ, $17е,1,Е1); 
1Е (Емг1 фе (&ВаЕЁ, $17е,1,Е2) < Веб) 
{ 
Арр11саЕ1оп->МеззадеВох ("Ошибка записи", | 
"Копирование прервано", МВ _ТСОМЕВКОВ + МВ ОК); 
Еоги1->Сагзог = сгреЕац1*; 
гебагп Еа15$е; 
} 
} 
Ес10о5еа11 (); 


// удаление файла-источника 
1Е (0е1) 
’ 1Е ( !Бе1еъкеЕ11е (Е11е1)) 
{ 
Арр11сае1оп->МеззачевВсх ( 
"Файл-источник удалить невозможно", 
"Ошибка удаления", МВ _ТСОМЕХСТАМАТТОМ + МВ ОК); 
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геогр ГЕа15е; 


} 


Роги1->Сигзог = сгреЁао1*; 
теситп Егае; 


} 
саесрВ (ЕТптОчЕЕггог & Е) 


{ 
1Е (Е.ЕхгогСоае == 5} 


{ 
Арр11са%*1оп->МеззасдеВох ("Ошибка доступа к файлам", 
"Ошибка копирования", 
МВ_ТСОМЕХСТАМАТТОМ + МВ_ОК); 
Гоги1->Сигзог = сгр)еЁЕао1%; 
гебсогп Еа1$е; 


} 


е1зе 
{ 
Арр11са*1оп->МеззадеВох ("Неопознанная ошибка", 
"Ошибка копирования", 
МВ _ТСОМЕХСЪАМАТТОМ + МВ_ОК); 
Гогм1->Сигзог = сг/)еЁао1%; 
гесиагп Га15$е; 
} 
} 
} 


В функцию передаются имена файлов источника и приемника — ЕПе1 
и ЕПе2. В них могут быть указаны пути. Если путь не указан, подразумевается 
текущий каталог. Параметр Ое] указывает, должен ли файл-источник уда- 
ляться после копирования, т.е. должно ли осуществляться перемещение фай- 
ла, или только копирование. Функция возвращает фгие, если копирование 
прошло успешно. В противном случае возвращается #а]$е. 

В начале функции следуют многочисленные проверки правильности ис- 
ходных данных. Их задача — пояснить пользователю суть возникающих про- 
блем, чтобы он мог принять соответствующие меры. Заодно, и читатель дан- 
ной книги получает представление о многих подводных камнях копирования. 
Некоторые из проверок сопровождаются диалогами. В частности, диалог ве- 
дется, если отсутствует каталог файла-приемника. Имя этого каталога извле- 
кается функцией Ехёгае ЕПеП!т из строки ЕПе2. Если имя каталога не пустая 
строка (т.е. каталог не текущий), то попыткой войти в этот каталог функцией 
СЬП!т проверяется, существует ли каталог и доступен ли он. Если не существу- 
ет и пользователь в диалоге соглашается его создать, то каталог создается 
функцией МЕП!:. 

Еще один диалог происходит в случае, если файл-приемник уже существу- 
ет. Проверка существования файлов осуществляется функцией ЕПеЕх1$$$. 
Если пользователь соглашается продолжать копирование, то создается копия 
существующего файла-приемника с расширением „БаЁ. Это осуществляется 
функцией переименования файла ВепатеЕ1е, объявленной следующим обра- 
зом: 


роо1 __Еаз®са11 ВепамеЕ11е (сопзЕ Ап515ег1па О1АМапте, 
соп5е Ап$15Ег1па МемМапе); 


Параметры О1АаМате и М№е’Мате — прежнее и новое имена файла. Если 
переименование невозможно, функция возвращает #а]5е. В частности, это про- 
исходит, если файл с именем М№емМаше уже существует. Поэтому в нашем 
примере сначала надо проверить, не существует ли уже копии файла-приемни- 
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ка с расширением БаА. Это проверяется функцией Е|еЕх1$ 5, в которую пере- 
дается полученное функцией СВапееЕПеЕх{ имя файла с расширением, изме- 
ненным на “.Бак”. Если копия уже существует, она удаляется функцией 
РеееЕ!е. И только после этого функцией КепатеЕПе файл-приемник пере- 
именовывается. 

Несмотря на обилие проверок, далеко не все возможные ошибки в них пре- 
дусмотрены. Поэтому в функции используется блок %гу ... сайеВ, отлавливаю- 
щий исключения. При этом для исключения, связанного с доступом к файлам, 
пользователю дается пояснение проблемы, а для остальных исключений выда- 
ются только сообщения об ошибках. | 

Конечно, все многочисленные диалоги в данной функции можно убрать, 
и при возникновении проблем можно просто выходить из функции или прини- 
мать какие-то действия по умолчанию. Например, без всякого диалога созда- 
вать в необходимых случаях копии файлов. Устранение диалогов кардинально 
сократит размер функции копирования. 

Собственно копирование начинается с вызовов функций #ореп(). Открыва- 
ются оба файла, а затем порциями по $12е байт содержимое файла-источника 
читается в буфер ВчЁ функцией #{геа4. При этом в переменную Вез$ заносится 
число реально прочитанных байтов. Далее содержимое буфера ВиЁ заносится 
в файл-приемник функцией ЁутЦе, и если число записанных байтов окажется 
меньше, чем число прочитанных, то выдается ошибка. Эта проверка актуаль- 
на, например, если вы копируете файл на дискету, и он не помещается на нее. 

В данном примере размер буфера $12е установлен равным 1000. Это число 
может быть произвольным. Чем больше этот размер, тем скорее будут копиро- 
ваться большие файлы. Так что все зависит от оперативной памяти вашего 
компьютера. При больших объемах памяти компьютера размер буфера можно 
увеличивать и до миллионов. 

После копирования проверяется параметр Ое]. Если он равен фгие, то 
файл-источник удаляется с диска. 

Вызов рассмотренной функции копирования можно осуществлять, напри- 
мер, оператором 


1Е (Сору(Еа1%1->Техе, Еа1%2->Техе, Еа1$е)) 
ЗВомМеззаче ("Копирование завершено"); 


Здесь предполагается, что имена файлов записаны в окнах редактирова- 
ния ЕЗЦ1 и Е9Ц2. Если требуется не копирование, а перемещение файлов, вы- 
зов может иметь вид: 


1Е (Сору (Еа1%1->Техе, Еа1%2->Техе, Егое) 
ЗПомМеззасче ("Перемещение завершено"); 


В С+-+Ви!аег имеется также функция СоруЕПеТо, обеспечивающая копи- 
рование файлов, правда, без многочисленных проверок, рассмотренных ранее. 
Первый ее аргумент задает имя копируемого файла, а второй — имя копии. 
Оба имени могут содержать путь. Функция объявлена в заголовочном файле 
ТАаС1оБа[.йрр, который надо вручную подключать к модулю: 


#10с101Ае <ТАас1ора1.Врр> 
В качестве примера, следующий оператор: 
СоруЕ11еТо ("с:\\ТезЕ.6хе", "с:\\Т\\ТезЕ1. 6 хе") 


копирует файл с:\Тезёлл| в папку с:/\Т под именем Тез{154хт. Функция вернет 
Га]5е, если нет исходного файла, если нет папки с:\Т, или если эта папка есть, 
но в ней уже имеется файл Тезё14хё. 
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6.9 Копирование файлов с помощью потоков 


Копировать файлы можно с помощью потоков типа ТЕЙефгеат. Создание 
такого потока осуществляется вызовом конструктора 


__Фаз&са11 ТЕ11е5%егеам (сопз® Ап$15&г1па Е11еМаше, Иога Моае); 


Первый аргумент ЕИеМаште — строка с именем файла. Если в ней не задан 
путь к файлу, подразумевается текущий каталог. Второй аргумент Моде опре- 
делят режим открытия файла и может включать один флаг режима и один 
флаг доступа. Флаги режима могут быть следующими: 


Создается файл с данным именем. Если подобный файл 
уже существовал, его содержимое стирается и файл от- 
крывается в режиме записи. 


тСгез{е 


пОрепВеа4 Открывает существующий файл только для чтения. 


Открывает существующий файл только для записи. 


{пОреп\У/гЦе. 
Прежнее содержимое файла стирается. 


{тОрепВеад У гце (Файл открывается для чтения и записи. 


Флаги доступа могут быть следующими: 


{тЭВагеСотра% Доступ определяется ЕСВ. 


{тЗБагеЕхс]аз1уе |Другие приложения не могут открыть файл ни для за- 
писи, ни для чтения. 


После того как входной и выходной потоки для копирования файлов соз- 
даны, можно использовать для копирования метод СоруЕгот: 


11 __Еаз®са11 СоруЕгом(Т5©геам* 5оигсе, 1пе СочпЕ); 


Параметр Зоигее определяет поток, из которого копируются данные, а па- 
раметр Соипф указывает число копируемых байтов. Если Соипф = 0, то копиру- 
ется весь файл. 

Таким образом, копирование файла /Ш1е1 в файл {[Ше2 с помощью потоков 
может быть организовано следующим образом: 


ТЕ11ебегеам * боогсе, *Тагаеф; 


Егу 

{ 

боигсе = пем ТЕ11ебегеап ("ЁЕ11е1", ЕтОрепВеаа); 
Тагхае®е = пем ТЕ11ебегеам ("Е11е2", ЕтСгеафе); 
гу 


{ 


Тагде*->СоруЕгом ($оигсе, боигсе->512е); 


} 
__Е1па11у 
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{ 
Че1ете Тагадек; 
} 


} 
__Е1па11у 
{ 


Яе1ефе $ойгсе; 
} 
При копировании дата копии станет текущей. Если вы хотите при копиро- 


вании сохранить в копии дату исходного файла, это можно сделать функция- 
ми ЕИесбе{Ра{е и ЕПеЗеОафе: 


Е11ебесрафе (Тагаеф->Напа1е, Е11ебефрафе ($оцгсе->Напа1е)); 


6.10 Манипуляции с файлами и каталогами 
с помощью функции 5ПЕЙеОрега оп 


В АРТ \У/114о\мз имеется ряд функций, обеспечивающих манипуляции 
с файлами и каталогами. Копирование файлов может осуществляться функ- 
циями СоруЕШе и СоруЕПеЕх. Функции МоуеЕЦе, МоуеЕПеЕх, МоуеЕ1- 
1е\ИВРго2гез$ позволяют перемещать и переименовывать файлы и каталоги. 
Все эти функции подробно описаны в гл. 8. А в данном разделе мы рассмотрим 
функцию ЭВЕПеОрегайЙоп, которая обеспечивает максимально широкие воз- 
можности по копированию, перемещению, переименованию и удалению фай- 
лов и каталогов. В файле бйеЦАРГ.Й она объявлена следующим образом: 


ЗНУТРАРТ (116) 5НЕ11еОрегаЕ1оп (ГРЗНЕТЬЕОРЗТВОСТ 1рЕ11еОр); 


В функцию передается единственный параметр 1рЕПШеОр — указатель на 
структуру, содержащую всю инфомацию о требуемой операции с файлами 
и каталогами. Тип этой структуры объявлен следующим образом: 


КуреаеЕ зегисЕ _ЗНЕТЬЕОРЗТВОСТ 
{ 


НУМР Пипа; 

ОТМТ мЕРапс; 

.РСЗТКВ РЕком; 

ТРСЗТК рТо; 

ЕТЬЕОР _ЕЪАС5 ЕЕ1ааз; | 
воОг ЕАпуОорега® 1опзАрогфеа; 
.РУОТЬ ПМапеМарр1паз$; 

Ь.РСЗТКВ 1рз2Ргоаге$$Т1е1е; 


} ЗНЕТЬЕОРЗТВОСТ, *ЬРЗНЕТЬЕОРЗТВОСТ; 


Основное поле, определяющее производимую операцию — МЕипсе. В это 
поле можно записать одно из следующих значений: - 


А ИУ АРРРАИАЕР 7 
‚: РО _СОРУ Копирование файлов, указанных в поле рЕгот, в файл или | 
| «› Ц 
каталог, указанный полем рТо. 
Г Г. ООО КОАО ООО 
‹ РО_РЕБЕТЕ Удаление файлов, указанных в поле рЕгот. Поле рТо игнори-_ 


‚руется. _ 


‚ Перемещение файлов, указанных в поле рЕгошт, в файл или 


НИИ ее — — —— -— а о ЖИ 
| 


`РО_МОУЕ 


| 
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Поле рЕгот указывает буфер, содержащий имя или имена файлов, с кото- 
рыми производится заданная операция. Отдельные имена должны разделять- 
ся нулевыми символами. Завершаться список имен должен двумя нулевыми 
символами. , 

Поле рТо указывает буфер, содержащий имя файла или каталога, являю- 
щегося приемником. Если в поле # 1а5$ указан флаг ЕОЕ_ МОТГТГЕ$ТЕП.Е, 
то буфер может содержать список имен файлов. Отдельные имена должны раз- 
деляться нулевыми символами. Завершаться список имен должен двумя нуле- 
выми символами. 

Поле #{ 1аё$ может т содержать комбинацию следующих флагов: 


РОЕ_ АТОМОМ | Сохранить по возможности 1 информацию д для с 
отмены операции. Например, при удалении | 
файлов они перемещаются в корзину, из ко- | 
торой их потом можно восстановить. = \ 
РОЕ_СОМЕТЕММООЗЕ | _| Не реализован. | | 


РОЕ ЕПЕЗОМЕУ Осуществлять операцию только при задании Ой. 


‘шаблона “*.*”. 
РОЕ_МОГТШЕЗТЕЦ.Е$ Указывает, что поле То содержит не папку, | 
куда надо доставить все файлы-источники, \' 
а множество имен приемников — по одному 

__ | _| на каждый файл- источник. 


РОЕ_ МОСОМЕТЕМАТЮМ Отвечать “да для всех” на все вопросы, кото- : 

рые могут задавать диалоги в процессе вы- | 
полнения операции: об удалении файлов. 
о создании новых папок и т.д. 


РОР_МОСОМЕТВММКОГВ ‚ Не делать запрос о создании нового каталога, ! 
. если требуемый каталог отсутствует. 


ИН реа 4-4 


ГОРЕ _ ВЕМАМЕОМСОТ115ТтОМ ‚ Если при операциях копирования, переноса | 
или переименования файлы- -приемники уже 
` существуют, давать им имена типа "Копия ...”, | 
_не запрашивая у пользователя подтверждения. 


ЕОЕ_ ЭПЕМТ Не показывать окно с отображением хода 


ООО процесса. 
РОЕ_ ЗТМРЕЕРВОСВЕ$ $ Показывать окно с отображением х хода про- = 


цесса, но не отображать в нем имена файлов. | 


ГОРЕ _ \АМТМАРРИМСНАМОГЕ Заполнить поле ВМатеМарр!т5$. Указанный 
в нем дескриптор должен быть в дальнейшем ' 
| | ____ _ [освобожден функцией 5НЕгееМатеМарртез. | 


== 


В поле ЁГАпуОрегайоп$ АБоме4 структуры _ЗНЕПШЕОРЗТКВОСТ функция 
эвЕПеОрегаЯоп возвращает фгие, если выполнение операции было прервано 
пользователем. Поле ВМатеМарр1тя$ содержит указатель на массив струк- 
тур, содержащий прежние и новые полные имена всех файлов, над которыми 
проводились операции. Поле 1р5$2Ргосгез Те содержит указатель текста, по- 
мещаемого в окно отображения процесса при включенном флаге ЕОЕ_$1МР- 
ГЕРВОСКЕЗ$Ъ. 

Рассмотрим подробнее возможности функции ЭЗВЕПеОрегайоп. Сначала 
остановимся на режиме копирования, когда мРипе = ЕО_СОРУ. Если в рЕгот 
записать текст "Ёе1.4хё", а в рТо — “"Ё!е2.5х%", то в текущем каталоге будет 
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создана копия Де? фхт файла Ше1лхЕ. Если файла /Це1.4х+ в каталоге не ока- 
жется, будет показано стандартное окно \У/1т4оу\гз с сообщением, что копирова- 
ние не может быть проведено, так как указанного файла нет. В этом случае 
функция 5АЕПеОрегаЙоп вернет ненулевое значение, свидетельствующее об 
ошибке. 

Если в каталоге имеется уже файл Пе? фхф, то выполнение копирования 
будет зависеть от наличия в Ё1а5$ флага ЕОЕ_ВЕМАМЕОМСОШИЛЪЬТОМ. Если 
этот флаг отсутствует, пользователю будет показано стандартное окно У ш- 
4о\з с сообщением, что файл уже имеется, и с предложением ответить, надо 
ли заменять файл, созданный тогда-то, новым файлом, созданным тогда-то. 
При положительном ответе файл /Ше?ахЕ будет заменен и функция ЭВЕ 1е- 
ОрегаНоп вернет 0. При отрицательном ответе копирование будет прервано, 
и функция ЭВЕПеОрега оп вернет ненулевое значение. 

Впрочем, окно с запросом о замене файла, как и все другие запросы, будет 
показано пользователю, только если не установлен флаг ЕОЕ_МОСОМЕТВК- 
МАТТОМ. Если же этот флаг установлен, то вместо запросов автоматически бу- 
дут выполняться действия по умолчанию. 

Если файл Ше2?4хЕ имеется, и задан флаг ЕГОЕ_КЕМАМЕОМСОСИЬ$ТОМ, 
то, независимо от флага ЕОЕ_МОСОМЕТВМАТТОМ, никаких запросов пользо- 
вателю не будет, а в каталоге будут автоматически создаваться копии файла 
{е1ахЕ с именами "Копия #е1.$х%", "Копия (2) е1.4х%” и т.д. 

В рассмотренных примерах имена файлов были заданы без путей, так что 
подразумевался текущий каталог. Если заданы полные пути к файлам, то мо- 
гут возникать различные ситуации. Если нет каталога, указанного в рЕгош, то 
реакция будет такая же, как описана выше при отсутствии файла. А если нет 
каталога, указанного в рТо, то пользователю будет показано стандартное окно 
\М/п4оугз с сообщением, что папка отсутствует и с вопросом, надо ли ее созда- 
вать. При положительном ответе папка будет создана, файл скопируется, 
и функция 5ВЕПеОрега оп вернет 0. При отрицательном ответе копирование 
будет прервано, и функция ЭВЕПеОрегайоп вернет ненулевое значение. 

Запрос о создании отсутствующего каталога будет сделан только в случае, 
если не установлен флаг ЕОЕ МОСОМЕТВММКОНЩ. А при наличии этого фла- 
га отсутствующий каталог всегда будет создаваться автоматически. 

Мы рассмотрели случаи, когда копировался один файл. Однако в рЕгот 
может быть задан шаблон. Например, “с:\\{ез{\\*.4х4” или “с:\\4ез\\*.*”. 
Первый из них означает копирование всех файлов с расширением „1х из пап- 
ки с:\Е 31, а второй — копирование всех файлов папки. При задании в рЕгот 
шаблона подразумевается, что в рТо задан каталог. 

В рЕгот можно задавать имена нескольких файлов или нескольких шабло- 
нов, разделяя их нулевыми символами. Например, текст "*.4х4\0*.ехе\0\0”, за- 
несенный в рЕгош, обеспечит копирование из текущего каталога всех файлов 
с расширениями ЁхЁи .ехе в каталог, указанный в рТо. 

С помощью шаблона можно скопировать все файлы указанного каталога. 
Однако в рЕгот можно задать не файл, не шаблон, а имя каталога. Напри- 
мер, “с:\\{$ез$”.В этом случае и в рТо тоже должен быть задан каталог. На- 
пример, "4:\\$”. Тогда каталог, указанный в рЕгош, будет скопирован как 
вложенный в каталог, указанный в рТо. В данном примере создастся каталог 
а:\Т\1езт. Одновременно будут скопированы и все каталоги, вложенные 
в рЕгош, и все файлы в этих каталогах. Если окажется, что в каталоге рТо 


уже имеется каталог с аналогичным именем, то при отсутствующем флаге 
КОЕ ВЕМАМЕОМСОТГТЛЬТОМ будет создана копия каталога, А если этот 
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флаге задан, то пользователю будет показано диалоговое окно с запросами 
о замене существующих файлов. 

Мы рассмотрели подробно копирование файлов. Перемещение файлов (ре- 
жим ЕО МОУЕ) осуществляется аналогично. Отличие только в том, что фай- 
лы-источники удаляются. При удалении файлов (режим ЕО_БЕЕБГЕТЕ) содер- 
жимое поля рТо безразлично, а в поле рЕготш можно, как и раньше, задавать 
имена папок, файлов и шаблоны. И при перемещении, и при удалении можно 
устанавливать флаг КОЕ_АЕТО\МОМОО. Это обеспечит удаление файлов 
в корзину, так что в дальнейшем пользователь сможет отменить это удаление, 
если оно сделано по ошибке. 

Режим ЕО_КЕМАМЕ обеспечивает переименование файла или файлов. Но 
шаблоны при этом не используются. Если в поле рЕгош записано несколько 
файлов, то в поле рТо должен быть записан аналогичный по числу элементов 
список новых имен. Пользуясь этой возможностью, несложно обеспечить 
и применение шаблонов при переименовании. Но это должно быть сделано 
внешним образом, чтобы представить шаблоны списками файлов. Пользуясь 
приемами, рассмотренными в разд. 6.6, это нетрудно сделать. 

Операции, выполняемые функцией 5ВЕПеОрегайоп, сопровождаются по 
умолчанию стандартными диалоговыми окнами У\У1140\$, сообщающими 
о проводимой операции, именах файлов, времени, оставшемся до окончания 
операции, отображающими диаграмму процесса. Если установить флаг 
КОЕ_51МРГЕРВОСВЕ$5, то эти окна не будут отображать имен файлов. Вме- 
сто этого будет отображена строка, указанная в поле 1р$7Ргосгезз Те, так что 
вы скроете от пользователя детали проводимой операции. А если установлен 
флаг ЕОЕ_ЗТЕМТ, то окна отображения хода процесса вообще не появляют- 
ся. Работать в таком режиме имеет смысл, если вы не хотите дать возможность 
пользователю прервать операцию. К, тому же, при операциях, производимых 
над большим числом не очень больших файлов, окно отображения хода про- 
цесса очень заметно увеличивает время выполнения операции. 


Теперь приведем примеры программных кодов. Рассмотренная ниже 
функция обеспечивает все операции с файлами и папками, не задавая никаких 
флагов. Первый параметр функции ЕготЕЦе — имя исходного файла, папки 
или шаблон. Параметр ТоЕЦе — имя файла или папки, куда осуществляется 
копирование, перемещение, переименование. Последний параметр тоде зада- 
ет выполняемую операцию: ЕО _СОРУ — копирование, ЕО_МОУЕ — переме- 
щение, ЕО_РЕГЕТЕ — удаление, ЕО КЕМАМЕ — переименование. Функция 
возвращает 0, если операция благополучно заверптилась, или 1, если пользова- 
тель прервал операцию, или 2, если произошла оптибка. 

Ниже приведен код этой функции: 

105 Е11еМападе (Апз15Ех1па ЕгомЕ11е, Апз1бег1па ТоЕ1]е, 1пЕ тоае) 


{ 

СНЕТТЕОРЗТВОСТ 5НЕ; 

5НЕ.ВмпЯ = 0; 

5НЕ.рЕгом = ЕгошЕ11е.с $%г(); 
З5НЕ.рТо = ТоЕ11]е.с_з6г(); 
5НЕ.мРарс = пшоае; 

ЗНЕ. ЕЕ1аачз = ГОЕ_ АБЬОМОМОО; 


1Е (5НЕ11еОрега®1оп (&5НР) !=0) 
1Е (ЗНЕ.ЕАпуОрега® 1опзАрогееа) 
гесагп 1; 
е1зе гебоагп 2; 
гебогп 0; 


} 
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Думается, что никаких дополнительных комментариев к этому коду не 
требуется. Эту функцию можно вызывать, например, так: 


51 ср ( Е11еМападе ("Е11е1.ЕхЕЁ","Е11е2.ЕхЕ", КО СОРУ)) 
{ 


сазе 0: 5ПомМеззаде ("Операция успешно завершена"); 
Ргеак; 

сазе 1: 5ПомМез5засе ( 
"Выполнение операции прервано пользователем"); 
БгеаКк; 

сазе 2: $ромМеззаае ("Ошибка выполнения операции"); 


} 


Такой вызов обеспечит копирование файла /{1е1.4х в текущем каталоге 
в файл /Ие2лхЕ. Если заменить в этой структуре вызов функции на следующий: 


Р11еМападе ("с:\\Еезё\\*.*", "с: \\%\\", ГО _СОРУ) 


то все файлы из каталога с;\{езт будут скопированы в каталог с:\{. При следу- 
ющем вызове: 


Р11еМападе ("с:\\&", "а: \\66", Ро _МОУЕ) 


будет создана папка а:\Н\, которая вместит все файлы папки с вместе со 
всеми вложенными в нее каталогами, а прежняя папка с:\ удалится (в корзи- 
ну, поскольку включен флаг ЕОЕ АТТОМОМОО). Вызов 


Е1]еМападе ("с:\\Е", "", ГО РЕТЕТЕ) 


удалит в корзину папку с: со всеми вложенными в нее каталогами. 
Рассмотрим теперь более развернутый пример (проект РЫЙРИе в каталоге 
ЕЦез на приложенном к книге диске), который позволяет протестировать боль- 
шинство возможностей функции 5НЕПеОрегайоп. Окно этого приложения во 
время выполнения приведено на рис. 6.13. Оно содержит два окна редактиро- 


вания типа ЕЁ: окно ЕЗоогсе, в которое записывается источник — файл, 
Рис. 6.13 Копирование... 
Окно приложения во | 
время выполнения У | ОС 
— — 

Копия РЕлф.ехе 

"в" | 

[| 

Осталось 40 сек. | 


м Запрашивать подтверждение операций _ | ` заменить 


Г” Автоматически создавать новые каталоги 


Выполнить | 
"ООО _ ОИ __ + 
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папка, шаблон, и окно ЕТагее%, в которое записывается приемник — файл или 
папка. Около этих окон имеются кнопки Выброть (их имена ВЕта1 и ВЕт@2), 
которые открывают стандартные диалоги выбора файлов и заносят результаты 
в соответствующие окна. В окно ЕЗоигсе можно заносить несколько источни- 
ков, разделяя их точками с запятой ";". 

Группы радиокнопок ВаФюоСгоир1, ВаФюоСгопр2 и Ка41оСгопр3 включа- 
ют кнопки, переключающие соответственно тип выполняемой операции, реак- 
цию на уже имеющийся приемник файлов и режимы отображения хода про- 
цесса. Индикаторы СВесКВох1 и СВесКВох2 управляют запросами пользовате- 
лю и автоматическим созданием каталогов. Кнопка Выполнить (ВиВвбопТ) начи- 
нает выполнение заданной операции. Помимо визуальных компонентов на 
форме размещен компонент ОрепП!а]10#1 — диалог открытия файла, и компо- 
нент АррИсайопЕуеп{ $1, используемый для отображения в окнах редактиро- 
вания ярлычков с длинными текстами, не вмещцающимися в ширину окон. 

Ниже приведен листинг функций данного приложения. 


#10с1а4е <ус1.6> = 
#1остоае <$%х0611$.Врр> 


У014 __Еаз®са11 ТЕогм1: :ВЕ1п91С11сК (ТОр]есЕ *5епаег) 
{ 
116 1; 
Орепр1а1о0о91->ОрЕ1о0оп$ = 
Орепр1а1091->Ор®1о0оп$ << оЕА11омМи1Е15е1есе; 
1Е (Орепр1а1о91->Ехесаке ()) 
{ | 
Е5оигсе->Техе=""; 
ог (1=1; 1 <= Ореп)1а1о0о91->Е11е$->Соцпё;1++) 
Ебоцгсе->Техе = Ебочгсе->Техе + 
Ореп)1а1о391->Е1]1ез->5Ег1паз [1-1] +";"; 


Орепр1а1о0о91->ОрЕ1о0оп$ = Ореп0)1а1о0о91->Оре1оп$ >> оЕА11омМи1%15е1есе; 
1Е (Орепр1а1о91->Ехесаее ()) 
ЕТагдее->Техе = Ореп)1а1о91->Е11еМаме; 


У01А _ Еазеса11 ТГогм1::Вае6оп1С11сКк (ТОБ]ес® *5епаег) 
{ 

ЗНЕТЬЕОРЗТКОСТ 5НЕ; 

Ап$15Ег1па 5Егош, 5То; 


ЗЕком = Ебоогсе->Техе + "\0\0"; 

ЗРЕгом = Ап51Вер1асебЗег (5Егом, ';', '\0'); 
СТо = ЕТагае®->Техе + "\0\0"; 

5НЕ.ВмпЯ = 0; 

5НЕ.рЕгом = 5Егом.с_3ет(); 

ЗНЕ.рТо = $То.с з%к(); 

ЭЗНЕ.ЕЁЕ1аа$ = КОЕ_АБЬОМОМОО; 

1Е (!СБескКВох1->СЪескКеа) 


ЗНЕ. ЕЕ1ачз = (5НЕ.ЕЕ1ааз | КОЕ МОСОМЕТВМАТТОМ); 
1Е (СБескКВох2->Скескея) 
ЗНЕ.ЕЁР1ачз = (5НЕ.ЕЕР1адз | КОЕ МОСОМЕТВММКОТВ); 


$м16еср( Ваа1оСгоир1->ТЕемТпаех) 


{ 
сазе 0: $НЕ.мРапс = ЕО СОРУ; 


Бгеак; 
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сазе 1: $НЕ.мЕипс = ЕО МОУЕ; 
ЬгеаКк; 

сазе 2: 5НЕ.мРипс = ЕО ВЕМАМЕ; 
ЬгеаКк; 

сазе 3: $5НЕ.мРипс = ЕО РЕЪЕТЕ; 

} 


1Е (ВаЧ41оСбгоцр2->Т%етшТпаех == 1) 
ЗНЕ. ЕЕ] аз = $НЕ.ЕЕТаа$ | ГОГ КЕМАМЕОМСОЬЬТЗТОМ; 
1Е (Ваатобгопр3З->ТеетТпаех == 2) | 
СНЕ. ЕЕ] ачз = $5НЕ.ЕЕ1ааз | КОРЕ ЭТЬЕМТ; 
е1ъе 1Е (Каа1обгопр3З->ТЕетТпаех == 1) 


{ 
ЗНЕ.ЕЁЕ1ачз = $5НЕ.ЕЕ1ааз | РОЕ_5ТМРЪЕРВОСВЕ$5; 


ЗНЕ.1рз2Ргодге$$Т161е = "Пожалуйста, подождите"; 
} 
1Е (5НЕ11еОрегабетоп (&5НЕ) != 0) 
1Е (ЭНЕ.ЕАпуОрега®1опзАрогееяд) 
ЗВомМеззасе ( 


"Выполнение операции прервано пользователем"); 
е1з5е 5помМеззаде ("Ошибка выполнения операции"); 
е15е 5$помМеззасе ("Операция успешно завершена"); . 


у014 _ Еазеса11 ТГогм1 : :Арр11са1опЕуеп®515ПомН1 пе ( 
Ап$156глпа &Н1пе5ег,рооЪ &Сап5вом, ТНапЕТпЕо &НапЕТпЕо) 


{ 
1Е (Апз156г1па (НтпЕТлЕо.Н1п®Соп®его1->С1аз$Маше ()) == "ТЕате") 


1Е (Габе11->Сапуаз->ТехеЕМтавв ( 
((ТЕазЕе *) Нап ЕТоЕо.НарпЕСопего1) ->Техе) > 
Нато ТиЕо.Н1пЕСопЕго1->С11еп  И1аеь) 


{ 
НарЕбех = ((ТЕатЕ *) Нато ЕТоЕо. Нап ЕСоп® го] ) ->ТехЕ; 


Арр11са®*1опЕуеп*$1->Сапсе1015ра®св (); 
} 


} , 

Рассмотрим приведенный код. Директивой #та4е подключается файл 
51701418.Йрр, необходимый для используемой в приложении функции Ап$1- 
Вер!асеЪь. 

Функция ВЕша1СПеК является обработчиком щелчка на кнопке Выбрать, 
расположенной около верхнего окна редактирования. Задача обработчика — 
вызвать диалог открытия файлов и занести результат выбора пользователя 
в окно ЕЗоигее. Поскольку в этом окне пользователь может задавать несколь- 
ко файлов, то первым оператором в множество опций диалога ОрепО!а]10о51 
вносится опция оЁАПомМи 5 еес&, обеспечивающая множественный выбор. . 
Далее вызывается диалог, анализируется результат выбора пользователя 
в свойстве ЕЦ ез, и в окно Ебоигсе добавляются имена выбранных файлов, раз- 
деляемые точкой с запятой. Выбран не режим замены текста ЕЗопгсе, а добав- 
ления, чтобы пользователь мог последовательно выбрать несколько файлов из 
разных каталогов. 

Функция ВЕша2СПсК в дополнительных комментариях, вероятно, не ну- 
ждается. Она удаляет возможность множественного выбора в диалоге и зано- 
сит результат выбора пользователя в окно ЕТагееф. 
| Теперь рассмотрим главную функция приложения — ВиНоп1СИсК. В ней 
объявлена переменная ЭНЕ — структура, содержащая информацию о выпол- 
няемой операции. В начале функции текст окна ЕЗопгсе заносится в локаль- 
ную переменную ЗЕгот. Этот текст может содержать разделители списка фай- 
лов в виде точки с запятой. А в соответствии с описанием функции °НШе- 
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Орегайоп, разделителями должны быть нулевые символы. Поэтому функцией 
Ап$1Вер!асе5 {г в строке ЗЕгот все символы ";" заменяются нулевыми симво- 
лами. 

Далее в переменную ЗЭТо заносится текст окна ЕТагоеф, и начинается фор- 
мирование полей структуры ЗНЕ. Совокупность флагов ЁЕТ1а55$ формируется 
в зависимости от выбора пользователя в группах радиокнопок и в индикаторах. 

В конце функции вызывается функция Э°НЕПеОрегайоп и анализируется 
возвращенный ею результат. Если результат не нулевой, то по значению поля 
{АпуОрегаНоп$ АБоге@ структуры ЗНЕ определяется, было ли выполнение 
прервано пользователем, или оно прервалось вследствие ошибки. 

Вспомогательная функция АррИсайопЕуеп{$15 Бом Нтф обеспечивает 
при остановке курсора мыши над окнами редактирования отображение в яр- 
лычках полного текста этих окон, не помещающегося в них. Подобная воз- 
можность необходима, так как полные имена файлов, отображаемые в окнах, 
могут быть очень длинными. А. пояснение кода этой функции вы можете най- 
ти в разд. 5.1. 


6.11 Перетаскивание файлов из папок \М/т4о\ми$ 
в приложение 


Если желательно обеспечить пользователя возможностью перетаскивать 
на форму файлы технологией ПОга&Огор, как это делается во многих програм- 
мах У\/114о\з, прежде всего надо сообщить системе, что форма может быть 
приемником файлов. Делается это объявленной в файле б5йеПАРГ.Й функцией 
ОгагАссер Е 1ез: 


ЗНУТРАРТ (\01а) РгадАссереЕ11ез (НИМО Ипа, ВОО Ассерф); 


Ее первый параметр У\Уп4 является дескриптором окна формы, которая 
может служить приемником файлов. А параметр Аесер{ установленный в &гие 
указывает, что окно регистрируется как приемник файлов. Так что, напри- 
мер, в обработчике событии ОпСгежфе формы можно записать оператор 


РгадАссер®Е11е$ (НапЧ1е, фгое); 


а в обработчике события ОпО)е$ёгоу записать оператор 


РгачАссер®Е11е$ (НапА1е, ЕЁа15е); 


снимающий форму с регистрации приемников файлов. 

Если форма объявлена приемником файлов, она должна обрабатывать со- 
общение \У/114о\з5 \УМ_ЮВОРЕП.Е$. В обработчике этого сообщения вы мо- 
жете получить информацию о полных именах перетащенных файлов с помо- 
щью функции ОгабоиегуЕ Це, объявленной в файле 5йеПАРГ.А следующим 0б- 
разом: 


ЗНУТРАРТ (ОТМТ) РгааОчегуЕ11е (НОВОР Ргор, ОТМТ Е11етпаекх, 
ТРЗТВ Е11еМапе, ОТМТ сБ); 


Параметр РОгор указывает на поле \УРагат структуры сообщения 
\ММ_ОКБОРЕП.Е$. Параметр ЕИеш@4ех указывает, что именно вы хотите уз- 
нать. Если значение ЕИеш4ех лежит в диапазоне от 0 до числа перетащенных 
файлов, то этот параметр трактуется как номер файла. Дело в том, что перета- 
щено может быть одновременно несколько файлов. Тогда первый из них имеет 
- номер 0, второй — 1 ит.д. Если в качестве ЕИет4ех задан номер файла, то 
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функция занесет в массив ЕИеМате размером сЬ имя этого файла с полным 
путем к нему. В этом случае функция возвращает число занесенных в буфер 
Е|ЦеМате символов, не считая заключительного нулевого. 

Если в качестве параметра ЕИеМате задать МОТ, то функция вернет тре- 
буемый размер буфера. Так что по этому значению можно выделить в памяти 
буфер соответствующего размера и при следующем вызове функции ЮОгаб- 
ОцегуЕПе занести в него имя файла. 

Еще один режим выполнения функции ОгаёОцегуЕЦе включается, если 
задать значение ЕПет4ех равным ОхЕЕЕЕЕЕЕЕ. В этом случае функция вер- 
нет число перетащенных файлов. 

После того как вся информация о числе перетащенных файлов и их име- 
нах получена в обработчике события \УМ_РОВОРЕП.Е$, надо вызвать функ- 
цию ОгайЕпизВ, передав в нее в качестве аргумента поле \УРагат сообщения. 

Посмотрим, как все это выглядит на примере проекта РОгах, который вы 
найдете на приложенном к книге диске в каталоге РИез. Форма приложения 
(см. рис. 6.14) содержит список Г4$& Вох], в который заносятся имена перета- 
щенных на форму файлов, окно редактирования В1еВЕЯЦ1, отображающее 
текстовые файлы, и компонент Пвабе1, отображающий файлы изображений. 
При перетаскивании одного или сразу нескольких файлов на форму их имена 
заносятся в список 11$&Вох1. В первый момент открывается первый файл. 
Двойной щелчок на том или ином файле в 11$ Вох1 открывает соответствую- 
щий файл. 


Рис. 6.14 =. Перетаскивание файлов на форму и и. 
Приложение, _ На Форму можно перетащить Файлы 64. тр и любые другие 
допускающее Список порвтащенных ‘файлов 

перетаскивание Бур атрАСВыыЕАЕСТ Л Посмотрим, как все это выглядит на > 
в него файлов примере проекта РОгад, который вы 


найдете на приложенном к книге диске. 
Форма приложения (см. рис. 11.11) 


содержит список Тл$Вох1, В КОТОрый 

заносятся имена перетащенных на 
{форму файлов, окно редактирования 
_ВевЕФИ, отображающее текстовые 
файлы, и компонент [пасе], 

отображающий файлы изображений. 

Пои пепетаскирании олного ипи свазиу = 


Ниже приведен текст этого приложения с некоторыми сокращениями. 
Приведем сначала описание класса. 


с1аз$ ТГогп1 : раБ11с ТЕГогм 


{ 


рг1уафе: // Изег аес]агаЕТопз$ 
у01А _ Еа$®са11 ММОВОРЕТЬЕ$ (ТМеззаде“); 
рирт1с: // ПОзег аес]1агаЕ1опз$ 


`ВЕСТМ _МЕЗЗАСЕ МАР 
МЕЗЗАСЕ _НАМОТЕВ (ИМ РВОРЕТЬЕ$, ТМеззаде, ИМОВОРЕТЬЕЗ) ; 
ЕМР МЕЗЗАСЕ_МАР (ТСотропепь); 
}; 


Теперь перейдем к реализации кода программы: 


у01А _ Еаз®са11 ТГогш1 : : ИМОВОРЕТЬЕ$ (ТМеззаде &Мз$9) 
{ 


сваг ЁЕ1]епапе [256]; 
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10пЕ СочпЕ, 1; 

// число перетащенных файлов | , 

СоцпЕ = ОгадОцегуЕ1Те ( (уо1а*) Мза.ИРагам, ОХЕЕЕЕЕЕЕЕ, 

ЕР1]1епапе, 517еоЕ (Р1]1епаме)); 

11$5%Вох1->С1еаг(); 

// цикл` по файлам 

Бог (1=0;1< СоипЕ;1++) 

{ 

// запрос имени файла | 
РгадОцекуЕ1 1е ( (У0о19*) Мзда.МРагам, 1, Е11епаме, 512ео0Е (Р11епатё)); 
Т.1$ЕВох1->Т6етмз->Ааа (Е1]епаме); 
// завершение перетаскивания 
РгааЕ1п1 51 ( (уо1а*) Мза.МРагам) ; 

Т13ЕВох1->Ткеш1Тп4ех = 0; 

// уход на загрузку файла 

Ь15ЕВох101С11сК(Коги1); 


У01А __Еаз®са11 ТЕГоги1:; : ГогиСгеа®е (ТОЮ)есе *5епаег) 
{ | | 
// регистрация формы как приемника файлов 
РгадАссер%*Е11е$ (Напа1е, Тгае); 


\01А __Газ®са11 ТГоги]1 : : ГогиОезегоу (ТОр)]ес® *5епаег) 


{ 
РгачАссер®Е11е$ (НапЯ1е, Га15е); 


\01А _ Еаз®са11 ТГогм1 : :11$©Вох10Ю1С11сКк (ТОр]есе *5епаег) 
{ 
// открытие файла 
Апз15Ег1па ехе; 
ехЕ = ГомегСазе (Ех гасеЕ11еЕхе ( 
| Т1$6Вох1->Т%епз->56г1п9$ [1$ЕВох1->ТеешТпаех])); 
1Е ((ехЕ == ".6хе") || (ехЕ == ".г6Е")) 
{ 
В1срЕа1*1->.1пез->ГоааЕгопЕ11е ( 
11 5ЕВох1->1Еемз$->5Ег1па$ [11$&Вох1->Т$ештТпаех]); 
Тпаде1->Нзае (); 
В1срЕа11->5Вом (); 
} 
е1 зе 
1ЁЕ (ехЕ == ".Бпр") 
{ 
Тпаче1->Р1сёаге->оааЕгопЕ1 1е (' 
115ЕВох1->Тем$->5{г1па$ [Ъ1$ЕВох1->ТеешТпаех]); 
В1срЕа11->Н1ае (); —. 
Тпааче1->5Бом (); 
} 
е1зе 
{ | 
5Ре11Ехесиее (Напа1е, МОТ, 
Ь1$&Вох1->Т%ем$->5%г1п9$ [11$Вох1->ТкешТпаех].с_56г(), 
МОБЬ, МОБЦ, ЗИ_ВЕЗТОВЕ); 
В1свЕа1*1->Наае (); 
Тпаче1->Н1ае (); 
} 
} 


Вероятно, особых комментариев этот код не требует. В описание класса 
введен обработчик сообщения \УМ_РОКОРЕП.ЕЗ. В обработчике сообщения 
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сначала функция ОгаОчцчегуЕПе вызывается со значением Е|ешдех равным 
ОхРЕЕЕЕЕЕЕ. В итоге возвращается число перетащенных файлов, которое за- 
носится в переменную Соипф. А затем в цикле вызывается функция Огай- 
ОпегуЕПе для каждого файла и его имя заносится в список 11$&Вох1. Затем 
система извещается функцией ОгайЕР1ш15В об окончании перетаскивания. 
И следует обращение к функции 115 Вох1ХЫСИсК — обработчику двойного 
щелчка на списке 11$ Вох1. Этот обработчик в зависимости от расширения вы- 
бранного пользователем файла загружает его в компонент В1леВ ЕЯ], или 
Гпасе1, или открывает функцией 5ЭвеПЕхесще. 

В обработчике события ОпСгеже формы записан вызов функции Огас- 
Ассер Ее, регистрирующий форму как приемник файлов. А в обработчике 
события Оп)е$гоу формы записан вызов функции ОгагАссер% Е 1е$, снимаю- 
щий форму с регистрации. 


6.12 Ярлыки файлов 


Ярлык является объектом СОМ класса СЕЗТО_$ЗвеШАиК с интерфейсом 
Т5Ве ик. В этом интерфейсе определены следующие основные методы, спе- 
цифичные для ярлыков (более полный перечень методов вы найдете в гл. 8): 


НКЕЗОТТ ЗТОМЕТНОРСАТТТУРЕ Се! Агхишеп4е(_ | 
Т5НЕЦТМК ЕАВ *р56Пок, ЕРУТВ, р$2Аг2$, 11% сс&МахРай); _ | 
Возвращает в буфер рз2Агй$ размером сев МахРа&В аргументы командной стро-_ 


ки при вызове файла, связанного с ярлыком. 


ВЕЗОТГТ 5ТОМЕТНООСАГГТУРЕ СеОезегриоп( 
Т5НЕСМАМК РАВ *р5Пэк, ГРТВ р$72Мате, 11% сс МахМаше . 


Возвращает в буфер р52Маше размером сс. МахМаше описание ярлыка. 


НВЕЗОГТ ЗТОМЕТНООСАГ,ТУРЕ Се{Но{Кеу(Т5НЕГТЛМК КЕАВ, «рвал, | 
У\’ОВО *руНо\Кеу); 


Возвращает в руНо{Кеу горячие клавиши. 


НВКЕЗОТГТ ЗТОМЕТНОРСАГТТУРЕ Сера $ вешилик ЕАВ #р5ытак, 
ТГРУТВ рз2ЕПе, шё сс МахРа, \1П\32_ЕП\МО_РАТА *р{!а, ОУ\УОКО {Е 15$); . 


‚ Возвращает в буфер рз2ЕЦ1е размера сеВМахРа В путь и имя файла, связанного. 
с ярлыком. В структуру р#4 типа Т\шт3З2ЕшаОа%а заносит информацию об 
объекте (файле или папке), связанном с ярлыком. Е 1а5$ — сочетание флагов, 
определяющих вид возвращаемого имени файла: ЗЭГО@Р_ЗНОКТРАТН — фор- . 
мат 8.3, Э.СР_ОМСРЕТОВТТУ — формат пути ОМС (Отзуегза1 Машше Сопуеп-. 
Я оп). | 


НКЕЗОГТ ЗТОМЕТНООСАТТТУРЕ СеёЗвомСша( | 
Т5НЕГЦЫМК РАВ *р5 Так, шф *р15ВомСп9); — 


Возвращает в риЗВомСщтА вид, в котором открывается окно файла: 
5\_5НО\/МОВМАГ, 5\_МАХТМТЕИЕ и т.п. 


НВЕЗОГТ 5ТОМЕТНООСАГЕТУРЕ бе \УогктеТтестогу $ НЕТЛАЛМК РАВ. 
*рэ Тик, ГРЭТВ р$201г, шё сс МахРа{ И); .: 


Возвращает в буфер р$20!г размера сс МахРа рабочий каталог открываемо- 
| го файла. —_ 
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НВЕЗОГТ ТОМЕТНООСАТ ТУРЕ бе: АгкшпешзИЗНЕГЛАКК. РАВ 
| *рэвПлпКк, ЕРСЗТВ р$2Аг5$); 


Задает ‘аргументы командной строки при вызове файла, связанного с ярлыком. | 


НВЕЗОТТ УТРМЕТНОРСАНЕТУРЕ Зе{ОезспрИиоп (5 НЕГМЛ/МК ЕАБ | 
рэ ШК, СРСЗТВ р$2Мащте); 


Задает описание ярлыка. = | оо ВОВ 


| 
| 


ТЗНЕНМАМК РАВ *р5ВИлк, ГРСЗТВ рз2ЕПе); . 
Задает пу путь и имя файла, связанного с ярлыком. с В. 


НВЕЗОГТ ЭТОМЕТНОРСАГГТУРЕ ЗеЗпо\Сша( 
ТЗНЕСММИЛМК ЕАВ *р5Ь Пак, ни 15ВомСпа9д); |. 


Задает вид, в котором открывается окно файла: 53\_5НОММОВМАГ, 
3 \’_МАХЕТМТЕИЕ и т.п. 


ИИ АОИ — 


НВЕЗОТТ $ТЬМЕТНООСАГЕТУРЕ Зе \\огктеГгесвогу( — | 
Т5НЕССЫМК ЕАВ*р5 В ПлэоК, ЕРСЗТВ р$201:); 


| Задает рабочий каталог открываемого файла. | 


Все перечисленные методы возвращают в случае успеха значение 
МОЕВВОК. 

Методы с префиксом "Сеф” дают возможность получить информацию о ка- 
ком-то существующем ярлыке. А методы с префиксом "Б5еф” позволяют изме- 
нить свойства существующего ярлыка или создать новый ярлык. 

Посмотрим, как все это можно применить на практике. Ниже приведен 
пример функции, создающей ярлык. В нее передаются следующие параметры: 


Ра ОБ} Имя файла или папки, с которой связывается создаваемый ярлык. 


У\У’огЕОг Рабочий каталог ‘файла, связанного с ярлыком. 
Ра В ИшкК 


Резсг1рИоп |Описание ‚ ярлыка. 


Папка, в которую помещается файл ярлыка. 


| 
плите ай 


Аггитеп{$ | Строка параметров командной строки при вызове > файла. 


Зво\Сша 


Вид окна, в котором отображается вызванный файл. 


Функция создает ярлык, связанный с файлом или папкой Раё ВО}, уста- 
навливает его свойства и сохраняет в папке Рай ИГликК. Вот код этой функции: 


И/#1тс1иае <ус1.6> 
#10с1иае <$561о57.6> 


у01А Сгеафеь1пкК (Апз156г1па РаеВОЬЗ, Апз15% г: па Могкр1к, 
Ап$156г1па РаерЬ1пк, Ап515ег1па Резсг1ретоп, 
Ап$156х1па Агаимепе$, 1п6е бпомСма) 


НВЕЗОГТ ЙРгебз; 
Т5Ве111пКк *МемЬлок; 
Со1п1*1а1127е (мМ0Т1); 
Югез = СоСгеаееТпзапсе (СЬ5Тр_$5пе11т1пк, МОБГ, 
СЬ5СТХ_ТМРВОС ЗЕВУЕК, ТТР 1$6е11Ь1рКк, (уоза **) &МемЬ1пК); 
1Е (ЗОССЕЕОЕО (Вгез) ) 
{ 
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Мемр1пк->5еЕРаей (Рае ПОЮ) .с_з6г()); 
Мер 1ик->5еЕМогк1пар1кесеоку (ИогКО1к.с 5х ()); 
МемЬ1пк->5еРезск1ретоп (Резсг1ре1оп.с _$6г()); 
МемГ1пк->5есАгдимепе$ (Агдитеп* $.с_$з%к()); 
МемЬ1пк->5ее5помСма (5помСма); 
ТРегз1$6Е11]е *ррЕЁ; 
МемЪ1пк->Оцегу1ТпеегЕасе (ТТР_ ТРег$1$%Е11е, (уо01а**) &ррЕ); 
ррЕ->5ауе (ИМ1лаебег1па (Рае ППК), %гие); 

. | 


Со0п1п1Е1а117е(); 


} 


Директива #теа4е подключает файл 31106/.й, в котором объявлен интер- 
фейс ТЗвВеПТлик. Обратите внимание на то, что при этом надо убрать включае- 
мую по умолчанию директиву, подключающую файл ос[.й. Иначе возникают 
многочисленные замечания о дублировании объявлений в разных файлах. 

Функция СопиЯаЙте инициализирует СОМ-библиотеку. Следующий вы- 
полняемый оператор создает функцией СоСгежфештзапсе объект МемТлик. 
Данная функция объявлена в файле обфазе.й следующим образом: 

ИТМОТЕАРТ СоСгеасеТпзфапсе (ТМ ВЕЕСЬУТЬ с1о5еа, 


ТМ БГРОМКМОММ рОпкоОофет, ТМ РМОВР ЧмС1$Сопфехф, - 
ТМ ВЕЕТТО г114а, ООТ ГРУОТР ГАВ* рру); 


Данная функция создает и инициализирует объект класса и возвращает 
указатель на интерфейс рру. В параметр ге]514 типа КЕЕСТ.5ТО передается 
идентификатор класса. В нашем примере это класс ярлыка СЕТ ЗвеШапк. 
Если в параметр рОпКОщег передается МОТ, то объект создается не как часть 
множества объектов класса, что и требуется в данном примере. Параметр гиа 
определяет интерфейс, который используется для соединения с объектом. 

Далее, используя приведенные выше методы интерфейса 15$ Велик, мож- 
но задать свойства объекта. После этого объект надо сохранить в виде файла на 
диске. Для этого надо обращаться к объекту как к объекту интерфейса 
ТРегз15 ЕПе. При этом нужно воспользоваться методом @иегуПцщегРасе, кото- 
рый возвращает указатель на указанный интерфейс, если объект поддержива- 
ет этот интерфейс. Интерфейс ТРег$1${ЕПе имеет метод Зауе, объявленный 
следующим образом: 


НВЕЗОЬТ бауе (ТРСОЪЕЗТВ р5з2Е11еМаще, ВОО ЕВепепЬег); 


Первый аргумент этого метода указывает имя файла, в котором сохраняет- 
ся объект. Значение второго аргумента &ёгие означает сохранение копии файла, 
если файл с таким именем уже имеется. При значении {Вететфег = Ёа]5е созда- 
ется новый файл, а если уже был файл с таким именем, то он уничтожается. 

Теперь рассмотрим более развернутый пример, имеющийся на приложен- 
ном к книге диске в каталоге ЕЦез в проекте РпЁ. Правда, этот проект не реа- 
лизован для С++ВоаПаег 2006. Дело в том, что и в С++Ви!Паег 6 пришлось ус- 
ложнять код проекта, чтобы избежать уже упоминавшегося выше дублирова- 
ния объявлений в библиотечных файлах С++ВиПаег. В С++Ви!аег 2006 эта 
проблема стала еще острее, и я решил не запутывать проект многочисленными 
и непринципиальными усложнениями. 

Окно приложения РШпЕ во время выполнения показано на рис. 6.15. 
Верхняя панель окна обеспечивает создание ярлыка, связанного с указанным 
файлом и папкой. Имя файла или папки заносится в окно редактирования 
Файл, папка (его имя в коде приложения ЕЯ). Если текст в этом окне отсутст- 
вует, создается ярлык данного приложения РИпА. Занести имя файла в окно 
Файл, папка можно с помощью кнопки Найти файл (имя ВЕШЯЧЕЦе), открываю- 
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щей стандартный диалог поиска файла. Если создается ярлык папки, удобнее 
воспользоваться кнопкой Найти папку (имя ВЕШЯЕо4ег), которая открывает 
диалог выбора папки. 


Рис. 6.15 = Формирование и чтение ярлыков —^ 
Приложение РИпк = Создание ярлыка ————————- НИИ 


во время выполнения ФАЙЛ папка 
[АТ еЕ хатр\ СВ иЧег Найти файл... | Найти папку... о 


Куда поместить г Окно 


[7\ТечЕхатр\СВийе" Найти папку. ‚© Обычный размер окна. 


: {° Свернчтое в значок 


Описание ярлыка !. ‹ | 
| г. 
[ярлык РИиК.ехе Создать | ] С` Развернутое на весь зкран , 


== ——-- 


Информация о ярлыке —— тете тете ттт сттеетто сте 
' Файл ярлыка 


[РУ езЕ хатр\ СВ иде! Найти ярльк.| 


Ярлык - Е:\ТеяЕ хатр\ СВ и/дег\СВйде 6 \РИиК\РИикК.ехе ИК 

Связан с объектом - [:\ТезЕ хатр\СВийдег\СВийде 6 \РИик\РИикК. ее 
Описание - ярлык РИиК.ехе 

Рабочий каталог - Е:\Те&Е хатр`СВийдег\СВийдег6\РИик\ 

Аргументы отсчтствуют 

Горячие клавиши не назначены 

Обычный размер окна 


В окно Куда поместить (Е 94) заносится путь к папке, в которую надо по- 
местить ярлык. Если это окно не заполнено, то ярлык помещается в ту же пап- 
ку, в которой расположен связанный с ним файл. Заполнить окно ЕЯ Ц 4 можно 
с помощью расположенной рядом кнопки Найти папку (ВЕш@Ео!4ег2). Эта 
кнопка открывает диалог выбора папки, аналогичный рассмотренным 
в разд. 6.5. Пользователь может выбрать в этом диалоге любой каталог, или 
такие виртуальные папки, как "Рабочий стол". При выборе этой папки ярлык 
будет занесен непосредственно на рабочий стол. 

Группа радиокнопок Окно позволяет задать вид, в котором откроется окно 
файла, связанного с ярлыком. Кнопка Создать (ВСгеафе) создает указанный 
пользователем ярлык. | 

Нижняя панель окна приложения обеспечивает получение информации 
о любом файле ярлыка, указанном пользователем. Эта часть приложения при- 
звана показать методику получения информации об уже имеющихся ярлыках. 
В окно Файл ярлыка (ЕЯ ЁЗ) заносится путь к файлу ярлыка, о котором требует- 
ся получить информацию. Для этого можно использовать кнопку Найти ярлык 
(ВЕшаГлК), открывающую диалог выбора файла. Кнопка Информация (ВТ) 
соединяется с указанным файлом ярлыка и заносит в окно ВаевЕЧЁ1 инфор- 
мацию о его свойствах, которую вы можете видеть на рис. 6.15. 

Ниже приведен код этого приложения. 

В данном приложении функции СгеавеТГлиК и шШЁлиК вынесены в отдель- 
ный модуль ИМтАТтр. Заголовочный файл ИШтЕТтр.А этого модуля имеет 
вид: 

#1Е0аеЕ ОЬ1пКТирн 


#аеЁ1пе 011пКТирн 
Инн -----------==----------=--- 
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#1пс1а4е <зузеем.Врр> 
#1пс1аае <СомСЕг1$.Прр> 
\У01Я Сгеабер1пкК (Ап515Ег1лпа РаЕПОБ],Ап$15Ег1па ИогКкКр1к, 


Ап$15г1па РаерГ1пк, Ап$15Ег1па Безсг1ретоп, 


Ап$156г1па Агаамеп®$,1пе 5ромСпма); 
Ап$156г1па ТпЕГапкК(Ап$156г1па Ра®П); 


фепа1Е 


Файл ИМпЕТтр.срр содержит реализацию функций: 


#1пс1аае <$61о057.8> 
уо1А СгеабетТ1пКк (Ап$156х1па Рае ВОЮ),Ап$15Ег1па МогКкО]1г, 


Ап$15Ег1па РаепЬапк, Ап$15ег1па Резск1рё1оп, 


Ап515Ег1па Агаатмеп®$,1пе бПомСпма) 
{ 
НВЕЗОГШТ Вгез; 
Т5Ве11Ь1пк *Мем1роКк; 
Со1п1Е1а1127е (№011); 
Нгез = СоСгеа&е1пз®апсе (СЬ5ТО_ 5Ве11Ъ1вк, МОБ, 


СЪЗСТХ ТМРВОС ЗЕВУЕВ, ТТр_Т5Ве11т1пк, 


(Уо1аА **) &МемЬ1пК); 

1Е (ЗОССЕЕРЕР (Вге$)) 

{ 
Меир 1пКкК->5бееРаеп (Ра®ВОЪ) .с_$%к()); 
МемЬапкК- >5еМогк1пар1кесвогу (Могкр1к. С зе ()); 
МемЬ1пк->бесрезси1ретоп (Резсг1рё1оп. с 3% ()); 
Меир 1пк->5есАгаимепез$ (Агдимепе $ .с_ 36: ()); 
Мем11пк->5е-бпомСма (5ВомСма); 
ТРег51$Е11е *ррЕ; 


МемЪ1пКк->ОцегуТпеегЕасе (ТТР_ТРег51$%Е11е, (\уо0о1а**) &ррЕЁ); 


ррЕ->бауе (И1аебег1па (Рае ПГ1пК), &гае); 
} 


Со/п11п1Е1а11#7е(); 


Ап$15Ег1па ТлЕБТПК (Ап$156г1па Раф) 
{ | 
Ап$156г1па $6; 
Т5$Ве11Ь1пКк *Глпк; 
сраг $[255]; 
_№1№М32_ЕТМО РАТА рЕа; 
ОИога ЕЕ1ааз; 

Мог НофкКеу; 

1пЕ бромСпа; 
ТРегз1$6Е1]е *ррЕ; 


Со1п1Е1а112е (МОТ); 
СоСгеафеТп$Фапсе (СЬЗТО $5Ве1111пКк, МОБ, 
СЪЗСТХ ТМРКОС 5ЕВКВУЕВ, ТТО 1$1е1111пк, 
(уо1ла **) &р1пК); 
Ъ1пк->ОцегутпеегЕасе (ТТ _ТРег$1$%Е11е; (\о1а**) &ррЕ); 


1Е (ррЕ->Ьоаа (И1Ае5®г1па (Раёп), Егае) == $_ОК) 
{ 

ЗЕг=ЗЕГ + ("Ярлык - " + Ра®В) + "\п"; 
Г1ок->СеЕРабВЬ ($, 256, &рЕа, ЕЕ1адз); 

$Ег=зег + "Связан с объектом - 
Т1пк->Сесрезсг1ретоп (5, 256); 


ЗЕГЕЗЕГ + "Описание - " +Апз1беклта (5) + "\п"; 
.1пк->СееИогКк1па)1гесеоку ($, 256); 
зЕг=зег + "Рабочий каталог - " + Ап$156г1па (5$) + "\п"; 


Г1пк->бебАгаатепе $ ($, 256); 
1 Е (5 | = "") 


"+ Ао$15е ела (5) + "\п"; 
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Ех = з6г +"Аргументы отсутствуют" + "\п"; 
е1зе зЕг = з6ёг + "Аргументы - " + Апз15бег1па (5$) + "\п"; 
Г1пк->СеЕеНоекеу (&Нобскеу); 
1Е (НофКеу == 0) 
$Ег=5Ег + "Горячие клавиши не назначены" + "\п"; 
е15е $зЕг = $з0г + "Горячие клавиши " + 
Апз15Ег1па (Ноекеу) + "\п"; 
Глок->беебромСма (&5РомСпта) ; 
5и1ЕсЬ ( 5РомСма) 
{ 
сазе 5М ЗНОММОВМАГ: зЕхг=зег + "Обычный размер окна"; 
Бгеак; | 
сазе 5М МАХТМТАЕ: зЕг=зек + 
"Окно развертывается на весь экран"; 
ЬгеаКк; 
сазе 5М ЗНОММТММОАСТТУЕ: зЕг=зЕг + 
"Окно свертывается в значок"; 


} 

} 
Со0п1111а117е(); 
тебсагп $61; 


} 


Основной модуль приложения реализован в файле ИШпЕ.срр: 


Уу01А _ Еаз®са11 ТКоги1: :Арр11сае1опЕуеп® $15 ПомН1п® ( 
Апз15Ег1па &Напе5Ег,роо1 &Сап5Бом, ТН1пЕТпЕо &НапЕТпЕо) 
{ 
1Е (Апз15ег1па (НапЕТпЕо.Н1пЕСоп*го1->С1аз$Маме ()) == "ТЕа1е") 
1Е (Гаре11->Сапуа$->ТехеИлаер ( | 
((ТЕаз Е *) Но ЕТрЕо.НлпеСопего1) ->Тех®)} > 
НтпеТпЕо.Н1пЕСопего1->С11еп И1лаей) 
{ 
НтпЕ5Ехк = ((ТЕЧлЕ *) НзпетТоЕо. НзпеСопего1) ->ТехЕ; 
Арр11сае1опЕуепе $1->Сапсе1р01зрафсЪ (); 


у01А _ Еаз®са11 ТГогм1: : ВЕ1лпаГо1Аег2С11сК (ТОБ]есе *5епаег) 
{ 
Ап$156кг1па О1г; 
1Е (Зе1ес®01гескоку ( 
"Выберите папку, в которую надо. поместить ярлык", "", Р1г)) 
Еа14->Техе = О1е; 


Апз15Ег1па 01; 
1Е (бе]есе)1гесбоку ( 
"Выберите папку, для которой создаете ярлык", "", РО1г)) 
{ 
Еа161->Техе = 01; = 
Еа1 Е 2->Техе "ярлык " + П1кг; 


уо1Аа _ Еаз®са11 ТГогм1: : ВЕ1пАГпКкС11ск (ТОБР)есЕ *5епаек) 
{ | 
1Е (Орепр1а1о92->Ехеси*е ()) 
Еа163->ТехЕ = Орепр)1а1оа2->Е11еМапе; 
} `_ 
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У01А _ Еазеса11 ТГоги1: :ВЕ1паРг11еС11сКк (ТОБ)]есе *5епаег) 
{ 
1Е (Орепр1а1То91->Ехесаее ()) 

{ 

Еа1$1->ТехЕ = Орепр1а1о391->Е11еМапе; 

Еа162->ТехЕ = "ярлык " + ЕхЕгас®Е11еМапе (Е 91 1->Тех®); 


У01А _ ЕазЕса11 ТЕоги1: : ВТпЕС11сК (ТОБ)есе *бепаег) 
{ 

В1свЕа161->С1еаг(); 
В1спЕа11->Г1пез->Ааа (ТпЕТапк (Еа1 $ 3->Техе)); 


У0о1А _ Еазеса11 ТГоги1 : :ВСгеа®еС11ск (ТОБ]есЕ *бепаег) 
-{ 
Ап5156г1па РаеРОБ), МогкКр1к, Рае ПТЪ1пк, ПБезск1ре1оп; 
1пе орпомСма; 


РаЕепОБ) = Тг1им(Еа161->Тех®); 
1Е (РаЕеВОБ] == "") 
Ра*пОБ-) = Рагам$\%г (0); 
ИогКкр1г = ЕхбсгасеЕ1]1еРаЪВ (Рае ВОБ)); 
Рае пЬ1пКкК = Туи1аи (Е а 1 4->Тех®); 


1Е ((Раббтлик != "") && 

(Рас рЪ1пК [ Рае пь1пК.ТепаеВ ()-1] != "АА" 
Ра ВЬапКк = РаебГлок + "\\"; | 
Раерр1пк = РаебЪ1пКк + ЕхегасЕЕ11еМате (Ра Вор) + ".1пк"; 


Резсг1рЕ1оп = Тг1и (Еа162->Тех®); 

1Е (Резск1резоп == "" ) 

Резсг1ре1топ = "ярлык " + Ехегас®Е11еМапще (Ра РОЪ7); 

$м1Еср (Ваа1оСгоир1->ТЕетТпаех) 

{ . 

сазе 0: $ПомСма = $М_ ЗНОММОВМАГ; 
Бгеак; 

сазе 1: $ПпомСма = $М ЗНОММТММОАСТТУЕ; 
Бгеак; 

сазе 2: 5$ПомСша = 5М ЗНОММАХТМТАЕО; 


} 
Сгеасер1пКк (Ра БОБ], МогКР1к, Рае ПЬлпКк, ПБезсг1ре1оп, "", 
ЗРомСма) ; 


} 


Как говорилось ранее, и как видно из приведенного выше кода, функции 
Стеа&еГлиК и шШЕлпК вынесены в отдельный модуль. Это связано с тем, что 
для использования интерфейса ТГЗве лик надо подключать модуль 3106].Л. 
Никаких проблем в С++Ви!аег 6 с этим не возникает, пока в модуль не доба- 
вится файл Па1юЕз.йрр, который подключается автоматически при добавлении 
на форму компонента ОрепО1а10=. Тут-то и возникают мультиобъявления 
и компилятор выдает множество ошибок. Бороться с ними можно указанным 
разделением кода. Тогда модуль 3й106/.й подключается только к модулю 
ОлпЕТтр, а файл Плаю83.йрр подключается к основному модулю ИШпА. Кон- 
фликты исчезают. Подобный прием, пожалуй, является наиболее универсаль- 
ным при разрешении конфликтов между библиотечными модулями. 

В заголовочном файле ОШпЁТтр.й подключаются требуемые файлы зи3- 
{ет.йрр и СотСН\Вз.Йрр, которые необходимы для данного модуля. 

Функция Сгез&еТлтК, создающая файл ярлыка, уже была описана выше 
и повторяется тут, чтобы легче было ориентироваться в коде. Функция 
ПЕ ТапК читает информацию из файла ярлыка, имя которого передано через 
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параметр Ра. Так же как в функции СгезжеГМшК, первые выполняемые опе- 
раторы инициализируют СОМ-библиотеку и создают объект ШиК интерфейса 
Т5ве|Тлок. Далее следует обращение к этому объекту как к объекту интерфей- 
са ТРег$1$ {Е Пе, что также делалось в процедуре СгезфеТлиК. Но в данном слу- 
чае вызывается метод Г.оа4 этого объекта, который загружает в него файл. Ме- 
тод объявлен следующим образом: 


НВЕЗОГТ Тоаа (ГРСОЬЕЗТВ рз2Е11еМматме, ОМОКОР амМоае); 


Параметр р52ЕПеМате — это имя загружаемого файла. Параметр 4мМоде 
является комбинацией флагов, определяющих доступ к файлу: для чтения, за- 
писи и т.п. Значение 0 соответствует режиму доступа по умолчанию. А различ- 
ные флаги вы можете посмотреть в справке И’2т32.Шр в теме “ЭТ@М`. 

Метод Гоа возвращает значение 5_ОК,, если файл благополучно открылся. 
В этом случае код процедуры применяет описанные ранее методы Т5ВеШаик 
для чтения информации и занесении соответствующих строк в окно ВлевЕЧИТ. 

Данная функция только читает информацию и возвращает строку типа 
'Ап$15{гшх, которая в основной программе заносится в Вас в ЕЯИТ методом 
ААА. Также вы можете изменять эту информацию, как это делается в функции 
СгтезжеГ лик. 

Мы рассмотрели две основные процедуры приложения. Остальные проце- 
дуры вспомогательные. Процедура ВСгеа&еСИск — обработчик щелчка на 
кнопке Создать. Она проводит чисто технические преобразования введенных 
пользователем текстов. Анализ состояния группы радиокнопок КаФ1юоСгоир1 
позволяет задать режим показа окна файла Эво\Ст94. Для варианта Свернутое 
в значок задается значение 5\_5НОММТММОАСТТУЕ, открывающее файл 
в свернутом виде и не передающее ему фокус. После подготовки всех данных 
вызывается описанная ранее процедура СгезафеГлиК, создающая ярлык. 

Процедура ВЁСИсК — обработчик щелчка на кнопке Информация. Она 
просто вызывает рассмотренную ранее процедуру ПиЕТлаикК, передавая в нее имя 
файла, записанное пользователем в окне Е9ЩЗ. Процедуры ВЕШАЕ!еСНск 
и ВЕШАаГоКСПек — обработчики щелчков на кнопках Найти файл и Найти яр- 
лык, ОТКрывающие стандартные диалоги поиска файлов. Процедуры ВЕт9- 
Ро]!ЧегСПсКк и ВЕш@9Ео]4дег2СПеК — обработчики щелчков на кнопках Найти 
’ папку. Они используют функцию Э@ес П1гесфогу, в которую в качестве второго 
аргумента передается пустая строка. Это обеспечивает отображение все папок 
компьютера, как каталогов, так и виртуальных папок типа "Рабочий стол”. 

Таким образом, мы рассмотрели все операции с ярлыками: их создание, 
чтение свойств, а с учетом сделанных выше замечаний — и изменение свойств. 


6.13 Запоминание в файлах состояния 
компонентов и форм 


Во многих приложениях желательно запоминать текущее состояние ка- 
ких-то компонентов или целиком формы, чтобы в последующем сеансе работы 
с этим приложением пользователь сразу увидел компоненты или всю форму 
в том состоянии, в котором он их оставил в конце предыдущего сеанса. Это по- 
зволяет, например, сразу продолжить работу с документом, открытым в окне 
редактирования в прошлом сеансе работы. А если форма предусматривает воз- 
можность какой-то настройки со стороны пользователя (выбор шрифта, пере- 
строение компонентов и т.п.), то желательно, чтобы в новом сеансе все эти на- 
стройки сохранились. 
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Подобные возможности можно реализовать различными путями. Пожа- 
луй, наиболее простой из них — записать в конце сеанса состояние компонен- 
та или всей формы в файл на диске, а в начале сеанса прочитать этот файл. 
Все это несложно сделать с помощью потоков. 

Начнем с простого примера сохранения состояния одного компонента. 
Пусть в приложении имеется окно редактирования Мето1, в котором пользо- 
ватель может писать некоторый текст. Имеются также кнопки или разделы 
меню, позволяющие пользователю изменять шрифт текста в окне. Реализова- 
на возможность перемещения окна и изменения его размеров (см. разд. 5.2.4). 
Мы хотим, чтобы в начале очередного сеанса работы с приложением окно от- 
крывалось с тем текстом, с тем форматированием, с тем положением и разме- 
рами, которые были в момент окончания предыдущего сеанса. 

Это можно сделать следующим образом. В обработчик события ОпС]озе 
формы вставьте следующий текст: 


ТЕ11ебегеам *Ез = пем ТЕ11ебегеап ("Мето.аа®*", ЕтСгеаке); 
Е5->Иг1 с еСотропепеЕ (Мемо1); | 
Че1ефе.Ез; 


Первый из приведенных операторов создает в памяти поток Е$ класса 
ТЕЦез{геат, связанный с файлом Мето.ааф, открытым для записи. Следую- 
щий оператор записывает методом УгЦеСотропеп{ в этот файл информацию 
о компоненте Мето1. Последний оператор удаляет объект потока. 

Таким образом, при закрытии формы приложения создается файл 
Мето.аа+, в котором в двоичном виде сохраняется информация о компоненте 
Мето1. Теперь надо организовать чтение этого файла в момент открытия при- 
ложения. Для этого в обработчик события ОпСгезже формы вставьте текст: 


12 (Е11еЕх15$0$ ("Мепо.ааф")) 
{ 


ТЕ1]ебегеам *Е5 = пем ТЕ11ебегеамп ("Мепо.Ча®", ЕтОрепВеаа); 
Е5->ВеаАСотропеп® (Мето1); 
Че1ефе Гз; 


} 


Если имеется файл Мето.4аф, то создается поток Е$, открывающий файл 
для чтения. Далее из этого файла информация методом ВеадСотропеп& чита- 
ется в компонент Мето1{. Затем временный объект Е$ уничтожается. 

Создав подобное приложение, вы сможете убедиться, что при каждом его 
запуске состояние окна Мето1, включая отображаемый в нем текст, будет та- 
ким, каким оно было в момент окончания предыдущего сеанса работы. 

В приведенном примере информация сохранялась в файле в двоичном 
виде. Иногда удобнее хранить эту информацию в текстовом виде. В этом слу- 
чае файл можно открыть и посмотреть в любом текстовом редакторе, а при же- 
лании можно и отредактировать. 

В С++Ви!Цаег имеются функции ОБес ВтагуТоТехв и ОЩесТех{ГоВтагу, 
первая из которых переводит двоичное представление объекта в текстовое, 
а вторая переводит текстовое представление в двоичное. Первым аргументом 
функций задается объект потока, в котором содержится исходное описание 
объекта, а вторым аргументом задается поток, в который записывается ре- 
зультат преобразования. | 

Для запоминания информации в текстовом файле приведенный ранее об- 
работчик события Оп(С]1о5е формы надо переписать следующим образом: 

ТМепогузегеам *М5 пем ТМетогу5еЕгеам(); 


М$->ИглкеСоптропеп® (Мемо1); 
ТЕ1]ебёгеам *Ез = пем ТЕР11ебЕкеап ("Мепо.ЕхЕ", ЕмСгеафе); 
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Мз->Ро$1Е1оп = 0; 

ОБ] есЕВ1пакуТоТех® (М$, Е5); 
ае1ефе Гз; 

ае1ефе М$; 


В этом коде информация о компоненте Мето1{ заносится методом 
У\УгЦеСотропеп в поток М$ класса ТМетогу{геат. Затем создается поток 
Е5, связанный с файлом Мето.1хт. Позиция потока М$ устанавливается на на- 
чало, после чего вызывается функция ОесВтагуТоТехё. Источником ука- 
зывается поток М$, а приемником — поток Е$. В результате в файл Мето.1хт 
заносится описание компонента в текстовом виде. Затем временные объекты 
потоков Е5$ и М$ уничтожаются. 

Чтобы использовать файл, содержащий текстовое описание компонента, 
обработчик события ОпСгеажфе формы надо переписать следующим образом: 


1Е (Е11еЕх156$ ("Мемо.6хё")) 
{ 


ТЕ1]е5егеам *Е5 = пем ТЕ11]ебегеам ("Мемо. хе", ЕтОрепВеаа); 
ТМепогуз©геам* М5 = пем ТМетогусегеап(); 
Ор]есеТехсТоВ1паку (Е$, М5); 

Мз->Ро$1Е1оп = 0; 

Мз->КеаАСопропепЕ (Мемо1); 

Че1ефе ЕГз$; 

Че1ефе М$; 


} 


В этом коде создается поток Е$, читающий информацию из файла 
Мето.хЕ. Затем создается в памяти поток М$. Функцией ОБесёТех{ТоВтагу 
текстовая информация потока Е$ переводится в двоичную информацию, зано- 
симую в поток М$. Позиция потока М$ переводится на начало, и информация 
из этого потока записывается методом ВеаЯСотропепё в компонент Мето]. 
В заключение объекты потоков Е$ и М$ уничтожаются. 

Теперь рассмотрим применение тех же приемов для сохранения состояния 
всех компонентов на форме и состояния самой формы. Это приложение 
баеРогт в каталоге Гогтз на приложенном к книге диске. Вид приложения 
во время выполнения показан на рис. 6.16. Форма содержит окна редактиро- 
вания Мето1, Е9Ц1, Мето2 (это окно внизу формы на рис. 6.16 а, в котором 
написано пояснение для пользователя). Для этих окон предусмотрено контек- 
стное меню с разделами Шрифт, Изменяемый размер (имя этого раздела в приво- 
димом далее коде М$12е, Перемещаемое окно (имя раздела ММоуе). Эти разде- 
лы позволяют соответственно изменять размеры окон (см. разд. 5.2.4), переме- 
щать их и выбирать шрифт текста. Остальные компоненты формы — группа 
радиокнопок Ва41ю0юСгойпр1, индикатор СпвесКВох1, выпадающий список 
СошБоВох1 введены. в приложение просто для того, чтобы продемонстриро- 
вать запоминание состояния этих компонентов. Для разделов М$12е и ММоуе 
свойство АщоСВесК установлено в фгие, чтобы состояние СЪесКе4 этих разде- 
лов изменялось при каждом щелчке на них пользователя. 

Главное меню формы содержит меню Сохранять с подразделами Текущее со- 
стояние (имя раздела в приводимом далее коде МСиггепф), Предыдущее состояние 
(имя МРгеу), Состояние по умолчанию (имя МОе?аи). Для всех этих разделов 
свойство АишфоСКесК установлено в фгие, свойство Сгопрм4ех задано рав- 
ным 1, свойство Ва юоЦет установлено в фгое, и в разделе МСиггеп+ свойство 
СресКе4 равно фгие. Таким образом, эти разделы работают как группа радио- 
кнопок — активным может быть только один из этих разделов. 
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Рис. 6.16 
Приложение в состоянии по умолчанию (а)+и перестроенное пользователем (6) 


В исходном состоянии активным является раздел МСиггепф. Это значит, 
что в файле на диске будет сохраняться текущее состояние формы и всех 
ее компонентов. Тогда при следующем запуске приложения форма и все 
ее компоненты окажутся в том состоянии, в котором они были в момент за- 
крытия приложения. На рис. 6.16 б показано перестроенное пользователем 
окно приложения: изменены тексты и шрифты окон Мепто] и ЕЧИТ, все окна 
передвинуты, их размеры также изменены, изменен размер самой формы. Все 
эти настройки сохраняются в файле, так что при следующем запуске приложе- 
ния пользователь увидит приложение в том состоянии, в котором оно запом- 
нилось. Восстановится раскладка компонентов на форме, тексты окон редак- 
тирования, состояние радиокнопок, индикатора, выпадающего списка, размер 
и положение формы. Запомнится даже то, какой компонент был в фокусе. 
Если пользователь перед тем, как сохранить форму, выбрал в главном 
меню раздел Предыдущее состояние, то текущее состояние не сохранится и в сле- 
дующий раз приложение откроется в том же состоянии, в котором оно откры- 
лось ранее. А если пользователь перед тем, как сохранить форму, выбрал в 
главном меню раздел Состояние по умолчанию, то в следующий раз приложение 
откроется с установками по умолчанию, т.е. в виде, показанном на рис. 6.16ба. 
Ниже приведен код этого приложения. 


у0о1а _ Еазеса11 ТКогм1::ГогиС1озе (ТОр)есе *5епаег, 
ТС1озеАсЕ1оп &АсЕ1оп) 


1Е (МСоггхепЕ->СфескКея) 

{ 

ТЕР1]ебегеай *Е5з = пем ТЕ11ебегеап ("СагхепеРГогп.Аа®", ЕшСгеаее); 
Ез->Иг1 Е еСотропеп® (1101$); 

Че1ееёе Еб; ° 
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е1зе 1Е (Мреёап1+->СрескКеяа) 
1Е (Е11еЕх1 56$ ("СаггепЕГоги.Аа®")) 
Ре1ефеЁ11е ("СиггхепЕГогм.Аа®"); 


} 
// 


У01А _ Еаз®са11 ТРГогш1:; : ГогмСгеафе (ТОр)]ес®е *5епаег) 


{ 


1Е (Е11еЕх150$ ("СаггепЕЕогм.Аа*")) 


{ 


Бог (106 1 = 0; СотропепЕСочпе > 0; 1++) 


$115->Сомропепе$ [0] ->Егее (); 
ТЕ1]ебегеам *Ез$ = пем ТЕ11ебегеам ("СаггепЕРогм.Ча®", ЕтОрепВеаа); 


Ез->ВеаАСотропеп® (61$); 


Ае1ефе ЁЕз; 
о 
} 
тк 
уо1А __Еазеса11 ТЕогм1: :М512еС11сК (ТОБ)]есе *5епаекг) 


{ 


// обработка раздела меню "Изменяемый размер" 
НИМР Н = ( (Т\М1пСопего1 %*) РорирМепоа1->РорирСотропеп®) ->Напа1е; 
ОМС 01а$6у1е = беЕ\М1паомТопа (Н, СИ 5ТУЬЕ); 
1Е (М5$12е->Срес*еа) | 
{ 
// установка стиля И$ ТНТСКЕКАМЕ 
зееИ1паомЬопа (Н, СМЬ 5ТУЬЕ, 01а5%у1е | М5 ТНТСКЕВАМЕ); 


((ТСопЕго1 *) РорирМепоа1->РорарСопропеп*) ->Тадз = 1; 
} 


е1 зе 

{ . 
// удаление стиля И$ ТНТСКЕКАМЕ 
зееМ1паомЪопа (Н, СИГ _5ТУЬЕ, 01а5%у1е & - М5 ТНТСКЕВАМЕ); 
((ТСопего1 *) РорирМепа1->РорирСотропеп+) ->Тадз = 0; 

} 


// перерисовка окна с новым стилем бордюра 
бЗеЕИ1паАомРоз (Н, О, О0, 0, 0, 0, ЗИР_ЕКАМЕСНАМСЕРО | СИР _МОМОУЕ | 


ЗИР_МО$ТАЕ | 5МР_ МО2ОВРЕВК); 


} 
им 
014 _ Еаз®са11 ТРГоги1:; :ММоуеС11ск (ТОБ]есе *5епаег) 
{ 

// обработка раздела меню "Перемещаемое окно" 

1Е (ММоуе->СБескКеа) 

((ТСопЕго1 *) РорирМепа1->РорирСотропеп®) ->Сигзог = сг517еА11; 


е1зе ((ТСопего1 *) РорирМепа1->РорирСоптропеп®) ->Сигзог = 
сгреЕат1{; 


} 


у | 
Уу01А __Еаз®са11 ТГогм1 : : Е а1*1Моцзеромт (ТОр)]есе *5епаег, 


ТМочзеВвВае оп Ваефоп,. 
ТРЕЕ бЕаее $УЬ1ЕЕ, 
106 Х, 1106 У) 
{ 
// обработчик события ОпМоизероип всех компонентов 
1Е(((ТСопЕго1 *)епаехг) ->Сагзогк == сг517еА11) 
{ 
Ве1еазеСареаге (); 
((ТСопЕго1 *) беп4егк) ->РегЕогм (ИМ ЗУЗСОММАМО, 0хЕО12, 0); 
} 
} 
ЪБуи 
уо1Аа _ _Еаз®са11 ТГогм1 ; :АКоп®Ехесафе (ТОБ}]ес® *5бепаег) 


{ 
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// выбор шрифта окна редактирования 
Гопе21а1о91->ЕГопе->Аззтат ( 
((ТМемо *) (РорирМепа1->РорирСстропеп®) ) ->ГопЁ); 
Е (РГопе01а1031->Ехесиее ()) 
((ТМемо *) (РорирМепа1->РорирСотропепф) ) ->Гопе->Аззтоп ( 
Гопе01а1091->Гоп®); 
} 
ры 
Уу013 __Еаз®са11 ТЕогм1: :ГопеР1а1о91Арр1у (ТОБ]ес®е *бепаег, НИМР Ипа) 


{ 
((ТМемо *) (РорирМепа1->РорирСотропепЕ) ) ->ЕГопЕ->А$$1ап ( 
Гоп*01а1091->Гоп®); 
} 


Начнем рассмотрение приведенного кода. Функция Еогт(С]о5е является 
обработчиком события ОпС]о$е формы. Сначала в этом обработчике проверяет- 
ся, выбран ли раздел меню МСиггеп® — Сохранить текущее состояние. Если вы- 
бран, то организуется запись в файл СиггепГогт.4аЁ состояния формы. Ссыл- 
ка на форму дается для общности идентификатором Ищ$. 

Если раздел МСиггеп& не выбран, а выбран раздел МОе!аи (Состояние 
по умолчанию), то файл Сиггеп Гогт.4а{ уничтожается. Как будет видно далее, 
в этом случае при следующем запуске приложения форма приложения ноя- 
вится в том виде, в каком была спроектирована. 

Если и раздел МБе?аи не выбран, значит пользователь выбрал раздел Со- 
хранить предыдущее состояние. В этом случае ничего не делается, так что на дис- 
ке остается прежний файл Сиггеп Гогт.аа+. 

Функция ЕогтСгеаёе является обработчиком события ОпСгезе формы. 
Если на диске нет файла СиггепГогт.ааф, то в этом обработчике ничего не дела- 
ется. Так что форма приложения появится в том виде, в каком была спроекти- 
рована. Если же файл Сигтеп!Гогт.аАат имеется, то прежде, чем читать из него. 
информацию, в цикле уничтожаются все компоненты, включенные в свойство 
Сотропеп{5 формы. Делается это по следующим причинам. Из файла 
Сиггеп1Рогт.аа{ будут читаться все компоненты, которыми владеет форма. Но 
компоненты с теми же именами уже имеются на форме. Так что будут возни- 
кать конфликты из-за попытки добавить на форму компонент с тем же именем. 
Поэтому прежде, чем добавлять на форму новые компоненты, надо удалить 
прежние. После этого рассмотренным ранее способом из файла СиггтетГогт.аа1 
читается описание формы и расположенных на ней компонентов. 

Функции М1теСПсК и ММоуеСПсК являются обработчиками щелчков на 
соответствующих разделах контекстных меню окон редактирования. Они, со- 
вместно с обработчиком ЕЯЦ1Моцзеро\мп события окон ОпМоизердо\уп, обес- 
печивают возможность перемещения окон и изменения их размеров. Эти обра- 
ботчики не отличаются от рассмотренных в разд. 5.2.4, так что не стоит их по- 
вторно рассматривать. 

Функция АРошЕхесще является обработчиком щелчка на разделе Шрифт 
контекстных меню окон редактирования. Первый оператор обработчика пере- 
дает в. диалог Еоп01а10#1 текущий шрифт окна редактирования. Окно опре- 
деляется выражением (ТМето *)(РорирМепи1->РорирСотропеп{)) — компо- 
нент, вызвавший контекстное меню и рассматриваемый как окно класса 
ТМето. Следующий оператор вызывает диалог и заносит выбранный пользо- 
вателем шрифт в окно редактирования. Функция РЕоп Л\1а10о51Арр/у является 
обработчиком щелчка на кнопке Применить в окне диалога выбора шрифта. 
Чтобы эта кнопка появилась в диалоговом окне, в компоненте Еоп 0 1а1021 
в свойстве ОрНоп$ включена опция #9 АрруВиЙоп. 
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Приведенное приложение можно было бы расширить, включив в него воз- 
можность запоминать состояние в разных файлах, чтобы пользователь в даль- 
нейшем мог выбирать по желанию то или иное состояние. Ноя не стал услож- 
нять пример, чтобы в деталях не потонуло главное. Надо отметить, что форма, 
в которой реализован приведенный выше код, является универсальной и мо- 
жет быть применена для любого приложения. Правда, сохраняться и восста- 
навливаться будут только объекты, владельцем которых является форма. Так 
что не все настройки сохранятся. В ряде случаев потребуются еще дополни- 
тельные операции, чтобы при очередном запуске приложения все восстанавли- 
валось в том виде, в котором было в момент закрытия приложения. Например, 
если в приложении имеется компонент Васе ВЕЯЦ, то его состояние и текст в 
нем восстановятся, но форматирование отдельных фрагментов исчезнет. Если 
желательно восстанавливать текст вместе с форматированием, надо запоми- 
нать его отдельно в формате .гЁи при открытии приложения загружать запом- 
ненный текст в окно. Может потребоваться также отдельное запоминание ка- 
ких-то переменных, хранящих состояние приложения. Но это все можно без 
особого труда решить в каждом конкретном случае. 


Разработка справочной 
системы 


Справочная система любого приложения, предназначенного не только для 
его автора, но и для других пользователей, должная включать в себя ряд эле- 
ментов: обеспечивающих подсказки и контекстно-зависимую справку. Разра- 
ботка подобной системы подробно рассмотрена в разд. 71.4. Но сначала в пред- 
шествующих разделах обсуждаются вопросы создания справочного файла — 
основы любой справочной системы. 


7.1 Проектирование справки 


Разработка справочной системы для приложений С++Виаег осуществля- 
ется средствами У/тЧо\мз. Просмотр ее также осуществляется программой 
УИшомз УшНе]р. С++ВиПаег только позволяет встроить справочную систему 
в приложение. | 

Справки для приложений могут разрабатываться в нескольких форматах: 
УМшНе, НТМЕ Не 1.х, МЗ Не 2.х. Первый из этих форматов создает фай- 
лы .Ир, и спЬ обслуживаемые программой УМ тдомз ИтНер. Это обычные 
справки, которые каждый видел в большинстве прикладных программ, в част- 
ности, в среде С++ВаПаег 6. Более современным считается формат НТМГ 
Нер 1.х. Справки в этом формате отображаются в виде страниц НТМГ. с помо- 
щью компонента Ас1уеХ Нйорп.осх. Основной файл справки в формате НТМЕ 
Нер 1.х — файл .срт. С появлением платформы .МЕТ появился еще один фор- 
мат — МБ Нер 2.х. Этот формат принят для справки в среде разработки 
С++Ви!Паег 2006. Но поскольку сам С++Ви!аег 2006 не создает приложения 
для .МЕТ, то на этом формате мы далее останавливаться не будем. 

Разработка справки состоит из двух основных этапов: | 


* Создание файла или нескольких файлов, содержащих темы справок. 


* Компиляция справки в один или в несколько файлов „Юр и отладка всей 
справочной системы. 


Создание тем справок для формата У/шНе] делается с помощью любого 
текстового редактора, например, с помощью М1сгозоЁ У/огЯ в формате .гЁ{. 
Темы справок для формата НТМГ Не] 1.х создаются как страницы НТМГ 
в любом редакторе, работающем с такими страницами. 

Компиляция справки в формате У/шНер осуществляется с помощью про- 
граммы йсгЁрехе — М1сгозой Нер У/огкзвор 4. В С++Ви!аег 6 и предшест- 
вующих версиях она расположена в каталоге .../СВиИаег .../Нефр/Тоовз. 
В С+-+ВоПаег 2006 эта программа не входит в поставку, но она распространя- 
ется свободно, бесплатно, и не требует специальной установки в системе. 

Компиляция справки в формате НТМГ Не 1.х осуществляется програм- 
мой НТМГ Нер УогКзБор.' Это тоже свободно распространяемая программа, 
не входящая в состав поставки С++Ви!аег. Эта же программа позволяет соз- 
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дать файлы в формате НТМГ Не 1.х из файла в формате У/шНе]р. Правда, 
автоматический перевод форматов возможен только для очень простых фай- 
лов, но и в этих случаях возможно возникновение проблем с кириллигей. 

Поскольку чаще всего в приложениях используется пока формат 
Уп Не], все дальнейшее изложение в данной главе основывается на этом 
формате. Да и возможностей у него, на мой взляд, побольше, чем у новых 
форматов. 


Прежде, чем создавать тексты справок, надо продумать систему в целом. 
Надо решить, как должно выглядеть основное окно, какую информацию выно- 
сить в дополнительные окна, что выносить во всплывающие окна, как должен 
выглядеть и какие разделы включать предметный указатель и окно содержа- 
ния (это окно в виде дерева, содержащего изображения книг и документов ка- 
ждый из вас видел, работая с какими-нибудь справками). В отношении основ- 
ного окна надо решить, какие кнопки в своем заголовке оно должно иметь, 
нужна ли начальная часть, не поддающаяся прокрутке, и что в нее должно 
входить, продумать общий стиль справки. При решении вопроса о дополни- 
тельных окнах и распределении функций между основным и дополнительны- 
ми окнами надо иметь в виду, что дополнительное окно не имеет полосы меню 
и не обеспечивает доступ к истории и содержанию. С другой стороны, у основ- 
ного окна тоже имеется ограничение: оно не может быть сделано автоматиче- 
ски подстраивающим свои размеры под объем текста в нем. Не останавливаясь 
на подробностях процесса составления проекта справки, следует сказать, что 
этот процесс, конечно, трудно формализовать, и любой первоначальный про- 
ект подвергнется переделкам в процессе его реализации. Но все-таки помните, 
что от удачного или неудачного планирования справки во многом зависит 
удобство пользователя, а, значит, и его отношение к вашему приложению, для 
которого готовится справка. 


7.2 Создание файла тем справок 


7.2.1 Написание текстов тем 


Файл тем справок создается с помощью текстового редактора, например, 
с помощью М1сгозоЁ Уога. Каждая тема или кадр (в дальнейшем он будет 
отображаться в отдельном окне) занимает одну страницу. Точнее, размер темы 
может превышать одну страницу, но друг от друга темы отделяются символом 
разрыва страницы. В У/огА это осуществляется или командой Вставка | Разрыв 
и выбором в диалоговом окне опции Начать Новую страницу, или нажатием кла- 
виш Сн|-Етег. 

Порядок расположения тем в файле безразличен, кроме одной темы — Со- 
держание, которая по умолчанию располагается в файле первой и содержит 
ссылки на другие темы. На этот кадр передает управление У/шНер при щелч- 
ке пользователя на кнопке Содержание. Впрочем, если вы включаете в свой 
проект специальный файл Содержания, то именно этот файл будет опреде- 
лять, что увидит пользователь при щелчке на кнопке Содержание. 

При написании темы можно использовать многие возможности УТог4: вы- 
бор атрибутов шрифта (полужирный, курсив), цвет шрифта, табуляцию, под- 
черкивание, включение в текст таблиц (правда, без сетки и без разноцветной 
заливки) и т.п. Шрифты тоже можно использовать различные. Но увлекаться 
этим не стоит, так как если у пользователя на компьютере не окажется соот- 
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ветствующего шрифта, он не сможет прочесть ваших текстов. Так что лучше 
‚ всего использовать обычные шрифты, имеющиеся на любом компьютере. 

В кадр могут специальным образом включаться рисунки, кнопки и т.д. 

Каждая тема содержит ряд рассмотренных далее сносок, определяющих 
ее отображение в \МпНе]р. 

Темы могут содержать так называемые горячие области (по%фзро®): выде- 
ленные слова или кнопки, позволяющие пользователю переходить из данной 
темы в другие (позднее мы рассмотрим, как организуются эти выделения). 
При этом существует несколько возможностей переходов: прямой переход на 
заданную тему, переход с помощью макроса КТаиК, который может предло- 
жить пользователю выбор из тех тем, в К-сносках которых встречается задан- 
ный ключ, и с помощью макроса АШик, практически идентичного КТашк, но 
сравнивающего ключ с другим видом сносок — А-сносками. 

По умолчанию строки текста при их отображении в окне справки будут 
«заворачиваться», т.е. та часть строки, которая не помещается в слишком уз- 
ком для нее окне, переносится на новую строку. Это удобно, поскольку позво- 
ляет пользователю свободно изменять размеры окна, не затрудняя себе чтение 
текста. Однако в некоторых случаях это может оказаться нежелательно, на- 
пример, при отображении каких-то таблиц. Можно указать справочной систе- 
ме, что она не должна заворачивать какие-то строки текста. Для этого надо 
выделить в У/ог эти строки, выполнить команду Формат | Абзац и в открыв- 
’ шемся диалоговом окне на странице Положение на странице установить опцию 
Не разрывать абзац. Тогда, если ширины окна справки не хватает, чтобы ото- 
бразить всю длину отмеченных таким образом строк, в окне появится полоса 
горизонтальной прокрутки, но строки разрываться и переноситься не будут. 

Если в теме много строк, то для их просмотра пользователь будет пользо- 
ваться вертикальной прокруткой. Однако часто желательно указать какую-то 
область в начале текста темы, которая оставалась бы «замороженной» и не 
прокручивалась. Например, это может быть заголовок темы, шапка таблицы 
и т.п. Для того чтобы указать область, не подвластную прокрутке, надо выде- 
лить ее в \ога, выполнить команду Формат | Абзац и в открывшемся диалого- 
вом окне на странице Положение на странице установить опцию Не отрывать от 
следующего. 

В тему можно добавлять изображения в виде файлов типов тр, .Ш, 
шт}, .зй=, .тгЬ. Для этого можно просто воспользоваться буфером обмена, за- 
неся туда изображение из какой-нибудь графической программы и прочитав 
ее в У/ог4 командой Правка | Вставить. Так целесообразно поступить, если дан- 
ное изображение используется только в одном месте файла текстов тем. Если 
же оно используется в нескольких местах, то экономичнее использовать ко- 
манды {Юпс <имя файла>}, {Юп1 <имя файла>} или {Бриг <имя файла>}. 
Первая из них позиционирует изображение так же, как обычные символы. По- 
следующий текст продолжается в той же строке. Вторая — позиционирует 
изображение у левого края страницы, и текст обтекает его справа. Третья — 
позиционирует изображение у правого края страницы, и текст обтекает его 
слева. Например, вы можете написать такой текст: 


Пиктограмма {Юмс р1с®1.Рптр} на инструментальной ланели 
соответствует команде 


В том месте, где вы написали {юшс р1с{1.5пр}, появится изображение, со- 
держащееся в файле рЕ!с{1.6 тр, и сразу за изображением последует продолже- 
ние текста. 
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Вы можете добавить в текст кнопки, нажимая которые пользователь будет 
запускать тот или иной макрос. Это делается командой {роееоп <над- 
пись>, <список макросов> }'. В этой команде <надпись> — это та надпись, 
которая появится на изображении кнопки, а <список макросов> — перечень 
макросов, которые должны'‘выполняться при нажатии кнопки. Ёсли макросов 
несколько — они разделяются двоеточиями. Например, где-то в тексте вы мо- 
жете написать 


{Раббоп см. также, КЬапк (Меню) } 


Это приведет к тому, что при работе со справкой в этом месте появится 
кнопка с надписью «см. также». Если пользователь нажмет эту кнопку, то 
увидит окно Найденные разделы, в котором ему будет показан список тем, со- 
держащих в своих К-сносках (см. об этом ниже) название «Меню». 

Файл тем справок сохраняется в файле формата КТЕ — обогащенном тек- 
стовом формате. Для сохранения его в таком виде надо в М1сгозоЁ% У/ога вы- 
полнить команду Файл | Сохранить как и в открывшемся диалоговом окне уста- 
новить опцию Тип файла равной Гекст в формате КТЕ. После этого надо нажать 
кнопку Сохранить. Файл сохранится с расптирением по умолчанию .гЁ{. Все это 
надо проделать только при первом сохранении файла. В дальнейшем он будет 
сохраняться в том же формате автоматически просто при выборе команды Со- 
хранить. 


7.2.2 Сноски 


Каждая тема снабжается сносками, определяющими ее наименование 
и ряд других свойств. Сноски в У!ога делаются командой Вставка | Ссылка | Сно- 
ска или Вставка | Сноска, после чего открывается диалоговое окно Сноски (см. 
рис. 7.1). В нижнем его окне следует указать символ, используемый в сноске 
(на рис. 7.1 это символ «К»). Какие именно символы надо использовать в тех 
или иных сносках, будет рассмотрено ниже. Все сноски помещаются перед 
текстом темы, т.е. в первых позициях кадра. Чтобы наблюдать и редактиро- 
вать тексты сносок, \!ог4 должен быть переключен в режим Разметка страницы. 


Рис. 7.1 | нони 


Вставка сноски в текст файла тем в \\/ога Положение 


| 
{$ сноски: 


‚ формат 
другой: 


Нумерация: 


` Применить изменения 


Применить: к текущему разделу ый 


| 
Бетавить Отмена | о 


ще 
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7.2.2.1 Сноска # 


Сноска # обозначает уникальный идентификатор темы, по которому на 
нее могут ссылаться другие темы. Этому идентификатору в дальнейшем может 
ставиться в соответствие номер, по которому на данную тему может ссылаться 
использующее справку приложение. Так что любой кадр должен снабжаться 
меткой #. Идентификатор, указываемый как текст этой ссылки, имеет чисто 
служебное назначение, пользователь его нигде не видит. Идентификатор мо- 
‚жет писаться латинскими или русскими буквами и состоять из одного или не- 
скольких слов. Примеры таких сносок: “Мат, Содержание, #О программе. Но 
на всякий случай, лучше писать сноску латинскими буквами, так как на сим- 
волах кириллицы редко, но бывают малообъяснимые сбои в ссылках. 


7.2.2.2 Сноска К 


Сноска с символом «К» (заглавная латинская буква) должна включаться 
в кадр, если надо, чтобы тематика этого кадра отображалась при работе со 
справкой в окне справочной системы на странице «Предметный указатель» 
(см. рис. Т.2) в списке, из которого пользователь может выбрать требуемую 
тему по ее первым буквам, или просто пролистав список. Те названия тем, ко- 
торые пользователь видит в предметном указателе — это и есть тексты сно- 
сок К соответствующих кадров. 


Рис. 7.2 


Страница "Предметный | Предметный указатель | Поиск | 
указатель" справочной системы | | 


1. Введите первые буквы нужного слова. : 


иг 


2. Выберите термин или фразу и нажмите кнопку 'Показать". 


а о сео кк 


—. 


ыы 


| Главное меню ^| 
Меню Правка 
Меню Файл 
Шрифт | 
! Инструментальная панель 
Макросы 


Меню Правка 
Вставить 
Вырезать . 
Копировать 
Меню Файл } 

Выход 
Закрыть | 
Открыть 
1 Печать т: 


о д жд бин ад соот ат ша «ета ла бул 


Показать а ' Отмена ! 


Текст сноски (ключ) может состоять из одного или нескольких слов. На- 
пример, КМеню Правка. В этом случае при работе со справкой в списке указате- 
лей появится строчка «Меню Правка», по которой пользователь может выйти 
на данную тему. Можно также ввести несколько различных обозначений для 
одного и того же кадра, разделяя их точками с запятой. Например, ссылка 


КМеню правка; Меню 
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обеспечит две строки в указателе: «Меню правка» и «Меню», которые будут 
ссылаться на одну и ту же тему. Пользователь сможет выйти на нее по любой 
из этих строчек. 

Можно обеспечить и двухуровневые ссылки, которые видны на рис. 7.2. 
Для этого пишется название темы первого уровня, затем ставится запятая 
и пишется название темы второго уровня. Причем название темы первого 
уровня может соответствовать данному кадру, а может относиться и к другому 
кадру. Например, текст сноски 


КМеню Правка; Меню Правка, Вырезать; Меню Правка, Копировать; 
Меню Правка, Вставить; Меню; Главное Меню, Меню Правка 


приведет к тому, что в окне указателя появятся строчки (см. рис. 7.2) 


Меню Правка 
Вырезать 
Копировать 
Вставить 


Первая из этих строк определена в первом элементе сноски. Следующие три 
строки второго уровня определены во втором, третье и четвертом элементах 
сноски. Пятый элемент сноски определяет, что к данной теме пользователь мо- 
жет обратиться и по строчке «Меню». Наконец, последний элемент сноски 
определяет, что к названию другого кадра — «Главное Меню» добавится 
строчка второго уровня «Меню Правка». И по всем этим строчкам пользова- 
тель сможет выйти на данный кадр. | 

Элементы, указанные в сносках К, используются не только в списке ука- 
зателя, но и при организации переходов между темами по ключам с помощью 
рассмотренного далее макроса КТаик. | 


7.2.2.3 Сноска $ 


Сноска с символом «$» определяет заголовок данной темы. Этот заголовок 
используется в \МшНе в ряде режимов работы, в частности, в системе Поиск, 
в окне История, позволяющем пользователю вернуться к одной из уже просмот- 
‘ренных тем, и в ряде других режимов работы. Этот заголовок используется 
также во вспомогательном окне указателя тем в случаях, если какая-то строка 
основного указателя относится сразу к нескольким темам. Поясним это. 

Выше были рассмотрены сноски К. Ничто не метает в этих сносках для 
разных кадров указать одинаковый элемент. Это облегчает пользователю по- 
иск нужной информации. Например, если вы описываете темы, связанные 
с главным меню приложения и его разделами Файл, Правка и др., вы можете 
во всех этих темах в сноски К, внести элемент «Меню». Тогда строка «Меню» 
в предметном указателе будет относиться сразу к нескольким темам и пользо- 
ватель, выбравший эту строку, должен иметь возможность уточнить свой вы- 
бор, указав одну из конкретных тем. Для этого система справки автоматиче- 
ски предъявит пользователю окно «Найденные разделы», вид которого пред- 
ставлен на рис. 7.3. Строки, обозначающие в этом окне конкретные темы, за- 
даются в кадрах с помощью сносок с символом $. 
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Рис. 7.3 | | т. 
Окно «Найденные разделы» справочной системы | Выберите раздел и нажмите кнопку "Показать" 


|Главнае и всплывающее меню 
Главное меню 

Меню Правка 

Меню Файл 


Показать Отмена | 


7.2.2.4 Сноска А 


Сноска А (заглавная латинская буква) аналогична по синтаксису сно- 
ске К. Ноее тексты не включаются в указатель, как для сноски К, а использу- 
ются только для переходов по ключевым словам с помощью макроса АТК. 
Таким образом, если тексты сносок К участвуют в двух различных процес- 
сах — поиске по указателю и поиске по ключам, то сноски А позволяют развя- 
зать эти два процесса. Если вы хотите вставить справку в ИСР С++Ви!аег, 
чтобы на ее темы можно было выходить по клавише [| из окна Редактора Кода 
и другого инструментария, соответствующие ключевые слова надо включать 
именно в сноски А. 


7.2.2.5 Сноска + 


Сноска с символом «+» используется для указания последовательности 
просмотра тем с помощью кнопок «>>» и «<<». Эти сноски имеют смысл толь- 
ко в случаях, когда вы включаете в окно справки соответствующие кнопки 
просмотра (кнопки Вгом5е, включаются в файле Проекта — см. раздел 7.3.1). 
Если сноски + есть, но в них не указано никаких значений, то Не]р У/огКкКзПор 
устанавливает автоматически последовательность просмотра в соответствии 
с последовательностью тем в вашем файле. В кадрах, в которых сносок + нет, 
кнопки просмотра не доступны. Тексты сносок могут быть просто номерами 
(рекомендуется обозначать их с предшествующими нулями: 001, 002 и т.д.) 
или идентификаторами. 


7.2.2.6 Сноска ! 


Сноска с символом «!› используется для указания одного или нескольких 
макросов, которые должны сработать перед появлением окна данной темы на 
экране. Если указывается несколько макросов, то они разделяются запятыми 
или точками с запятой. Эти сноски используются только в достаточно слож- 
ных справках. Более подробную информацию см. в справке по Нер \У!огКзБор. 


7.2.2.7 Сноска * 


Сноска с символом «*» используется для указания связанных друг с дру- 
гом тем, которые должны быть встроены в справку. Эти сноски позволяют, 
подготовив один файл тем, использовать его для генерации несколько разных 
файлов справок. В этом случае в файле проекта .Йр/ указывается, темы с каки- 
ми значениями сносок * надо включить в справку — в файл .Ир. Темы без сно- 
сок * включаются в справку в любом случае. 
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7.2.2.8 Сноска > 


Сноска с символом «>» используется для указания идентификатора окна, 
в котором должна отображаться тема. Окно с этим именем должно быть опре- 
делено в файле проекта .йр/. Сноска > используется при передачах управления 
на данную тему из окна указателя или с помощью макросов КЫпЕК 6 АШик. 


7.2.3 Переходы 


В темы можно вводить переходы на другие темы несколькими изложенны- 
ми ниже способами. 


7.2.3.1 Непосредственные переходы 


Для того чтобы выделить в тексте темы некоторое слово или сочетание 
слов, при щелчке на котором пользователь перейдет на другую тему, надо сде- 
лать следующее. Сразу после этих слов (без пробела) надо написать идентифи- 
катор темы, на которую надо перейти. Затем соответствующее слово или соче- 
тание слов выделяется двойным подчеркиванием. Это подчеркивание не будет 
видно пользователю при работе со справкой — для него оно заменится выделе- 
нием цветом (обычно зеленым). Для того чтобы в М!сгозоЁ У/ога обеспечить 
двойное подчеркивание, надо выделить курсором требуемое слово или сочета- 
ние слов и выполнить команду Формат | Шрифт. В открывшемся окне 
(см. рис. 7.4) на странице Шрифт надо установить опцию Подчеркивание в поло- 
жение Двойное и нажать ОК. 


Рис. 7.4 3х! 
Окно \\/ог4, задающее | - 
варианты подчеркивания Шрифт | Интервал | Анимация | 
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После этого следующий за подчеркнутыми словами идентификатор темы 
перехода оформляется как скрытый (невидимый). Для этого выполняется та 
же команда Формат | Шрифт. В открывшемся окне на странице Шрифт в разделе 
Эффекты надо установить индикатор опции Скрытый и проследить, чтобы опция 
Подчеркивание имела значение (нет). 

Для того чтобы вы сами видели этот скрытый текст и могли бы его редак- 
тировать, надо выполнить в \У!огА команду Сервис | Параметры и на странице 
Вид в разделе Непечатаемые символы установить индикатор Скрытый текст. Если 
вам захочется напечатать на принтере текст вашего файла, то дополнительно 
на странице Печать в разделе Печатать надо тоже установить индикатор Скрытый 
текст. Не забудьте все это проделать. Иначе вам будет очень трудно работать 
с вашим файлом. 

Приведем пример вставки в текст переходов. Пусть вы написали тему 
с текстом 

О ПРОГРАММЕ 

Данная программа является примером простого текстового редактора. Она 

позволяет загрузить документ из файла в окно редактирования или создать в этом 


окне новый документ. 
Управление работой ведется с помошью Главного меню и быстрых кнопок. 


Вы хотите выделить слова «окно редактирования», чтобы при щелчке на 
них пользователь переходил к теме с описанием работы с этим окном. Пусть 
идентификатор темы, где описана работа с этим окном, — «Окно». Аналогич- 
но вы хотите выделить слова «Главного меню», чтобы после щелчка на них 
пользователь переходил к теме с именем «Главное меню», и слова «быстрых 
кнопок» для перехода на тему «ВиКопз». Тогда после описанных ранее выде- 
лений нужных словосочетаний , указания для них ‚ соответствующих тем и вве- 
дения ссылок текст приобретет вид: 


*5К О ПРОГРАММЕ 
Данная программа является примером простого текстового редактора. Она 


позволяет загрузить документ из файла в окно редактирования = или создать 
в этом окне новый документ. 

управление работой ведется с помощью Главного меню о. . и быстрых 
кнопок- ии 


# О программе 

$ О программе 

ко программе; 0 программе, Назначение программы; О программе, 
Управление программой 


При работе со справкой скрытый текст не будет виден. Пользователь уви- 
дит только тот текст, который был до введения указателей переходов. В этом 
тексте ‘будут выделены зеленым цветом и подчеркнуты слова окно редакти- 
рования, Главного меню и быстрых кнопок. Нри щелчке на них пользова- 
тель перейдет к соответствующим темам. 

При задании переходов имеются также возможности сообщить справочной 
системе некоторую дополнительную информацию. Если желательно, чтобы 
выделенные слова отображались цветом, принятым по умолчанию для всего 
текста (т.е. не выделялись зеленым цветом), то перед ссылкой на тему ставит- 
ся знак «*». Например: быстрых кнопок  ‹‘.`. Если к тому же вы хотите, 
чтобы эти слова отображались не подчеркнутыми, то вместо символа «*» надо 
поставить символ «%». Например: быстрых кнопок 
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Если ваша справка состоит из нескольких файлов .Йф, и вы хотите указать 
переход на тему другого файла, то после указания идентификатора темы надо 
поставить символ «@», после которого указать имя файла, В котором располо- 
жена эта тема. Например: быстрых кнопок: ет г. 

Задавая переход, вы можете указать имя окна ‚ (из числа ‚ определенных 
вами в файле Проекта — см. раздел 7.3.1), в котором вы хотите отобразить 
тему. Для этого после идентификатора темы вы ставите символ т больше (>), по- 
сле которого пишете имя окна. Например, быстрых кнопок“ ЕО. 

Можно также отображать тему, на которую вы переходите, 1 во всплываю- 
щем окне. Такие окна используются чаще всего для дополнительной информа- 
ции или пояснений. В отличие от основного окна всплывающее окна появляет- 
ся, не убирая с экрана окна вызвавшей его темы. При любом действии пользо- 
вателя всплывшее окно исчезает, и пользователь оказывается в предыдущем 
окне. | 
Указание на переход к теме, отображаемой во всплывающем окне, осуще- 
ствляется точно так же, как было описано выше, с единственным отличием — 
выделяемое слово или сочетание слов подчеркивается не двойной, а одинарной 


чертой. Например, быстрых кнопок“... 


7.2.3.2 Переходы по ключам 


Имеется два макроса, которые позволяют переходить не к заранее задан- 
ной теме, а к темам, в соответствующих сносках которых имеются заданные 
ключевые слова. Если заданные слова встречаются в нескольких темах, то 
пользователю показывается окно Найденные разделы (рис. 7.3), и он может сам 
определиться, на какую тему ему уходить. 

Эти два макроса — КИшК и АШиК имеют одинаковый синтаксис и дейст- 
вуют одинаково. Оба они могут использоваться, в частности, вместо рассмот- 
ренных выше непосредственных ссылок на темы. Различие между этими мак- 
росами состоит в том, что первый из них ищет заданные ключевые слова 
в К-ссылках, а второй — в А-ссылках. Приведем синтаксис вызова макроса 
Кик (синтаксис АИК аналогичен, только надо заменить КиК на АК): 


КЪапКк ("<список ключевых слов>", <тип>, 
"<идентификатор темы>", <имя окна>) 


<список ключевых слов> представляет собой ключ — одно или несколь- 
ко ключевых слов или словосочетаний, разделенных точками с запятой. Если 
хотя бы одно из этих словосочетаний содержит запятую, то весь список заклю- 
чается в двойные кавычки. Поиск ведется в К-ссылках сначала по первому 
слову. Если нашлось несколько тем, то пользователю показывается окно 
«Найденные разделы». Если же не нашлось ни одной темы, начинается поиск 
по второму ключевому слову и т.д. 

Все остальные элементы вызова макроса, кроме списка ключевых слов, 
являются не обязательными. <тип> определяет реакцию на найденные или не- 
найденные ключевые слова и может принимать одно или несколько (разделяе- 
мых пробелами) из следующих значений: 
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ИИ - —_ 
Численное 


Символическое Описание 


Если найдена только одна тема, соответствующая 
ключевым словам, то на нее сразу осуществляет- 
ся переход (впрочем, то же самое делается и по 

умолчанию). 


Если ключевое слово находится более чем в одном 
файле справки (при справке, состоящей из неско- 
льких файлов), то в окне Найденные разделы после 
названия темы пишется имя файла (так, как оно 
определено в файле .спё (см. раздел 1.3.3). 


Макрос возвращает величину, указывающую, на- 
шлось, или нет хотя бы одно соответствие ключе- 
вым словам. 


<идентификатор темы> определяет, что если не найдено соответствия 
ключевым словам, то появляется всплывающее окно с текстом, содержащимся 
в теме, на которую указывает этот идентификатор. Если идентификатор не за- 
дан, то при безуспешном поиске появляется диалоговое окно с текстом «До- 
полнительные сведения отсутствуют. (141)». Если идентификатор темы отно- 
сится к другому файлу, то после него надо написать символ «@», а затем — 
имя файла. 

<имя окна> задает окно для отображения. Если этот параметр не задан, то 
используется окно, заданное в кадре темы, а если оно и там не задано, то ис- 
пользуется окно по умолчанию. 

Приведем примеры использования рассмотренных макросов. Текст 


Меню ‘н.о: программы позволяет выполнить все операции. 


приведет к выделению слова «Меню», щелкнув на котором пользователь уви- 
дит или список тем, содержащих в своих К-сносках ключевое слово «Меню», 
или, если есть только одна такая темы, то сразу перейдет на нее. Если в том же 
тексте заменить обращение к макросу на 


'КЬапк (Меню,,,И1) 


то будет то же самое, но тема отобразится в окне с именем М1 (если такое окно 
определено в файле проекта). 
Оператор 


{БобЕоп Меню, АГлпк (Меню) } 


приведет к появлению в кадре кнопки с надписью «Меню», при нажатии на 
которую будет та же реакция, что и в рассмотренном в начале примере, но по- 
иск будет проходить в А-ссылках. 


7.2.4 Макросы 


Имеется множество макросов, помимо описанных выше КиК и АПШК, 
которые можно использовать при разработке справки. Они могут запускаться 
из «горячих областей» — выделенных словосочетаний, кнопок и т.д., или при 
открытии той или иной темы, или при открытии справки в целом. Рассмотре- 
ние этих макросов выходит за рамки данной книги. Все они хорошо описаны 
в файле справки Нсш.Шр, который может быть вызван непосредственно 
из \!114о\5$ или из М1сгозо& Нер У’огКзБор. Большинство этих макросов по- 
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зволяют работать с кнопками окна справки, с меню, создавать и уничтожать 

элементы списков и т.д. Рассмотрим коротко только некоторые из них. 
Отметим, прежде всего, макросы, позволяющие оперировать с файлами 

внешних программ. Эти макросы, введенные начиная с УИшНе 4.0: 


Макрос , Описание 


| Сопфго!Рапе! | Открывает заданный элемент ' (файл ср!) программы «Контроль- 
‘ная Нанель». 


-+ п а ен. + ОНИ = ИН Ж- = -— 


ЕхесЕЙе ‚ Запускает указанную программу или открывает файл и запуска- | 


| ‚ет связанную с ним программу. 


--——- НИ ---- НН ава — о 
| ‚ЕПеЕх!е! |  Проверяет наличие указанного файла в на компьютере ыы 
‚теля. | 
| 


‚. а. — ИНЬ И ООН 


‚ЗвеПЕхееще | Открывает, печатает или запускает файл или программу. 


и —— 


—-.-—- = а =: =—щ —_—=—— 


‚ ЗВогёСи Запускает указанную программу, если она еще не запущена, 
или активизирует ее и передает ей сообщение УМ _СОММАМО. М. | 


Не останавливаясь детально на синтаксисе макросов, описанном в справке 
‘по подготовке Не]р, рассмотрим несколько примеров. 

Приведенный ниже оператор создает кнопку, при нажатии на которую за- 
пускается элемент «Контрольной Панели» Дата/время. 


{Бобсоп Дата/время, СопЕго1Рапе1 (Т1медаее) } 


Следующий оператор создает кнопку, при нажатии на которую запускает- 
ся программа У\ш@4омз Калькулятор. 


{Расеоп Калькулятор, ЕхесЕ1]е (Са1с.ехе) } 


Следующий оператор создает кнопку, при нажатии на которую открывает- 
ся исходный файл справки, т.е. вызывается программа, связанная с этим фай- 
лом. Поскольку он записан в формате ВТЕ, то обычно с ним связана програм- 
ма \У№ога. 


{Бобсоп Тортс$.гЕЕ, ЕхесЕ11е (Тор1с$.к%Е) } 


Следующий оператор проверяет, есть ли на компьютере файл приложения 
туарр.ехе. Если есть, то это приложение запускается. В противном случае осу- 
ществляется переход на тему с идентификатором шва. 


ТЕТБерЕ] 5е (Е11еЕх15$% (туарр.ехе), ЕхесЕ11е (туарр), 
ЗатпрТа (1п$6а11)) 


Ряд макросов связан с созданием кнопок в полосе кнопок заголовка окна 
справки или с созданием разделов меню, не предусмотренных по умолчанию 
в справочной системе. Эти макросы обычно выполняются при открытии справ- 
ки и включаются в описанный в следующем разделе файл Проекта справки, 
хотя кнопки и разделы меню могут создаваться или уничтожаться и в отдель- 
ных темах справки. Приведем примеры таких макросов. 

Макрос | 


Вхсизевастой$ () 


создает в полосе кнопок заголовка окна справки кнопки просмотра вперед 
и назад (кнопки >> и <<). Эти кнопки обычно имеет смысл включать только 
при использовании в темах сносок *. 
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Макрос СгежеВи Йоп создает в полосе кнопок заголовка окна справки но- 
вую кнопку с указанным именем, соответствующую указанному макросу. Син- 
таксис макроса СгежеВиЦоп следующий: 


СгеатеВае {оп ("<идентификатор>", "«<надпись>", "<макрос>") 


Здесь <идентификатор> — внутренний идентификатор кнопки (произволь- 
ный), который можно использовать, если вы потом захотите, например, в ка- 
ких-то темах удалить эту кнопку. <надпись> — это то, что будет написано на 
кнопке. А <макрос> — тот макрос, который будет выполняться при щелчке на 
этой кнопке. Например, макрос 


СгеакеВаЕвоп ("Н1зеогу", "&История", "Н1$$оку ()") 


создаст кнопку с надписью «История», при щелчке на которой будет выпол- 

няться макрос Н1$%огу(), отображающий окно со списком до сорока последних 

тем, просмотренных пользователем. Из этого списка пользователь может вы- 
брать тему, к которой он хочет вернуться. 

| В заключение приведем несколько макросов, позволяющих добавлять но- 

вые меню и разделы в полосу меню окна справки. Первый из этих макросов — 

Гозег{Мепоа, добавляющий новое меню. Его синтаксис: 


Тозег(Мепц ("<идентификатор меню>", "<надпись>", <номер>) 


Здесь <идентификатор меню> — внутренний идентификатор меню, который 
можно использовать при последующих ссылках, <надпись> — надпись разде- 
ла, <номер> — порядковый номер меню (меню нумеруются слева направо, на- 
чиная с 0). | 

Второй макрос — Аррепа4Кет, вставляющий раздел в конец указанного 
меню. Его синтаксис: 


Аррепатеец ("<идентификатор меню>", 
"<идентификатор раздела>", "<надпись>", "<макрос>") 


Здесь <идентификатор меню> и <идентификатор раздела> — внутренние 
идентификаторы, используемые в справке для последующих ссылок на меню 
и его раздел, <надпись> — надпись, которая появится в меню, <макрос> — 
макрос или макросы, которые должны выполняться при выборе пользовате- 
лем данного раздела меню. | 

Приведем пример совместного использования этих макросов. Операторы 


ЛпзегЕМепа ("мех1е", "Выход", 5) 
АррепаТфеп ("мехле", "ёх1е", "Выход", "ех1® ()") 


заносят в полосу меню окна справки меню Выход на 5-е место и заносят в него 
раздел Выход, в котором выполняется макрос ех (), осуществляющий выход из 
справки. | 

Макрос тзег Цвет позволяет вставить раздел в меню, указанное его иден- 
тификатором. Для предусмотренных по умолчанию меню окна справки ис- 
пользуются следующие идентификаторы: 
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‚ Меню Идентификатор 

} ., о и 

' Файл | ма _ Ше 

Правка ‚ии е4 

Параметры _ маи_ _©орНоп$_ 

Г _- — ОН „— ыы 
Закладка `шпи_ЪБоокшагК 

‚? ‘шпи_вер 

Г. и А — —- НИ 
`Всплывающее меню шпи_ ПоайиЕ | 


Пример использования макроса шзег{Цет: 


ТозегеТфем ("ппи_ре1р", "Ном", "Как использовать справку", 
"Не1рОп ()",0) 


В этом примере в меню справки вставляется на первое место (индекс 0 — 
последний элемент макроса) раздел Как использовать справку, при выборе кото- 
рого выполняется макрос НерОп(), обеспечивающий переход на стандартный 
файл, поясняющий использование справки. 


7.3 Компиляция и отладка проекта справки 


Компиляция и отладка справки, предназначенной для УМшАо\мз 95/98 / 
2000/ХР и МТ, производится с помощью программы М!сгозоЁ{ Нер У/огКзБор, 
запускаемой из файла ЙйсгЁ.ехе, расположенного в каталоге С++ВиИдег...\ 
Нер\Тоо[3. Эта программа позволяет легко создать файл Проекта справки, без 
которого ее нельзя компилировать, а если нужно, то создать еще некоторые 
вспомогательные файлы, например, файл Содержания справки и ряд других. 
Далее программа позволяет скомпилировать файл справки и проверить его 
в работе. В принципе можно создавать файлы Проекта, Содержания и др. про- 
сто в любом текстовом редакторе. Но тогда надо детально изучить их синтак- 
сис. А Нер У/огКзВор позволяет автоматизировать всю работу, не требуя зна- 
ния синтаксиса, так как эта программа сама создает тексты файлов, отражаю- 
щие действия разработчика. 


7.3.1 Создание файла Проекта справки 


Для компиляции справки и ее связывания с использующим его приложе- 
нием необходимо сформировать файл Проекта справки. Это текстовый файл 
в формате АЗСП. Для создания нового файла Проекта, надо выполнить коман- 
ду программы М!сгозоЁ Не!р У/огкзБор Не | Мем и в появившемся окне Ме\и 
выбрать опцию Нер Ргоес!. Далее в окне Ргоес! Ее Мате надо задать имя и ка- 
талог файла проекта справки. При этом учтите, что то же имя, какое вы зада- 
дите файлу Проекта, будет присвоено компилятором и завершающему файлу 
справки „Юр (впрочем, это можно отменить, задав другое имя файлу справки 
в окне ОрнНоп$ на странице [Нез — это будет рассмотрено позднее). Стандартное 
расширение файла Проекта — „Иру. 

В результате описанных действий перед вами появится окно заготовки 
файла Проекта (рис. 7.5), в котором первоначально будет занесен только раз- 
дел [ОрНоп$]. Теперь, щелкая на соответствующих кнопках в правой части это- 
го окна, можно создавать и заполнять другие разделы файла Проекта. В появ- 
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ляющихся при этом диалоговых окнах, описанных ниже (см., напри- 
мер, рис. 7.6) справа вверху имеется кнопка со знаком вопроса. Если нажать 
ее, возникает изображение вопросительного знака, которое можно подвести 
к любому элементу окна, после чего всплывет пояснение функции этого эле- 
мента. 


Рис. 7.5 2, МесговоЙ Нед УМок&Нор - [ЕЯ 


Окно редактирования файла | 53 &е Ме». \Ипдом Тез Тооб Нер 


Проекта справки ом и 


[ОРТОМ 5$] 

СОМРАЕ55=12 На! Геск 

САО =0х419 050 0х0 ; Русский 

ЛЕРОЯТ =\е$ 

СНААЗЕТ=204 

СОМТЕМТ$ =Содержание 

ТИТЕЕ =Редактор 

СМТ=\НерСом си 

СОРУНЕНТ =ТЕСТ НЕЁР, ВЕРСИЯ 1, Ждае 
СТАТ!ОМ=------ Тест НЕЁР 


[РИ Е$] 
‚\Торс$.1 


[МАР] Бака Ейе$... | 
; Меню Правка 
; Меню Файл 
; Окно редактирования 
; Главное меню 
; Содержание 


Рис. 7.6 | 
Окно Торе Ее — ввод | Торе Нез 
имен файлов тем | 


Рачегх... 


№ Ассер! темвюп таз м юрс Нез 


Г” Торю Нез изе а ЧоцЫе-Бие сКагасег 52! 


к Сапсе! | 
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7.3.1.1 Кнопка ЕЙе$ 


Кнопка [Нез в правой части окна рис. 7.5 (не путайте с аналогичным по на- 
званию разделом меню) позволяет указать имена файлов с текстами тем. 
Шелкните на этой кнопке. Перед вами появится окно Тор1с ЕЦез (рис. 7.6), 
в котором надо щелкнуть на копке Ада и выбрать среди файлов подготовлен- 
ный файл текстов справки. В результате в файле проекта появится раздел 
[[1е$] с внесенным в него именем файла (см. рис. Т.). Если ваша справка ком- 
пилируется из нескольких файлов тем, то аналогичным образом вы должны 
включить в раздел [Е е$]| и остальные файлы. 

Для файлов тем, расположенных в том же каталоге, где располагается 
файл Проекта „.йр/, имена файлов могут указываться без путей. Если же они 
расположены в другом каталоге, то они указываются с путем. Возможен и дру- 
гой подход — в окне Тор1с ЕШез (рис. 7.6) можно щелкнуть на кнопке Го|дегз 
и выбрать папку или папки, в которых хранятся файлы тем. Тогда в файле 
Проекта появится оператор В,00%, в котором указана соответствующая папка. 

Кнопка Кетоуе в окне Тор!с ЕПез позволяет удалить файл тем из списка. 
Кнопка шсусе... позволяет включить в проект текстовый файл АЗСП, содержа- 
щий список файлов тем. | 

Теперь перейдем к другим кнопкам окна Проекта, представленного 
на рис. 1.5. 


7.3.1.2 Кнопка \ММт4ом/$ 


Кнопка \/пдомз позволяет определить атрибуты окон, используемых 
в справке. При щелчке на этой кнопке открывается диалоговое окно Уш4ом 
Ргорегиез (свойства окон), представленное на рис. 7.1 а. Оно имеет ряд стра- 
ниц. На странице Сепега| (общие характеристики) вы можете изменять список 
определенных вами типов окон, добавляя в него (кнопкой Ада] или удаляя 
(кнопкой Кетоуе} идентификаторы окон. Кнопка |псшае позволяет включить 
целый файл, содержащий список окон. Дополнительным окнам вы можете 
присваивать имена по вашему усмотрению. Эти имена затем могут использо- 
ваться в сносках > и в операторах переходов, о которых рассказывалось в раз- 
деле 7.2. Если же вы хотите определить характеристики основного окна, отка- 
завшись от его характеристик по умолчанию, вы должны включить в список 
идентификатор тат. 

Расположенные внизу диалогового окна индикаторы позволяют устано- 
вить опции, определяющие состояние окон. Установка опции Ало-з5те пед! 
(автоматическое изменение высоты) делает окно изменяющимся по высоте 
в зависимости от объема текста темы. Это удобно, если у вас есть темы, суще- 
ственно различающиеся по объему. Главное окно не может содержать эту оп- 
цию. Опция Кеер Нер м/тао\м оп юр позволяет обеспечить положение данного 
окна справки всегда поверх остальных окон. 

Окно в середине страницы с заголовком ТМеБоаг1ех! позволяет задать текст, 
который будет записан в полосе заголовка окна справки. Если этот текст не за- 
дан ни тут, ни в файле Содержания .спф, то в заголовке окна просто не будет 
никакого текста. | 
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бепега! Розоп | Вицопз | Союг | Масгоз | | 


‘Ат до ре: ПА й | \уипдом ре. |1 


_ МАпдом яге айд роз®оп--- - --------`------ < 


Не о че О И Е ЕЕ ИРИС ЛЕЧЕНИЯ 


Те БагехЕ "Вспомогательное Бкно справки __ М АдизЕ Юг цвег$ зстеем гезомвоп 

Соптее Дополнительное кн — НГ щ миа: [285 
| ЕСИ 

Атас аНЬиез | ... | Тор ИЗ НесиЕ 1494 


№ Ащо-ате Пед! г” _. , | _ Й 
, я Ащо-бег | Регаи! Розвоп$ .] 


' Кеер Нар илтдом оп юр 


п о и ее сы поме ола О: 


Рис. 7.7. Окно свойств окон справки: страницы Сбепега| (а) и Розвоп (6) 


Страница РозШоп (положение) диалогового окна \/шп4ом Ргорегиез 
(рис. 7.7 6) позволяет выбрать положение и размеры окна. Здесь особенно по- 
лезной является кнопка Ащо-Зтег. Щелчок на ней вызывает появление на эк- 
ране окна, представленного на рис. 7.8. Вы можете изменять размеры и пози- 
цию этого окна на экране. Когда вы расположите окно так, как вам хочется, 
целкните на кнопке ОК и выбранные вами положение и размеры передадутся 
окну вашей справки, атрибуты которого вы задаете. 


Рис. 7.8 [инер ммодом Аа 


Задание размеров и местоположения окна | То адотансайь зе! чае апд розвог 
} соогдтаез, поуе ай4 зе $ 


| \лидо\,, апд Шел сИСК ок. 


Остальные страницы диалогового окна У/т4о\м Ргорегйез мы не будем 
подробно рассматривать, поскольку они вряд ли могут вызвать затруднения 
при работе с ними. Страница ВуНопз позволяет задать кнопки, которые должны 
быть в окне, страница Соог позволяет выбрать цвета фона окна, причем от- 
дельно для основной области текста, и для непрокручиваемого заголовка. 
Кнопка Масго$ дает возможность определить макрос, выполняемый в момент 
открытия окна. 

При задании атрибутов главного окна (та1т) следует иметь в виду, что они 
не относятся ко входам в справку из приложения эти атрибуты не действуют 
при входе в справку из приложения. Поэтому, во избежание неприятных на- 
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кладок с различными стилями окон, надо для всех тем, в которые можно вой- 
ти из приложения, добавить сноски >, в которых явным образом указать в ка- 
честве окна шашщ. 


7.3.1.3 Кнопка ВИтарз 


Кнопка В—йтар5 позволяет указать папки, в которых Не]1р Могкзрор сможет 
найти использованные в темах файлы изображений .6тр, если они расположе- 
ны не в том каталоге, в котором находится файл проекта. 


7.3.1.4 Кнопка Мар 


Если вы хотите, чтобы из вашего приложения можно было управлять фай- 
лом справки, необходимо создать таблицу соответствия номеров контекстной 
справки, задаваемых в приложении, и идентификаторов тем. Для этого надо 
щелкнуть на кнопке Мор, в открывшемся диалоговом окне Мар (рис. Т.9 а) 
щелкнуть на Ада и в окне добавления нового входа Ааа Мар Ещфту 
(см. рис. 7.9 6) ввести идентификатор темы (в окно Торюс 10) и соответствую- 
щий номер (в окно МарреЯ питепс уаше), по которому будет осуществляться 
ссылка на эту тему из приложения. Можно также ввести комментарий в окно 
Соттеп{. Этот комментарий просто будет занесен в файл проекта и никак не 
повлияет на справку. Но он очень пригодится вам, когда вы будете назначать 
значения НеарСощехё компонентам своего приложения. Затем надо щелкнуть 
на ОК, вернуться в окно «Мар» и опять щелкнуть на ОК. В результате подоб- 
ных действий в файле проекта появится раздел [МАР] (см. рис. 7.5). 


Мар юрс 10$ ю питенс уамез: 
ЕЧи=4 °; Меню Правка. 
1Е\е=3 ; Меню Файл 


| | 1 Мето=5 ; Окно редактирования 
' |ММЕМУ=2 ; Главное меню Аеточе | 
тив ие. | | Торе 10: 
ЕЗЕ.. | [Панель состояния 


ГСодержание=1 ; Содержание 


Марред питепс чаше: 


Е и 


[изеад оГ1ОН_, сйеск {Иезе ргейхез: Соле! 


у | [Описание панели состояния 
сие | 


Рис. 7.9. Задание соответствия номеров справки и идентификаторов тем: главное окно 
Мар (а) и окно задания нового входа (6) 


о 
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7.3.1.5 Кнопка Айа$ 


При нажатии на кнопку Айаз$ (псевдонимы) появляется окно (рис. 7.10 а), 
подобное уже рассмотренным ранее, содержащее кнопки добавления удале- 
ния, редактирования псевдонимов идентификаторов тем и включения сразу 
списка псевдонимов из файла. Псевдонимы могут вводиться, чтобы изменить 
переходы в файле справки или входы в него из приложения, не меняя текстов 
тем. Например, у вас сначала было две темы: одна из них с идентификато- 
ром Не описывала меню «Файл» вашей программы, а вторая с идентификато- 
ром Ед описывала меню «Правка». Затем вы решили объединить оба описа- 
ния в одной теме и дали этой теме идентификатор Ее, принадлежащий ранее 
первой теме. Можно, конечно, вручную просмотреть весь файл тем (или не- 
сколько файлов), найти все ссылки на Ес! и заменить их на Не. А можно уста- 
новить идентичность этих двух ссылок с помощью псевдонима. Для этого на- 
жимаете кнопку А!юз$, затем кнопку Ада и в открывшемся окне (рис. 7.10 б) 
пишете в верхней окне редактирования «Е|е», а в нижнем «Е». Тогда все 
ссылки и переходы на ЕдЙ заменятся на ссылки и переходы на Не. В файле 
Проекта появится раздел [Айа5$], содержащий таблицу введенных псевдонимов. 


Тор 12 АНа$ 


Торюз (Иа! аге айазед {© офег юрюк$: 


Ене=Е и ; Слияние ЕЗКи Ее в Ра - 
АДЧ АНа$ 


\епеуег {5 юрю Ю арреггз: 
[Ре 
зе вк порю 1 ива: 


[Е 


опите 


[Слияние ЕфиНев Не 


а) 6) 


Рис. 7.10. Задание псевдонимов: главное окно (а) и окно добавления псевдонима (6) 


7.3.1.‹6 Кнопка СопйЯд 


При нажатии этой кнопки возникает диалоговое окно, подобное всем пре- 
дыдущим, в котором можно указать макросы, которые должны выполняться 
при каждом входе в справку. Например, это может быть макрос 
ВгомзеВи Йоп 5(), обеспечивающий появление в окне кнопок «>>» и «<<» для 
перемещения по темам вперед и назад, или любые другие макросы. Ниже при- 
веден пример набора макросов, выполняемых при входе в справку: 


СгеакеВице оп ("Н1з6огу", "&История", "Наз®огу ()") 
ВгомзеВа®®оп$ () 

Тпзег%Мепа ("мех1{", "Выход", 5) 

Аррепа!фем ("пех1*", "ех1{", "Выход", "ех1® ()") 


ТпзекеТеем ("тпи_пе1р", "Ном", 
"Как использовать справку", "Не1рОп ()",0) 
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Описание этих макросов приводилось ранее, а их влияние на окна справки 
вы можете проверить экспериментально. 


7.3.1.7 Кнопка Оаца ЕГИЙе$ 


При нажатии этой кнопки возникает диалоговое окно, подобное предыду- 
щим, в котором можно указать файлы данных для библиотек РШЬ, используе- 
мых в вашей справке. 


7.3.1.8 Кнопка ОрЧоп$ 


Кнопка Орноп$ открывает многостраничное диалоговое окно, представлен- 
ное на рис. 7.11. Страница Сепега! позволяет задать в окне Оеюу! !юрк иденти- 
фикатор темы по умолчанию. Это тема, на которую будет осуществляться пе- 
реход, при ошибочном задании идентификатора темы (после соответствующе- 
го предупреждения). Кроме того, если справка не имеет файла Содержания 
спь, то по этому идентификатору будет осуществляться переход при нажатии 
пользователем, работающим со справкой, кнопки Содержание (если тема 
в окне ПеюуН юрс не задана, то в этом случае по умолчанию будет переход 
к первой теме первого файла). Опция Нер 1е позволяет задать заголовок глав- 
ного окна, если для проекта не определено окно та с соответствующим заго- 
ловкам с помощью кнопки \\/ томе. 


Рис. 7.11 рлоп® р | = 
`Задание темы по умолчанию 6 | Маме | вата | 
__ бела т Сотреззюп | бое | 


_ омыжи Горе: [Содержание 
_ Нар 5: [Редактор 


"ем 
м Мос М Рощезз — Енох.. | 
- Га боты 
— `рерау Нален:и е Уегзюй Фаюд Бок 

| [ЕСТ НЕГР, ВЕРСИЯ 1, дае 


_| | увеу разно ог ри Нар 1ем, дерау: 
Тест НЕЦР -- 


Рис. 7.12 О программе 
Пример окна «О программе» # 9 Справка Мклозой пои 
5.1.2600.0 | 
‚ ФКорпорация Майкрософт, 1390-2000 


__ ТЕСТ НЕХР, ВЕРСИЯ 1, 
Зафиаау. Мауетфа! 29, 2003 13:28:38 
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Опция О5р|ау 1715 1ех! т Ме Уегзюп 4юод Бох: позволяет задать текст, кото- 
рый пользователь будет видеть в диалоговом окне, когда при работе со справ- 
кой выберет в меню ‹ раздел Версия. Пример этого окна приведен на рис. 7.12. 
В тексте можно задать ключевые символы %Зае и тогда в окно будет заносить- 
ся дата создания файла справки (см. рис. 7.12). 

Опция [ озег рае ог айБуп Нер 1ех!, 415р|ау: позволяет задать текст, который 
будет присоединяться к тексту темы при его печати или при копировании в бу- 
фер обмена. Опции в средней части окна относятся к процессу компиляции 
справки и позволяют, в частности, с помощью кнопки Еггог5 запретить появле- 
ние некоторых сообщений об ошибках. 

Страница Сотргеззюп позволяет задать уровни сжатия при компиляции. 
Повышение уровня сжатия уменьшает размер результирующего файла, но 
увеличивает время компиляции. 

Страница 5оЙтд определяет язык справки и сортировку в предметном указате- 
ле с игнорирование или с учетом различных обозначений (опция Моп-зрастпатай$) 
и вспомогательных символов, таких, как пунктуация (опция Зутбо8). 

Страница Е!ез (рис. 7.13) в верхнем окне Нер Не позволяет задать имя 
скомпилированного файла справки „Ир, отличное от имени файла Проекта 
„йр/. В следующем окне, если хотите, можно задать имя файла протокола, в ко- 
торый будут заноситься сообщения о ходе компиляции. Следующее окно КсП 
Тех! Гогта\ (КТЕ) Нез просто дублирует информацию, которую вы задавали в окне 
Торюк Е ез, нажав кнопку Нез. Если вы создали для справки файл Содержания 
.СсПЪ, ТО вы ДОЛЖНЫ ПОДКЛЮЧИТЬ его к проекту, задав его имя в окне Сотет Ве. 
В следующем окне ТМР Ю\ег вы можете задать папку для создаваемых в про- 
цессе компиляции временных файлов. По умолчанию временные файлы созда- 
ются в той же папке, в которой лежит файл Проекта. Впрочем, пока ваш файл 
меньше 8 Мбайт или пока в нем не встретилось ошибочных рисунков, времен- 
ные файлы вообще не создаются. В нижнем окне ЗиБ$Н#\е рой ргейх вы можете 
указать путь, который будет использовать Нер \У№огКзВор вместо пути, указан- 
ного в файле проекта. Этим можно воспользоваться, если вы, например, пере- 
несли ваши файлы .гЁи „Фтр на другой диск или на другой сервер. Тогда вме- 
сто исправления путей во всем тексте можно воспользоваться этой опцией. 


Рис. 7.13 ЕТ. 0х 
Задание имени скомпилированного $ | Мая | Выетав | ов | 
файла справки Селе» |  Сопиезюи | бою = №№ — 


Неф Еве: [ЛЕвйНер. "р | 
поме: | | 


Аки Тем Ропта: (АТЕ] Ве: 


| ‚АТорсз. ] Срапде... | 


ег! Не: | о | 
‚АНерСот. си __ `Вгомее... | 
ТМР Юмег 


Г в. | 


бибйще рай ргейх: 


Е. | 
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Страница [5 позволяет создать файл .Ё5$, для поиска по всему тексту. 
Впрочем, при желании пользователь может создать этот файл и сам, работая 
со справкой и выбрав страницу Поиск. Учтите, что этот файл может быть боль- 
шого объема. Так что решайте, стоит ли создавать его. 

На странице Гоп! вы можете выбрать шрифт, который будет использовать- 
ся в диалоговых окнах И1пНе, и осуществить замену шрифтов, использован- 
ных в файлах тем, на другие шрифты. Не забудьте задать на этой странице 
русское множество символов и шрифт, обеспечивающий отображение кирил- 
лицы. Страница Масго$ дает возможность связать какие-то выделенные слова 
в тексте с соответствующим макросом. Страница Ви! Тад$ позволяет строить 
на основе одних и тех же файлов тем различные файлы справок с помощью 
описанных ранее сносок *. 


7.3.1.9 Создание простого файла Проекта 


Выше были рассмотрены богатые возможности, предоставляемые Нер 
УГогК$Вор при создании файла Проекта справки. У читателя может создаться 
впечатление, что все это очень сложно. Однако в действительности при созда- 
нии достаточно простых справок или на первых этапах создания даже слож- 
ных справок не требуется задания всех рассмотренных опций. Для создания 
файла Проекта простой справки достаточно выполнить следующие действия: 


1. В меню Не программы Нер У/огКзвор выполнить команду Ме\,, затем в от- 
крывшемся окне выбрать опцию Нер Рго|е<!. Далее в окне Ргоес+! Ее Мате 
надо задать имя и каталог файла Проекта справки (каталог выбрать тот, 
в котором лежит файл текстов тем .7Ё}). 


2. В открывшемся окне Проекта (рис. 7.5) нажать кнопку Нез и в окне Торс 
Е[ез (рис. 7.6) щелкнуть на копке Ада и выбрать среди файлов подготов- 
ленный файл текстов справки. После этого щелкнуть на ОК. 


И это все. Вы можете компилировать ваш файл справки, как рассказано 
в разделе 7.3.2, и начать работать с ним. Все остальное — дело совершенство- 
вания этой справки, ее эстетического оформления и т.п. 


7.3.1.10 Изменение файла Проекта в текстовом редакторе 


Файл Проекта .Йр) является текстовым файлом, который можно редакти- 
ровать в любом текстовом редакторе, например, в \!ога. Честно говоря, в не- 
которых случаях это удобнее, чем пользоваться для редактирования описан- 
ным инструментарием программы М1сгозоЁ Нер У/огКзБор. Точнее, создать 
начальный файл Проекта и задать его основные разделы проще, конечно, с по-. 
мощью этой программы. Но последующее редактирование часто проще выпол- 
нять с помощью \/ога. Например, вы можете закомментировать временно ка- 
кие-то из подключаемых файлов тем, которые конфликтуют с другими, или 
закомментировать какие-то макросы. Для того чтобы перевести какую-то 
строку файла в комментарий, достаточно поставить в ее начале символ точки 
с запятой (;). Подобное редактирование в текстовом редакторе проще, чем уда- 
ление а в дальнейшем повторное задание строк с помощью МгсгозоЁ& Нер 
‚ УогКзВор. Вы можете также ввести в редакторе строки комментария на рус- 
ском языке, которые облегчат вам последующую работу с файлом Проекта. 

Только надо соблюдать при редактировании определенную осторожность 
и не испортить названия разделов и прочую служебную информацию, содер- 
жащуюся в файле. 
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7.3.2 Компиляция и отладка справки 


Когда файл Проекта создан, надо щелкнуть на кнопке 5ауе апа Сотрйе 
в нижнем правом углу окна рис. 1.5. Файл проекта будет сохранен и откомпи- 
лирован, в результате чего создастся файл справки „Вр с тем же именем, что 
и файл проекта, или с именем, указанным вами на странице Е|ез окна ОрйЙопз. 
Кнопкой Фауе ап Сотрйе надо пользоваться каждый раз, когда изменяется 
файл проекта. Если же в дальнейшем вы меняете только тексты в файле тем, 
то компиляцию удобнее производить командой Не | Сотрйе или проще — на- 
жав соответствующую быструю кнопку с пиктограммой мясорубки (вторая 
справа на рис. 7.6). Причем вы можете это делать, даже не открывая предвари- 
тельно. файл Проекта. В результате выполнения этой команды откроется окно‘ 
Сотрйе а Нер НЕ (см. рис. 7.14), в котором вы можете выбрать нужный файл 
проекта и затем щелкнуть на кнопке Сотрйе. Предварительно удобно устано- 
вить флаг опции Ацшотансайу 45р!ау Нер Не т \/МпНер меп 4опе, которая обес- 
печивает сразу после компиляции просмотр скомпилированного файла справ- 
ки. Если вы не установили опцию Миштйе мип4о\и уПЙе сотрйта, то во время 
компиляции вы будете видеть окно, с работающей мясорубкой, отражающей 
процесс компиляции. Установка указанной опции минимизирует это окно. 
Опция Тит оН сотргеззюпт (ге4усез сотрйе Нте) позволяет временно отключить 
сжатие файла. Это приведет к увеличению размера файла справки, но заметно 
уменьшит время компиляции больших справок. Опция посуде „Ш Непате апа 
{ор Ш т Нер Не включит в файл справки имена файлов текстов тем и иденти- 
фикаторы тем. Это позволит вам в процессе отладки, установив в меню Не оп- 
цию Нер АМог, получать при просмотре справки оперативную информацию 
о каждом кадре справки. | 


Рис. 7.14 Сотрйе а Нер Е4е ШИ | 
Задание опций компиляции файла справки Русс Ве: | 
[ЕС\ТНЕГР.НР/ "| Вюмсе... 
Г Мижиее мифом ие сотр 
с Ащотайсайу Ферау Нер Не м \\ИпНер итеп допе 
- Тетрогаму зеНилд$ (Гог(е$вта от] 


| 
№ Тит ой сотруеззюл (едисез сотрёе те] 
в 


После компиляции вы увидите в окне Нер У’огК$Вор содержимое тексто- 
вого файла СотрйанНоп (рис. 7.15), в котором содержатся сведения о результа- 
тах компиляции. Здесь же будут замечания и сообщения об ошибках, которые 
возникнут при неправильном исходном файле .гЁ. Однако не спешите огор- 
чаться, получив множество сообщений об ошибках. И не бросайтесь сразу ис- 
кать их и исправлять в вашем файле тем. Посмотрите в конец выданной вам 
информации о результатах компиляции. Если вы увидите там фразу «Сгеафеа 
... .р, ... 5У%фе5», значит ваш файл справки скомпилирован и вы можете его 
посмотреть. В процессе этого просмотра и отладки вы скорее найдете ошибки, 
чем просто отыскивая их в исходном тексте. 
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Рис. 7.15 |2, МегозоВ Нер МогК$Вор - [СогпрйаНоп1 ] 
Просмотр сведений = ты ый бон 165 тов Нер 
о результатах га 

компиляции 
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4: 


После компиляции при включенной указанной выше опции АмотансайЙу 
Чрюу Нер Ме т \М/тНер у/Пеп допе вы сразу же можете поработать с откомпи- 
лированным файлом справки. В дальнейшем просмотр и работа с этим файлом 
может осуществляться или с помощью команды Не |Кип \/шНер, или соответ- 
ствующей быстрой кнопкой со знаком вопроса (крайняя правая в панели инст- 
рументов на рис. 7.5). В результате откроется диалоговое окно Уе\м Нер Не 
(рис. 7.16), из которого запуск просмотра осуществляется кнопкой Ме\и Нер. 
В верхнем окне Не устанавливается интересующий файл справки. В окне 
Рго|ес! Не устанавливается имя файла проекта. Опция Марреа Торг 105$ позволя- 
ет выбрать ту из тем, указанных в разделе [МАР] файла Проекта, которая будет 
показываться первой. Таким образом, вы можете моделировать обращение 
к справке из вашего приложения. Если вы к тому же установите опцию 
АшотансайЙу тоуе 10 пеж |0 аНег Ме\ми Нер 15 сйсКед и для начала зададите значе- 
ние Марреа Торс 10$ равным первому из разделов [МАР], то при последователь- 
ных нажатиях на кнопку \Ме\уи Нер вы поочередно пройдете весь список внеш- 
них входов справки. Опции в нижней части окна позволяют посмотреть, как 
выглядит справка при открытии ее разными способами. Опция пуоКе4 Бу а 
ргодгат соответствует нормальному входу из программы. Опция А рор-ур пока- 
зывает, как выглядит тема при ее отображении во всплывающем окне. Опция 
А натта сага соответствует случаю, когда справка встроена в процесс отладки 
приложения по шагам (эта опция реализована не во всех версиях). Опция А 
доцЫе-сйсКед Не 1соп соответствует входу в справку при двойном щелчке на ее 
пиктограмме. 
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Рис. 7.16 , ме Нер Ейе 
Задание опций просмотра 
файла справки 
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В процессе отладки удобно установить в меню Не опцию Нер АПог. Тогда 
при просмотре справки вы можете в любом кадре нажать правую кнопку 
мыши, во всплывающем меню выбрать команду Сведения о разделе и увидеть 
окно (рис. 7.17 а), в котором указано название раздела (темы), окно, файл 
справки, исходный файл тестов (файл раздела) и идентификатор этого разде- 
ла. Сведения о файле и идентификаторе темы содержатся в этом окне, если вы 
при компиляции установили опцию |пфуде „Ш Непате апа юр Ш ш Нер Не. 
В том же меню, всплывающем при нажатии правой кнопки мыши в режиме 
Нер Ацшпог, вы можете установить опцию Запросы при ссылках. Тогда при каж- 
дом переходе от темы к теме будет появляться окно с запросом вида, представ- 
ленного на рис. 7.17 6. Это позволит вам отследить, в каких случаях и к каким 
темам осуществляется переход. . 


Сведения о разделе 


[а\ерАЗарНИ ЗМооб\еодЕНОВ Не М0] 


[6419 
Файпраздеа — [\аН\ер”\вериИ Зое во Торе. | 
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Справка Ут дом5 
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СЕ | 


а) 6) 


Рис. 7.17. Окна отладки справки в режиме Нер Ашпог: сведения о разделе (а) 
и о переходе (6) 
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7.3.3 Файл содержания — .сп* 


Файл Содержания (Сотепёз Ше), имеющий расширение ‚сп, является 
текстовым файлом, который можно проектировать с помощью М1сгозоЁ Нер 
УогЕк5Вор и присоединять его к файлу Проекта справки. Этот файл обеспечи- 
вает при работе со справкой страницу Содержание в окне справочной системы, 
в которой в виде пиктограмм открытых и закрытых книг и пиктограмм тем 
отражается структура справки. Чтобы создать новый файл содержания, надо 
в Нер У/огКзВор выполнить команду Ее | Мем и в окне Мем выбрать опцию 
Нер Сощепз. Откроется окно с загруженным в него файлом содержания. Вид 
этого окна можно видеть на рис. 7.18; только в первый момент все его окна ре- 
дактирования будут пустыми. 


Рис. 7.18 2, МисгозоЙ Нефр МогКк$Бор - нефрСопе.со  — 
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В верхних окнах надо задать: в левом — имя файла .Юр и.окно по умолча- 
нию (если оно определено в файле „.йр/)), отделив имя окна символом «>», в пра- 
вом — заголовок, который будет появляться в окне Содержание при работе 
справочной системы. Заносить информацию в эти окна можно непосредствен- 
но, но проще щелкнуть на верхней кнопке ЕС! и работать в открывающемся 
при этом диалоговом окне. 

Нижнее окно заполняется с помощью кнопок Ада АБо\уе и Ада Вею\м.. Пер- 
вая из этих кнопок вставляет новую строку выше той, в которой находится 
в данный момент курсор, а вторая — ниже этой строки. При нажатии любой 
из этих кнопок открывается окно Ед! Сотег!5 Таб Епну (см. рис. 7.19), в кото- 
ром вы можете задать очередной заголовок (Неа4та), отображающийся в виде 
книги, или очередную тему (Торс). Для заголовка указывается только его 
текст (Т!е). Для темы записывается ее название (Т!е), которое появится на стра- 
нице Содержание справки, и идентификатор темы (Торг 10), указанный в фай- 
ле тем. Если справка использует несколько файлов .Йр, то указывается также 
имя файла (Нер #е), содержащего данную тему. Может также указываться 
тип окна (\У/паом, 1уре) — одного из тех, которые указаны в файле проекта 
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(если они там указаны). Если отображение должно проводиться в окне по 
умолчанию, то вид окна не указывается. 

В этом окне можно также задать макрос (Масго) или включить внешний 
файл содержания (тсиде). Последнее позволяет легко видоизменять при необ- 
ходимости файл содержания, не переписывая его целиком, а включая в него 
какие-то дополнения, записанные в отдельных файлах. 


Рис. 7.19 ЕД Сопкепё$ ТаБ Ему 


` 


Задание очередного элемента Г Незфо С Ток С Маю Г ше 
файла Содержание 
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[о программе 


Вернемся к рис. 7.18 и рассмотрим остальные кнопки окна редактирова- 
ния файла Содержания. Кнопки Моуе Ка и Мо\уе 1еН позволяют сдвигать 
вправо и влево выделенные строки заголовков и тем, обеспечивая нужные от- 
ступы, характеризующие многоуровневую структуру. При этом строки тем, 
относящихся к одному заголовку, располагаются на один шаг правее своего за- 
головка и не могут сдвигаться друг относительно друга. Точнее, сдвинуть их 
можно, но это никак не отразится на их расположении при работе пользовате- 
ля со справкой. 

Кнопка ЕЧН позволяет редактировать выделенную строку, а кнопка Кетоуе 
удаляет строку. 

Файл содержания является обычным текстовым файлом, который можно 
редактировать в любом текстовом редакторе, например, в \У/ога. Ниже приведен 
текст этого файла, соответствующий тому, что вы можете видеть на рис. 7.18. 
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Содержание справки 

Программа 

Назначение программы=О программе 
Инструментальная панель=Панель 
Меню главное и всплывающее=Мепо 
Окно редактирования=Мето 
Система подсказок=Н1п* 
Стандартные диалоги=р1а1035$ 
Меню 

Главное меню=ММепи 

Меню Правка=Еа1е 

Меню файл=Е11е 

Макросы 

Демонстрация макросов=Масго 


шмшшмюшюшюшюшшошьн 


Из сравнения этого текста в рис. 7.18 видно, что первые две строки соот- 
ветствуют опциям, заданным в верхних окнах редактора М!сгозо Нер 
УМ/огкзПор, а дальнейшее — строки, соответствующие при просмотре справки 
пиктограммам книг и документов. Цифры в начале каждой строки обозначают 
уровень соответствующей строки при работе со страницей Содержание справ- 
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ки. При этом строки, соответствующие пиктограммам книг, содержат только 
начальную цифру, а строки, соответствующие пиктограммам документов, со- 
держат, помимо начальной цифры, идентификатор темы, указываемый после 
символа «=». 

Честно говоря, редактировать файл содержания в текстовом редакторе 
много удобнее, чем в редакторе М1сгозоЁ% Нер У!огКзВор. При этом легко ком- 
поновать последовательность строк, перемещать совокупности строк в другое 
место и т.п. Так что, создав в М1сгозо Нер УогКзБор заготовку файла, даль- 
нейшее его редактирование можно рекомендовать делать в \!ога. 


7.4 Связь приложения С++Вийаег со справочной 
системой 


Любое приложение должно предельно облегчать работу пользователя, 
снабжая его системой подсказок, помогающих сориентироваться в приложе- 
нии. Эта система включает в себя: 


в Ярлычки, которые всплывают, когда пользователь задержит курсор 
мыши над каким-то элементом окна приложения. В частности, такими яр- 
лычками обязательно должны снабжаться быстрые кнопки инструмента- 
льных панелей, поскольку нанесенные на них пиктограммы часто не на- 
столько выразительны, чтобы пользователь без дополнительной подсказ- 
ки мог понять их назначение. 


и Более развернутые подсказки в панели состояния или в другом отведен- 
ном под это месте экрана, которые появляются при перемещении курсора 
мыши в ту или иную область окна приложения. 


и Встроенную систему контекстно-зависимой оперативной справки, вызыва- 
емую по клавише [1]. 


и Раздел меню Справка, позволяющий пользователю открыть стандартный 
файл справки У/тао\з Пр, содержащий развернутую информацию по ин- 
тересующим пользователя вопросам. 

и Возможно также включение в заголовок окна формы кнопки «?», обеспе- 
чивающей ответы на вопросы типа: «Что это такое?». 


Организация всплывающих ярлычков и развернутых подсказок в панели 
состояния ЭфафазВаг достаточно хорошо известны (см. [1] и [6]). Так что эти 
составляющие справочной системы мы рассматривать не будем. А вот все, свя- 
занное со справочными файлами, стоит рассмотреть подробнее. 


7.4.1 Связь приложения с файлом справки, вызов тем справок 


Для связи приложения С++Ви!4ег с файлом „р надо выполнить команду 
Ргоес! | ОрНопз и в окне РеодесЕОр1опз(опции проекта) на странице АррйсаНоп 
(приложение) установить значение опции Нер Не, равное имени подготовлен- 
ного файла „р. Это приведет к тому, что в головном файле проекта появится 
оператор вида: 


Арр11са*1оп->Не1рЕ11е = "<имя файла.В1р>"; 


В этом операторе используется свойство НеарЕЦШе, определяющее файл 
справки, к которому обращается проект. Этот метод и подобный оператор 
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можно использовать в приложении в любом обработчике события, если в ка- 
кие-то моменты требуется сменить используемый файл справки. 

Если предполагается, что файл справки будет расположен в том же ката- 
логе, где находится само приложение, то имя файла и в окне Опции проекта, 
и в приведенном выше операторе надо задавать без указания пути. Иначе при- 
ложение, работающее на вашем компьютере, перестанет работать на компью- 
тере пользователя, у которого каталоги не совпадают с вашими. 

Если вы установили описанным способом связь приложения с файлом „р, 
то можете обеспечить в приложении контекстно-зависимую справку. Она позво- 
ляет пользователю нажать в любой момент клавишу Г!| и получить развернутую 
информацию о том компоненте, который в данный момент находится в фокусе. 
Для этого надо в каждом компоненте, для которого вы хотите это реализовать, 
задать свойства, обеспечивающие ссылку на соответствующую тему. 

Свойство Н@ерСотфцех& указывает номер связанной с компонентом темы. Это 
номер, который задается в проекте справки таблицей [МАР] (см. разд. 7.3.1.4), 
содержащей эти условные номера и соответствующие им идентификаторы тем. 
У компонентов имеется еще одно свойство — Н@арКеужога, позволяющее за- 
давать ключевое слово, содержащееся в сноске К (это обозначения тем, кото- 
рые видны в окне справки на странице Указатель). Свойство компонента 
НерТуре определяет, каким свойством — Не@ерСощехё или Не@ерКеумог@ за- 
дается ссылка на тему. Если Н@арТуре = В Сощехй — используется свойство 
НерСощехЕ; если НерТуре = Кеу\жог@ — используется свойство НеарКеу\чога. 

Правда, не всегда при русских ключевых словах вызов справки с задан- 
ным свойством Не@ерКеумог@ срабатывает. Так что можно рекомендовать для 
надежности всегда использовать свойство НерСощехё. 

Если значение НерСотц(ех& компонента равно нулю, то данный компонент 
наследует это свойство от своего родительского компонента. Например, для 
всех компонентов, размещенных на некоторой панели можно задать Н@рСоп- 
фех{ = 0, а для самой панели задать отличное от нуля значение НерСотщфехф, 
соответствующее теме, описывающей назначение всех компонентов панели. 

Предположим, что в вашей справке имеется тема, описывающая работу 
с окном редактирования Мето. В этой теме имеется сноска # с текстом 
«Мето», ссылка К с текстом «Окно редактирования» (см. рис. Т.2) и в таблице 
[МАР] задано (см. рис. 7.5 и Т.9), что этой теме соответствует идентификатор 5. 
Тогда если в окне Мето задать НерСотфехё = 5 и Н@ерТуре = В Сощехё, то 
при нажатии пользователем клавиши [| в окне Мето ему будет показана соот- 
ветствующая тема справки. Того же эффекта можно добиться, задав 
НерКеумог4 = Окно редактирования и Н@арТуре = ШЖеу\жог@. 

Если вам надо показать какую-то тему справки при щелчке пользователя 
на некоторой кнопке (обычно это кнопки Справка в различных диалоговых 
окна), это можно сделать несколькими способами. Можно использовать метод 
НерСощех{ объекта Арр|Псайоп: 


роо1 _ Еаз®са11 Не1рСопеехе (С1азз5ез: :ТНе1рСопфехе СопЕехе); 
Например: 
Арр11са&1оп->Не1рСоп+ех* (5); 


Задаваемые в таких операторах номера тем Сощехё аналогичны исполь- 
зуемым при задании свойств НерСощехё. Это номер той темы, которая пер- 
вой отобразится при открытии окна справки. А в дальнейшем пользователь, 
как обычно, может перейти, работая с программой справки, к любой интере- 
сующей его теме. 
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У объекта АррИсаНоп имеется также метод Нер/]атр: 
роо1 __Еаз®са11 Не1рУаптр (сопз$е Ап$156г1па датртр); 


Он выполняет действия, аналогичные Н@рСощехё, но его параметр Уитр О — 
не идентификатор темы, а имя соответствующей темы в файле справки, зада- 
ваемое в нем сноской #. Например: 


Арр11са*1оп->Не1р апр ("О программе"); 
Имеется также метод НерСоттапа: 


Еопсе1оп Не1рСотштапа (Соттапа: Мога; Баба: Топда1п®): Воо1еап; 


Он позволяет выполнить указанную параметром Соттап@ команду АРТ У/ш- 
Не с параметром Вафа. Метод генерирует событие ОпНер активной формы 
или приложения, а затем выполняет указанную команду У/шНер. Список 
команд \У/пНер вы можете найти в описании функции \УтНе]р в гл. 8. 

Имеется еще один способ обращения к файлу справки — функция 
\тНеТ: | 

ВООЬ М1пНе]1р (ТМ НИМР Р\паМа1п, ТМ ГРСЗТВ 1р$2Не]1р, 

ТМ ОТМТ аСоттапа, ТМ ОЪОМСб РТК амрака); 


Параметр В\УпЯМаш — дескриптор окна приложения, вызывающего 
\тНе. Параметр 1р$2Не!р — имя файла справки с полным путем к нему. 
Это имя может быть получено из свойства НерЕПе объекта АррИсайоп. Пара- 
метры иСоттапд и 4\Озжа идентичны параметрам Соттапа и Бава в методе 
НерСоттапд. 

Подробное описание функции \УтНе]р приведено в гл. 8. А пока рассмот- 
рим наиболее часто используемые варианты вызова функции У\УтНе]р и мето- 
да НерСоттапа. 

Отображение темы с указанным номером можно осуществить оператором 


И1пНе]1р (Напа1е, (Арр11сае1оп->Не1рЕ11е).с $6г(), НЕБР СОМТЕХТ, 1); 


или оператором 
Арр11са*1оп->Не1рСомтапа (НЕБР_СОМТЕХТ, 1); 


Приведенные операторы отображают тему с номером 1 в основном окне 
справки, в котором пользователь может далее открыть любую другую тему. 
В первом аргументе вызова функции \УтшНер после имени файла можно ука- 
зать символ «>» и имя вторичного окна, в котором следует отобразить тему 
справки. Это одно из имен окон, заданных в разделе [М//МОО\М/5] файла проек- 
та справки. Например, 


И1пНе1р (Напа1е, (Арр11са®1оп->Не1рЕ11е + ">\1").с з6г(), 
НЕГР СОМТЕХТ, 1); 


Ниже приведен оператор, отображающий ту же тему во всплывающем 
окне: 


И1пНе1р (Напа1е, (Арр11са®1оп->Не1рЕ11е).с_з%к(), 
НЕЬР СОМТЕХТРОРОР, 1); 


Применение метода НерСоттапЯ с параметром НЕГР СОМТЕХТРОРОР 
тоже допускается, но почему-то не всегда срабатывает. Так что все-таки функ- 
ция У\УтшНе надежнее. 

Отображая темы во всплывающем окне, надо иметь в виду, что тема не 
должна содержать непрокручиваемого заголовка (см. разд. 7.2.1). Иначе ото- 
бразится только этот заголовок. 
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Выше приводились примеры, ссылающиеся на тему с помощью ее номера. 
Это не очень удобно, так как если вы хотите сослаться на тему, для которой 
в таблице [МАР] файла проекта справки нет номера, вам придется изменять 
файл проекта и перекомпилировать справку. Можно ссылаться на тему по ее 
ключу — тексту, содержащемуся в К-сноске: 


И1пНе]1р (Напа1е, (Арр11сак1оп->Не1рЕ1]е).с_з%г(), НЕГР _КЕУ, 
(ипз1апеЯ 1опа) "Меню"); 


ИЛИ 


Арр11са&1оп->Не1рСотмтапа (НЕБР_ КЕУ, (ипз1апеа 1опач) "Меню"); 


В этих примерах дана ссылка на ключ «Меню». В подобных операторах 
можно ссылаться и на двухуровневый ключ (см. разд. 7.2.2.2). Например: 


И1пНе1р (Напа1е, (Арр11сав1оп->Не1рЕ11е).с_з6г(), НЕПШР КЕУ, 
(илзтапеа 1опа) "Меню Правка, Вырезать"); 


Если указанному ключу, заданному в предыдущих примерах, соответству- 
ет несколько тем, пользователю будет показано диалоговое окно Найденные 
разделы, в котором он сможет выбрать то, что его интересует. А если заданного 
ключа в справке нет, отобразится страница Предметный указатель, в окно редак- 
тирования которой будет занесен текст заданного ключа. Этим можно пользо- 
ваться, если надо открыть не какую-то тему, и просто страницу Предметный 
указатель, ничего в окно не занося. Для этого надо задать пустую строку в при- 
веденных операторах. Например: 


И1пНе1р (Напа1е, (Арр11са&1оп->Не1рЕ11е).с_56г(), НЕГР КЕУ, 
(ипзтапеа 1опа)""); 


или 


Арр11са*1оп->Не1рСомтапа (НЕГР КЕУ, (ипз1апеа 1опд)""); 


Подобные операторы имеет смысл реализовывать в традиционном разделе 
меню Справка. Впрочем, в подобных операторах можно использовать другой 
код команды — НЕЕЁР_ЕПМ\МОЕНВ: 


И1пНе1р (Напа1е, (Арр11саЕ1оп->Не1рЕ1]1е).с_5зех(), НЕГР ЕТМОЕВ, №015); 


ИЛИ 
Арр11са*1оп->Не1рСопщмапа (НЕБР_ЕТМРЕВ, МОТ); 


Отличие от приведенных ранее операторов заключается в том, что в дан- 
ном случае отобразится или страница Содержание, или страница Предметный 
Указатель в зависимости от того, какую из этих страниц пользователь открыл 
последней в предыдущем сеансе работы со справкой. 


Если приложение вызывало справку, желательно перед закрытием данно- 
го приложения (например, в обработчике события Оп)е$ гоу) выполнить ко- 
манду с кодом НЕГР @Т: 


И1рпНе1р (Напа1е, (Арр11саЕ1оп->Не1рЕ11е).с_зег(), НЕБР ОПОТТ, МО); 


Это скажет системе, что данное приложение не нуждается более в справке. 
Когда не останется ни одной ссылки на справки, система закроет \У/шНе|р. 


Помимо рассмотренных, имеется еще один вариант работы с файлом 
справки — свойство Нер$узет объекта АррИсайоп. Это свойство дает дос- 
туп к интерфейсу 1Нер5Эуз&ет, который, в частности, имеет методы ЭВомТо- 
раеНе№ и ЗВомСощех{ Не]: 
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У1г6иа] уо1а _ Еаз6са11 ЗпомТор1сНе]1р (сопзЕ Апз156г1п9 Тор1с, 

соп5Е Ап$156г1па Не]1рЕ11еМапе); 
%У1г6ца1 уо1а _ Еаз®са11 5помСопеехеНе1р (сопзЕ 1пе Сопеехетр, 

соп5Е Ап$156г1па Не1рЕ11еМапе); 


В них передается в качестве Н@йрЕПЦеМате — имя файла „Юр. В качестве Торис 
передается идентификатор соответствующей темы в файле справки, задаваемый 
в нем сноской # (не спутайте с текстом сносок К), а в качестве Сощех О — но- 
мер темы. Например: 


Арр11саЕк1оп->Не1рбузЕет->5ПомТор1сНе1р ("Мето", 
Арр11сае1оп->Не1рЕ11е); 


или 


Арр11са®*1оп->Не1р5узкеп->5ВомСоп$ехеНе1р (5, Арр11саЕ1оп->Не1рЕ11е); 


Таким образом, имеется множество способов отображения заданной темы 
справки: методы НерСощехё и НерТатр объекта АррПеайоп, метод 
НерСотшап и функция УшНе с командой НЕГР _СОМТЕХТ, методы 
Зво\ТореНер и ЗВо\Сощех{Нер интерфейса 1НерэЭузет. Все они эквива- 
лентны, но, может быть, надежнее других функция АРТ У/тдомз \УтНер, 
безусловно работающая в любых версиях УЛ тдожз. 


7.4.2 Темы справки во всплывающих окнах, кнопка «?» 


Иногда желательно, чтобы тема справки, вызываемая по клавише [1], по- 
казывалась не в обычном, а во всплывающем окне. Это позволяет пользовате- 
лю, не покидая окна приложения, получить подсказку, более развернутую, 
чем подсказки во всплывающих ярлычках, задаваемых свойствами НП\. В ча- 
стности, это используется в кнопке «?», которую можно поместить в заголовок 
окна и которая позволяет отвечать на вопросы типа: «Что это такое?». Нали- 
чие этой кнопки открывает широкие возможности управления отображением 
контекстной справки, в частности, отображение тем во всплывающих окнах. 

Для того чтобы включить кнопку «?› в форму во время проектирования, 
надо установить в фгае элемент ЫНер ее свойства Вог4егТсоп$. Во время вы- 
полнение то же самое можно сделать следующим кодом: 

ТВогаегТсопз фетшрВТ = ВогаегТсопз; 


сепрВт << Б1Не1р; 
ВогаегТсоп$ = фепрВТ; 


Указанные операции включат в форму кнопку «?», но это еще не значит, 
что она будет видна. Видимость кнопки обеспечивается при наличии одного из 
следующих двух условий: в свойстве Вог4есоп$ формы не заданы кнопки 
свертывания и развертывания, или свойство формы Вогдег5{Уе задано рав- 
ным 65П1а]юр. | 

Если кнопка «?» видна, то пользователь может щелкнуть на ней, а затем 
щелкнуть на любом оконном компоненте. При этом вызовется справка с те- 
мой, указанной в свойстве НерСощехё компонента при установленном в его 
свойстве НерТуре значении № Софех&. Если заданных значений НерСощех& 
и НерТуре в компоненте нет, то никакая тема справки не вызывается. 

Независимо от того, видна, или не видна кнопка, ее введение в форму при- 
водит к тому, что при запросе контекстной справки этой кнопкой или клави- 
шей Г| генерируется событие формы ОпНе№. Заголовок этого обработчика 
имеет вид: 
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роо1 _ Еаз®са11 ТКогт1: : ГогиНе1р (МОВО Сомтапа, 1п& Вафа, 
Боо1 &Са11Не1р) 


Параметр Соттап4@ указывает команду, которую надо передать в \У/пНе]р, 
параметр Вафа — данные, соответствующие этой команде. В параметр СаЙНер 
следует занести Ё#а]зе, если отображение темы уже осуществлено в обработчике 
и дальнейшее обращение к УшНе] не требуется. Если после выхода из обра- 
ботчика СаЙНе!р = фгпие, то далее будет вызвана функция УтшНе]. Это приве- 
дет к отображению темы в обычном окне справки. 

Обработчик события ОпНе должен возвращать &ёгие, если обработка ко- 
манды закончилась успешно. 

При вызове справки в приложении, содержащем видимую или невидимую 
кнопку «?», в обработчик события ОпНер сначала передается команда 
НЕГР _ЗЕТРОРОР_РОЪ. Эта команда, не описанная ни в справке по С++Ви!|-- 
ег, ни в справке по АРТ \У/114о\з, задает системе \У/тНе!р координаты всплы- 
вающего окна, в котором при следующем вызове справки следует отображать 
тему. Координаты окна определяются параметром Ва$ёа, в котором младшие 
разряды определяют координату Х окна, а старшие — координату У. Автома- 
тически эти координаты задаются так, что середина верхней грани окна разме- 
щается ниже левого верхнего угла компонента, справка о котором затребова- 
на. Если справка вызывается клавишей [!|, то компонентом, справка о кото- 
ром будет выдана, является компонент, находящийся в фокусе. А если справ- 
ка вызывается кнопкой «?», то этим компонентом является тот, на котором 
щелкнул пользователь. 

В С+-+Ви|аег 6 и предшествующих версиях всплывающее окно при вызове 
клавишей Г! | или кнопкой «?» размещается одинаково, как описано выше: се- 
редина верхней грани окна размещается ниже левого верхнего угла компонен- 
та. В С++ВиИаег 2006 при вызове клавишей Г!| окно размещается так же, 
а при вызове кнопкой «?» середина окна определяется координатами той точ- 
ки, в которой проведен щелчок курсором мыши. 

После завершения обработчика события ОпНер с командой НЕГР_ЪЗЕТ- 
РОРОР_РО$, обработчик вызывается повторно с командой НЕГР СОМТЕХТ- 
РОРОР. При этом параметр Ваёа содержит номер темы справки, заданный 
в компоненте свойством Не@ерСощех&. 

Таким образом, если вы хотите, чтобы контекстно-зависимые темы справ- 
ки отображались всегда во всплывающем окне, то при наличии в форме види- 
мой или невидимой кнопки «?» обработчик события формы ОпНер может вы- 
глядеть так: 


роо1 __Еаз®са11 ТГогм1: : ЕогиНе1р (МОВР Сотмтапа, 1пе Рафа, 
Боо1 &Са11Не1р) 


{ 

И1пНе1р (Напа1е, (Арр11са&1оп->Не1рЕ11е).с _з6г(), Сомтапа, Рака); 
Са11Не]1р = Еа15$е; 

гесагп &гце; 


} 


Все темы справок будут отображаться во всплывающих окнах, причем эти 
окна будут привязаны к левому верхнему углу компонента. 

Если вы хотите изменить положения окон, вам надо изменить при получе- 
нии команды НЕГР ЗЕТРОРОР_РО$ полученное значение Оаа. Например, 
если вы включите перед вызовом УшНер приведенные ниже операторы, то 
все окна сдвинутся на 20 пикселов вниз: 


1Е (Соштапа == НЕБР_ЗЕТРОРОР РОЗ) 
Рафа = МАКЕБОМС (ТОМОВР (Рафа), НТМОВР (Рака) + 20); 
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В этом операторе в случае команды НЕГР ЗЕТРОРОР_РО5 формируется 
измененное значение аа. Формирование осуществляется макросом МАКЕ- 
ГОМС, в который передаются два параметра: значение младшего слова и зна- 
чение старшего слова. Младшее слово остается неизменным — с помощью 
макроса ГО\МОВО оно извлекается из значения Раёа. А значение старшего 
слова, извлеченное макросом НГУОВЮ, увеличивается на 20. 

В следующем разделе будет показан более сложный обработчик события 
ОпНе, обеспечивающий отображение темы в стандартном окне справки при 
использовании клавиши [1], и отображение во всплывающем окне при исполь- 
зовании кнопки «?». А чтобы завершить данный раздел, посмотрим, как мож- 
но обеспечить подсказку во всплывающем окне, вообще не вводя в приложе- 
ние кнопку «?». 

Пусть, например, мы хотим для многострочного окна редактирования 
Мето или Вале БЕЯ обеспечить отображение какой-то темы справки во всплы- 
вающем окне при нажатии пользователем клавиши Г!|. Причем хотим, чтобы 
всплывающее окно размещалось под окном редактирования. Ниже приведен 
обработчик события ОпКеуВо\мт окна редактирования, который реализует по- 
добную возможность: 

1Е(Кеу == УК Е1) 


{ 
ТРо1пЕ Р = ((ТМ1пСопего1 *) бепаег) ->С11епЕОг1а1п; 


И1пНе1р (Напа1е, (Арр11са1оп->Не1рЕ11е).с $56г(), 

НЕГР ЗЕТРОРИР_РО$, 

МАКЕГОМС (Р.х, Р.у + ((ТМ1пСопЕго1 *) Зепаег) ->Незап*)); 
И1пНе1р (Напа1е, (Арр11са*1оп->Не1рЕ11е).с_зег(), 

НЕГР _СОМТЕХТРОРУР, 

((ТИ1пСопего1 *) Зепаег) ->Не1рСопеех®); 
} 


Обработчик написан в общем виде, так что годится для любых оконных 
компонентов. Первый оператор запоминает в переменной Р координаты левого 
верхнего угла компонента. Второй оператор вызывает УтНер с командой 
НЕГР_5ЕТРОРОР_РО$, задающей координаты всплывающего окна. Коорди- 
‘наты формируются макросом МАКЕГОМС. Координата Х берется равной со- 
ответствующей координате компонента, а координата У сдвигается на высоту 
компонента. Третий оператор вызывает \УтНефр с командой НЕГР_СОМ- 
ТЕХТРОРОР, передавая в функцию значение свойства НерСот(цех& компо- 
нента. 

Следует отметить, что для того, чтобы приведенные операторы правильно 
срабатывали, компонент должен быть определенным образом настроен. В его 
свойстве НерСощехё надо указать номер темы, который в приведенном коде 
передается в вызов функции УтшНе. А чтобы это свойство не срабатывало 
стандартным образом, надо задать свойство НерТуре компонента равным 
В{Кеу\мога. Иначе, помимо отображения темы во всплывающем окне, она же 
отобразится и в обычном окне справки. 

Завершая рассмотрение отображения тем во всплывающих окнах, надо на- 
помнить оговоренное в предыдущем разделе — тема, отображаемая во всплываю- 
щем окне, не должна содержать непрокручиваемого заголовка (см. разд. 1.2.1). 
Иначе в окне отобразится только этот заголовок. 
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7.4.3 Демонстрационный пример работы со справочной 
системой 


Ниже рассмотрен пример (проект РНе в каталоге Нер на приложенном 
к книге диске), который демонстрирует организацию справочной системы. Но 
прежде чем говорить об этой системе, стоит сказать несколько слов о самом 
приложении. Оно представляет собой редактор на основе компонента 
В1е ВЕЧЕ. Несмотря на то, что в нем реализовано достаточно много операций 
(см. на рис. 7.20 инструментальную панель окна), в нем нет ни одного операто- 
ра, касающегося основной работы. Все операции осуществляются с помощью 
стандартных действий, список которых содержится в компоненте Ас#0пГ1$. 
Так что те немногие операторы, которые будут далее описаны, относятся толь- 
ко к демонстрации работы со справочной системой. 


-: Пример прияожения. 


шзил Правка Формат 


‚ Это документ № 1 
_ текст данного документа! 


Окно редактирования 
позволяет редактировать текст 
документа. В нем реализованы 
стандартные сочетания быстрых 
клавиш. 


ричи нии Рори приз 


[Окно подготовки документа ня окно справки, и, ? - всплывающее 


| — ВЕЕР 


Рис. 7.20. Приложение, демонстрирующее организацию справочной системы 


Во всех объектах стандартных действий переведены, естественно, на рус- 
ский язык надписи (СарНоп) и тексты подсказок (Н1и®). Соответственно кноп- 
ки инструментальной панели и разделы меню ссылаются на имеющиеся дейст- 
вия. В инструментальной панели Тоо]Ваг свойство ЭВомНш установлено 
в фгие, что обеспечивает отображение всплывающих ярлычков кнопок при за- 
держке над ними курсора мыши. 

Внизу окна приложения расположена полоса состояния ЗнашеВаг, в кото- 
рой создано две панели. В первой должны отображаться вторые части свойства 
Ни кнопок инструментальной панели и других компонентов. Для этого 
в компоненте 5Э$фафи$Ваг1 установлено в фгие свойство АщжоНи. Иногда этого 
достаточно для отображения подсказок в первой панели. Но не всегда это сра- 
‘батывает. Поэтому в приложение введен компонент АррПсаНопЕуепф®, и в об- 
работчике его события ОпНП\ записан оператор: 


ЗЕасизВаг1->Рапе1$->Т+емз [0] ->ТехЕ = Арр11са*1оп->Н1пе; 


Этот оператор гарантирует отображение подсказок в первой панели компо- 
нента ЭфафизВаг1. 
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Приложение связано с файлом справки Еаййер.НШр, расположенном в том 
же каталоге, в котором находится проект. На рис. 7.21 показаны некоторые 
окна этой справки. Конечно, данная справка не преследует цель пояснить ме- 
тодику работы с приложением и отнюдь не является образцом разработки на- 
стоящих справок. Ее единственной целью является иллюстрация некоторых 
возможностей справок. 


Нер Горк$: Пример редактора | -. И р р. а) 


"Согвиие | 1пдех | Ред | 


СКК а орк, эл ел сво Оврау, Ог вок апофег ЧБ, зисн аз |пдех 


Содержание справки 
[1 Программа 
Назначение программы 
Инструментальная панель 
Меню главное и всплывающее 
Окно редактирования 
Стандартные диалоги 
та Гнст ет13 подсказок. 
Общее описание 
Е Кнопка "Всплывающее окно" 
в Кнопка "Комбинация окон" 
{® Кнопка "НЕЦР_КЕУ" 
[3] Окно задания темы 


Ц Меню 


[3] Главное меню 


РЕЯ 


нер Торк$: Пример редактора | р ,. те г з |2 | 6) 


‘бо | а | гиё | 


К аюрк, ап еп ск Оерыу. О: сек апофена, зи аз пфех. 


Содержание справки 

(р Программа 
Назначение программы 
Инструментальная панель 
Меню главное и всплывающее 
Окно редактирования 
Стандартные диалоги 

(2 Гистер1а подс а ок. 

2] Общее описание 
13] Кнопка 'Всплывающее окно" 
2] Кнопка "Комбинация окон" 
? Кнопка "НЕЦР_КЕУ" 
2] Окно задания темы 


(ПС меню 


[2] Главное меню 


Рис. 7.21. Справка ЕаИНер: окно Содержание (а), окно Указатель (6), одна из тем (в), 
окно выбора темы (г), окно информации о версии справки (д) 
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2, 3 (Неф Ао би) 


Не ЧА „Воскглаук ОрНоп5 Нар Выхсд 


С Е О ОЕ ее ОР ОИ 


ИНСТРУМЕНТАЛЬНАЯ 


ПАНЕЛЬ 


Ы. 


ТАНИ 
На инструментальной панели располагаются быстрые 
кнопки, дублирующие команды меню. 


Например, 
кнопка М дублирует команду "Открыть ..." из маню Файл, 
кнопка № дублирует команду "Сохранить как..." ит.д. 


замечание по реализации 


’? 


тема имеет сноски: 
Тоо1Вакг . 
Инструментальная панель В 
Инструментальная панель в 
Тоо1Вак : 


Кнопка "Открыть 
включена в файл темы в виде 
изображения. А кнопка 
"Сохранить как " 
отображается командой "рис 
ЗауеАз. Бар". 


оч м 


в) 


Торк$ Еоипд 


СВК а юр. еп сек Ору, 


Гизвное н вс плеьлЕаюиш ее вленно 
О программе чег5гоп иогллаНоп 
Система подсказок 
`Меовой Улебоне НЫ 
5.1.2600.11065 - 


| Сор ® 1990-2000 Мрсловой Сор, 


ТЕСТ НЕГР, ВЕРСИЯ 1, 
`Тругздау, Магср 09, 2006 09:36:43 


г) д) 


Рис. 7.21. Справка ЕаИВер: окно Содержание (а), окно Указатель (6), одна из тем (в), 
окно выбора темы (г), окно информации о версии справки (д) 


Обратимся, например, к теме «Инструментальная панель», изображение 
которой показано на рис. 7.21 в. Текст этой темы выглядит так: 


УКА ИНСТРУМЕНТАЛЬНАЯ _ПАНЕЛЬ- 
см. также! пе (0 постолмие рита М, алии, порох пращи: 


На инструментальной панели располагаются быстрые кнопки, дублирующие 
команды меню. 
Например, 
— 
кнопка Ро дублирует команду "Открыть ..." из меню Файл: :=, 
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кнопка {Бтс ЗауеАз$.Ютр} дублирует команду "Сохранить как..." ит.д. 
Замечание по реализации и 


Замечания по реализации Не1р::: 


Тема имеет сноски: 

* Тоо1Ваг 
Инструментальная панель 
Инструментальная панель 
Тоо1Ваг 


>; им 


Рассмотрим некоторые элементы приведенного текста. Первые две строки 
отмечены признаком «не отрывать от следующего» (см. разд. 7.2.1). Так что 
они располагаются в непрокручиваемой области окна. Во второй строке ссыл- 
ка «см.также» реализована макросом АЦипк (см. разд. 7.2.3.2), в котором пере- 
числены идентификаторы ссылок А (см. разд. 1.2.2.4) нескольких тем. Так 
что при щелчке на ссылке «см.также» пользователь увидит окно, показанное 
на рис. 7.21 г. В нем он сможет выбрать интересующую его тему или отказать- 
ся от перехода на другую тему. Строки, отражающиеся в этом окне — это тек- 
сты ссылок $ тех тем, на которые указывает макрос АЙпЕЁ. 

Окно, показанное на рис. 7.21 в, содержит два изображения кнопок. Пер- 
вая из них вставлена как изображение в текст справки. А вторая реализована 
командой {Рис бауеАз.ютр} (см. разд. 1.2.1, в котором описаны отличия 
этих двух подходов). 

Ссылка «меню Файл» реализована прямым указанием идентификатора 
ссылки # одной из тем справки — ЕШе. Ссылка «Замечание по реализации» 
(чисто демонстрационная) также реализована указанием на ссылку # одной из 
тем справки — ВиЙоп. Но тут еще содержится указание на отображение темы 
во вторичном окне \Т1. Это окно (вы его видите справа внизу на рис. 7.21 в) 
описано в рассмотренном далее файле проекта. Еще одна чисто демонстраци- 
онная ссылка «Замечания по реализации Нер» отличается от предыдущих 
тем, что имеет одинарное подчеркивание, означающее отображение во всплы- 
вающем окне (слева внизу на рис. 7.21 в). 

Тексты остальных тем справки вы можете посмотреть в файле Тор{сз.г{] на 
диске, приложенном к книге. Например, в чисто демонстрационной теме 
«Макросы» вы увидите кнопки, при щелчках на которых вызываются различ- 
ные программы. Текст, обеспечивающий появление этих кнопок, следующий: 

{Раббоп Дата/время, Сопёго1Рапе1 (Т1медафе) } 

Запуск элемента Контрольной Панели Дата/время. 

{Роебоп Калькулятор, ЕхесЕ11е (Са1с.ехе) } Запуск Калькулятора. 

{раббоп Тор1с5.хЕЁЕ, ЕхесЕ11е (Тор1с5.гЕЕ) } 

Открытие файла Тор1с$.г%Е. 


{рабеоп Мобера@, СоруТор1с () :5ПогЕСиа® (побераЯ, поеераа, 0х0302) } 
Запуск МофераЯ с данной темой, переданной через буфер обмена. 


В этом тексте использованы команды «{роаефол ›» (см. разд. 7.2.1 и 7.2.4) с раз- 
личными макросами. 

Содержание окна Указатель (рис. 7.21 6) определяется ссылками К в раз- 
личных темах справки. Например, в теме «Главное меню» имеется ссылка К 
вида: «Главное меню; Главное меню,Шрифт; Главное меню,?; Меню». Эта 
ссылка приводит к отображению строк 


Главное меню 
г 


Шрифт 
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в окне Указатель, которое вы видите на рис. 7.21 6. Две другие строки, которые 
видны в окне Указатель в разделе «Главное меню», относятся к двум другим те- 
мам, содержащим ссылки К вида «Главное Меню, Меню Файл» и «Главное 
Меню, Меню Правка». | 


Теперь рассмотрим текст файла содержания справки НефрСоп.сп$, обеспечи- 
вающего отображения окна Содержание, которое вы можете видеть на рис. 7.21 а. 
Ниже приведен текст этого файла: 


:Вазе Еа1еНе1р.П1р>та1п 

:Т16]е Пример редактора 

Содержание справки 

Программа 

Назначение программы=О программе 
Инструментальная панель= Тоо]1Ваг 
Меню главное и всплывающее=Мепи 
Окно редактирования= В1срЕЯ1е 
Стандартные диалоги=О1а1очз 
Система подсказок 

Общее описание=Н1п+ 

Кнопка "Всплывающее окно"= брееаВае®оп1 
Кнопка "Комбинация окон"= ЗрееаВа* в оп2 
Кнопка "НЕГР КЕУ"= НЕГР КЕУ 

Окно задания темы = Еа11 

Меню 

Главное меню=ММепи 

Меню Правка=Еа1& 

Меню файл=Е1]1е 

Макросы 

Демонстрация макросов=Масго 


шш,шшшшююю ююююоюоюшоыошш 


Сопоставив этот текст с рис. 7.21 а, вы можете увидеть особенности реализа- 
ции вида окна Содержание. 


В заключение рассмотрения файлов справки остановимся на файле проек- 
та Еапрпер.йр] этой справки. Ниже приведен текст этого файла: 


; ТЬ15$ Е11е 15$ ма1пка1пеа Бу НСМ. Ро пое моа1Еу %51$ Е11е а1гесЕ1у. 
[ОРТТОМ$ ] 

СОМРВЕ$5=12 На11 деск 

ЬСТО=0х419 0х2 0х0 ; Русский 
ВЕРОВКТ=Уе$ 

СОМТЕМТ$ =Содержание 

ТТТЬЕ=Редактор 

СМТ=Не1рСопе . спе 

СОРУВТСНТ=ТЕСТ НЕГР, ВЕРСИЯ 1, %А4аке 
СТТАТТОМ=—— Тест НЕГР —— 
НЬР=ЕА1*Не]1р.В]1р 


[ЕТЬЕЗ ] 

Тор1с5.ЕкЕЕ 

[МАР] 

О программе=1 ; О программе 
В1срЕа1е=2 ; Окно редактирования 


В1спЕЯ12=3 
брееЯВиеоп1=4 
брееаВа& оп2=5 


Окно редактирования 
Кнопка "Всплывающее окно" 
Кнопка "Комбинация окон" 
НЕБР КЕУ=6 Кнопка "НЕГР КЕУ" 
НЕГР_КЕУ2=7 Кнопка "НЕГР КЕУ" 

Еа11=8 ; Окно названия темы 
Еа1е2=9 ; Окно названия темы 


<“. че. %. че. ч5 
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[ИТМООЙ$ ] 
; Дополнительное окно _ 
И1="Вспомогательное окно справки", 
(97,133,286, 494) ‚20736, (х14876671), (112632256) ,ЕЗ 
па1п="Тест справки", (240,184,619,629) ,27904,,,{2; Главное окно 


[СОМЕТС] 

СгеафеВае оп ("Н1$$огу", "&История", "Н1зЕокгу ()") 
Вгом5еВа®®оп$ () 

Тпзег%Мепо ("мех1{", "Выход", 5) 

АррепаТ*ем ("тех1{", "ех1е", "Выход", "ех1® ()") 


[РОМТ$] 

=,,204 

Строки раздела [ОРТ1ОМ $] задают общие характеристики справки. Стоит 
обратить внимание на опции Г.СТО (задает, совместно с разделом [ЕОМТУ] фай- 
ла, русский язык) ,‚ СМТ (задает имя файла содержания) и НГР (задает имя ре- 
зультирующего файла справки). Опция СОРУЩСНТ задает текст, который 
пользователь увидит в окне информации о версии справки (две нижние строч- 
ки на рис. 7.21 д), если выберет в окне любой темы раздел меню Нер | Уегуюп. 
Дата, которую вы видите в этом окне, отображается элементом %асе опции 
СОРУЮСНТ. Опция СТГАТТОМ задает текст, которым будет завершаться лю- 
бое копирование текста из темы справки — разделом меню Ед! | Сору или кла- 
вишами С}!-С. В данном случае копирование завершится текстом: 


------ Тест НЕГР ------ 


Чаще всего, эта опция задается в демо-версиях приложений, чтобы пользова- 
тель не забывал, что надо бы приобрести полноценную версию программы. 

Раздел [Е П.ЕЗ] файла содержит список файлов тем — в данном случае все- 
го один файл. Раздел [МАР] задает идентификаторы ряда тем, которые далее 
могут использоваться в приложении в свойствах НерСощехй компонентов. 
Для ряда тем (например, для окна редактирования) указано по два идентифи- 
катора. Как будет видно далее, это связано с одним из режимов работы тесто- 
вого приложения, в котором тема справки может отображаться или в стан- 
дартном окне справки, или во всплывающие окне. Соответственно в справке 
предусмотрено для такого случая по 2 темы: одна с подробным описанием для 
стандартного окна, и другая для всплывающего окна — с кратким описанием 
и отсутствие непрокручиваемой области. 

Раздел [\МИМООМ 5$] описывает окна справки (см. разд. 7.3.1.2). Помимо 
основного окна с идентификатором та, в справке указано еще дополнитель- 
ное окно с идентификатором \1. Использование этого окна уже было рассмот- 
рены ранее (окно справа внизу на рис. 7.21 в). 

Раздел [СОМЕТС] содержит ряд вспомогательных и необязательных оп- 
ций, некоторые из которых введены в проект просто в иллюстративных целях. 
Первый оператор этого раздела создает кнопку История, которую вы можете 
видеть в окне на рис. 7.21 в. Такая кнопка на мой взгляд всегда полезна. Хотя 
в стандартном меню справки имеется аналогичный раздел, но пользоваться 
кнопкой История удобнее. Второй оператор раздела создает кнопки просмотра, 
которые вы можете видеть правее кнопки История на том же рис. 7.21 в. Эти 
кнопки доступны в тех темах, в которых имеется сноска + (см. разд. 7.2.2.5). 

Два следующих оператор носят чисто демонстрационный характер. Они 
показывают, как можно ввести в окно справки новое меню и его разделы. 
В данном случае вводится меню Выход, которое вы можете видеть в полосе 
меню на рис. 7.21 в. 
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Теперь, рассмотрев особенности справки, вернемся к описанию тестового 
приложения, показанного на рис. 7.20. Раздел меню и кнопка инструменталь- 
ной панели, обеспечивающие отображение справки, реализованы с помощью 
стандартного действия класса ТНерСошет{$. Это действие обеспечивает вы- 
зов страницы Содержание (рис. 7.21 а) или страницы Указатель (рис. 7.21 6) 
в зависимости от того, какая из этих страниц вызывалась последней. 

Все компоненты окна приложения связаны своими свойствами Не@ерСоп- 
фехё с темами, указанными в проекте справки в разделе [МАР]. Свойства 
НерТуре этих компонентов заданы равными ВСощех&. Так что нажатие кла- 
виши [Е] в момент, когда тот или иной компонент находится в фокусе, приво- 
дит к отображению темы, описывающей данный компонент, в обычном окне 
справки. | 

Элементы в нижней части окна приложения (рис. 7.20) носят демонстра- 
ционный характер. В реальном приложении они не нужны. А в данном приме- 
ре эти элементы показывают варианты работы со справками. 

Кнопка Всплывающее окно реализована компонентом Зрее4ВиНоп. Нажа- 
тие пользователем этой кнопки приводит к тому, что внешний вид компонента 
не изменяется, но при нажатии клавиши !| темы справки показываются во 
всплывающих окнах. Если отпустить кнопку Всплывающее окно, темы справки 
опять начинают показываться во стандартном окне. 

Обработчик щелчка на кнопке имеет вид: 


Уу01Аа __Еаз®са]1] ТРГогм1 ; : брее4Виеоп1С11сКк (ТОБ]есе *5епаег) 


{ 
1Е (брееаВае®оп2->Помп) 


{ 
брееаВо*оп1->Роип = Еа15е; 
гесигп; 


} 
ТВогаегТсопз фепрВТ = ВогаегТсопз; 
1Е (ЗрееаВи®$оп1->Помп) 


{ 
сетрВТ << р1Не]1р; 
ЗЕабо$Ваг1->Рапе1$->Теемз [1] ->ТехЕ = 
"Всплывающая контекстная справка"; 


} 


е1 зе 


{ 
Сепрвт >> Ь1Не1р; 
Сбаба$Ваг1->Рапе1$->Т6емз [1] ->ТехЕ = 
"Контекстная справка в окне справки"; 


} 


ВогаегТсопз$ = фепрВТ; 
} 


Первый оператор проверяет, нажата ли кнопка Зрее4ВиЦоп2. Это кнопка 
Комбинация окон, которую вы видите на рис. 7.20 и которая будет описана позд- 
нее. Кнопка Зрее4ВиЙ_оп1 не должна работать, если нажата кнопка 
ЭЗрееЯВивоп2. Это и осуществляется первым оператором 1. 

Последующие действия зависят от того, нажата ли кнопка ЭреедВиЙоп1. 
Если нажата, то в заголовок формы (в свойство Вог4есоп$) заносится кнопка 
«?», а во вторую панель полосы состояния заносится текст: «Всплывающая 
контекстная справка». Если же кнопка Эрее4ВиНоп1 отпущена, то из заго- 
ловка формы удаляется кнопка «?», а во вторую панель полосы состояния за- 
носится текст: «Контекстная справка в окне справки». 

Форма приложения имеет стиль бордюра (Вог4дег5{е), равный 
Ъ5512еаШе, и в число кнопок (в свойство Вог4еШсоп$) включены кнопки свер- 
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тывания и развертывания окна. Поэтому, как указывалось в разд. 7.4.2, кноп- 
ка «?» не видна, даже если она включена в множество Вог4егсоп$. Значит, 
при нажатии кнопки Эрее4ВиЙоп1 внешне ничего не меняется. Но если поль- 
зователь нажимает клавишу Е], то генерируется событие формы ОпНе]р, кото- 
рое ранее не генерировалось. И обработчик этого события позволяет управлять 
отображением справки. Фрагмент обработчика события ОпНер, срабатываю- 
щий при нажатой кнопке ЗрееЯВиЙоп1, имеет вид: 

роо1 _ Еаз®са11 ТЕогп1: : ГогаНе1р (МОКР Сомтапа, 1пе Рака, 

Боо1 &Са11Не]1р) 
{ 


1Е (Сопмара == НЕЬР СОМТЕХТРОРУОР)`Рафа++; 

И1пНе1р (Напа1е, (Арр11са&1оп->Не1рЕ11е).с_5Ег(), 
Сомтапа, Рака); 

Са11Не1р = Ёа1$е; 

геогр &гое; 


} 


Если команда равна НЕГР СОМТЕХТРОРОР, т.е. задается отображение 
во всплывающем окне (см. разд. 7.4.2), то значение Вафа, которое в данном 
случае содержит идентификатор темы, заданный свойством НерСощех{ ком- 
понента, увеличивается на 1. Выше уже говорилось, что для тем, относящихся 
к компонентам, в файле проекта справки задано по 2 идентификатора: первый 
для варианта, отображаемого в обычном окне справки, а второй на 1 больший 
соответствует сокращенному варианту для отображения во всплывающем 
окне. В свойствах Не@ерСожщехё компонентов записаны первые идентификато- 
ры. Таким образом, прибавление к ним 1 задает для отображения сокращен- 
ные варианты тем. | 

Следующий оператор обработчика события ОпНе вызывает функцию 
\М/ЛтпНер, передавая в нее имя файла справки, команду Соттап@ и значение 
аа. Следующий оператор задает СаЙНер равным #а1зе, запрещая дальней- 
шую стандартную обработку команды. | 

Тепрь рассмотрим кнопку Комбинация окон  (ЗреедВи оп?) приложения. 
Нажатие пользователем этой кнопки приводит к появлению в заголовке окна 
кнопки «?». И реализуется вариант контекстной справки, в котором нажатие 
клавиши !Г| приводит к отображению полной темы в стандартном окне, а ис- 
пользование кнопки «?» приводит к отображению. сокращенного варианта 
темы во всплывающием окне. 

Обработчик щелчка на кнопке Эрее4ВиЙвоп2 имеет вид: 


У01А _ ЕазЕса11 ТГогим1 : : 5брее4ВиЕоп2С11сК (ТОр)есе *5епаег) 
{ 


ТВогаегТсопз ФептрВТ = ВогаетТсопз$; 
1Е (брееаВаеоп2->Помп) 
{ 
семрВТ >> Ь1Мах1и1те >> Ь1М1пуи1те << Б1Не1р; 
брееяаВиЕ$оп1->Ромп = Ёа15е; 
бЕаба$Ват1->Рапе1$->ТЕетз$ [1] ->Техе = 
"Е1 - окно справки, ? - всплывающее"; 
} 
е1зе 
{ 
сетрВТ << Ю1Мах1тахе << Ь1М1п1и12е >> Б1Не1р; 
бЕафеа$Ваг1->Рапе15->ТЕемз [1] ->ТехЕе = 
"Контекстная справка в окне справки"; 
} 
ВогаегТсоп$ = ФепрВТ; 


} 
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Если кнопка нажата, то из заголовка окна формы удаляются кнопки свер- 
тывания и развертывания, и заносится кнопка «?». В итоге кнопка «?» стано- 
вится видна (рис. 7.20), и пользователь может для справки использовать ее, 
или по-прежнему пользоваться клавишей Г!|. Кроме того, отжимается клави- 
ша Зрее4ЯВиНоп1, так как ее в этом режиме использовать нельзя. Во вторую 
панель полосы состояния заносится текст: «Р1 — окно справки, ? — всплы- 
вающее» . Если кнопка Зрее4ВиЙйоп2 отжата, то заголовке окна формы восста- 
навливаются кнопки свертывания и развертывания, из заголовка удаляется 
кнопка «?», а во вторую панель полосы состояния заносится текст: «Контекст- 
ная справка в окне справки». | 

Поскольку при появлении кнопки «?» начинают генерироваться события 
формы ОпНер, обработчик этих событий позволяет дифференцированно реа- 
гировать на запрос справки клавишей Г] и запрос кнопкой «?›. Ниже приве- 
ден полный текст обработчика этого события: 

6оо1 __ЁЕаз®са11 ТЕГогм] ;: : ЕКогмНе1р (МОВО Соптапа, 1пе Рафа, 


Боо1 &Са11Не1р) 
{ 
1Е (ЗрееаВоа*6оп2->Вомп) 
{ 
1Е ((Сошмапа == НЕШР СОМТЕХТРОРОР) || (Соштапа == НЕГР _СОМТЕХТ)) 


{ 
1Е ((СескКеу5фаее (УК_Р1) & 0х100) == 0) 
И1оНе]1р (Напа1е, (Арр11са®1оп->Не1рЕ11е).с_з%г(), 
НЕГР СОМТЕХТРОРУР, ++Пафа); 
е1зе И1пНе1р (Напа1е, (Арр11са&1оп->Не1рЕ11е).с_5зЕг(), 
НЕЬР СОМТЕХТ, Бака); 
Са11Не]1р = Ёа1$е; 


} | 
е15е Са11]Не1р = &гае; 


} 


е1зе 
{ 
1Е (Соштапа == НЕБР СОМТЕХТРОРОР) ПРафа++; 
И1пНе]1р (Напа1е, (Арр11са1оп->Не1рЕ11е).с_$Ег(), 
Сотмапа, Вафа); 
Са11Не1р = ЁЕа15е; 
} 


гебауп Егое; 


} 


Если кнопка Эрее4Вивоп2 нажата, производятся следующие операции. 
Если команда Соттап@ не равна НЕСР_СОМТЕХТРОРОР или НЕЕР_СОМ- 
ТЕХТ, значит, пришла команда НЕГР ЗЕТРОРОР_РОЗ (см разд. 7.4.2). 
В этом случае никаких операций не производится, а просто задается 
СаПНер = фгие. Это обеспечивает дальнейший вызов \/шНе]р после выполне- 
ния обработчика события ОпНеф. Если же пришла команда отображения 
справки в стандартном или всплывающем окне, то надо понять, вызван ли 
этот запрос нажатием клавиши Г!], или кнопкой «?›. С помощью функции 
Се Кеу + а{е (см. разд. 2.3.1) проверяется, нажата ли в данный момент клави- 
ша [|. Если нажата, то далее вызывается функция УтшНер с командой 
НЕГР_СОМТЕХТ. Если клавиша не нажата, то вызывается функция УтшНер 
с командой НЕГР _СОМТЕХТРОРОР и с увеличенной на 1 ссылкой на тему. 
В обоих случаях задается СаЙНер = #Ёа5е, чтобы заблокировать последующий 
стандартный вызов \У/шНе]р. 
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Рассмотренные операции производятся, если кнопка Зрее4ЯВиЦЙоп2 нажа- 
та. А если она отпущена, то выполняется фрагмент кода, который был рас- 
смотрен ранее при обсуждении кнопки Эрее4ВиЙвоп1. 

Осталось рассмотреть только кнопку НЕР КЕ\, которая позволяет проил- 
люстрировать вызов функции УшНер с командой НЕБР_КЕУХ. Обработчик 
щелчка на этой кнопке содержит один оператор: 


И1пНе]1р (Напа1е, (Арр11са®1оп->Не]рЕ11е).с_з6г(), НЕГР КЕУ, 
(ипзтапеа 1опад) (Еа1{1->Техе.с_з%г())); 


Этот оператор вызывает функцию УшНер с командой НЕГР_КЕУ, пере- 
давая в вызов в качестве последнего параметра название темы, занесенное 
в окно ЕЯЩ1. Этот текст с помощью функции-элемента с_5%г() переводится 
в строку типа сЪаг*, а в качестве параметра передается указатель на эту стро- 
ку, приведенный к типу ипспед |опг. 


Глава 8$ 


Справочные данные 
по функциям и структурам 
АР! \ММтаоО\/$ 


В данной главе в алфавитной последовательности даются справочные све- 
дения по тем функциям, которые использовались или упоминались в предыду- 
щих главах. 


АЗЯА от и другие функции манипуляции с таблицами атомов 
Манипулируют таблицами атомов 
Заголовочный файл 5у$011[3.Йрр 


Синтаксис 

#10с] аае<и1пЬазе. В > 

#$АеЁ1пе МАКЕТМТАТОМ (1) (ТРТЗТВ) ((ОТОМС_РТВ) ((МОВЬ) (1))) 
ВООТ ИТМАРТ Тп1$АбомТаЬ1е (ТМ ОМОВО п517е); 


АТОМ ИТМАРТ АЧадАсом (ТМ БРСЗТВ 1р5ег1па}; 

АТОМ ИТМАРТ С]ора1АЧААЕ ом (ТМ БРСЗТК 1р5ег1па); 
АТОМ ИТМАРТ Пе1екеАфощ (ТМ АТОМ пА®ом); 

АТОМ ИТМАРТ С1ора1Ше1ефеАком (ТМ АТОМ пАбом); 


АТОМ МТМАРТ Е1паАФКом (ТМ ЬРСУТВ 1р5Ег1п9); 


АТОМ МТМАРТ С1оБа1Е1паАвоп (ТМ БРСЗТВ 1рбЕг1па); 


ОТМТ ИТМАРТ СефАбопМапе (ТМ АТОМ пАбош, ОЧТ ГРЗТК 1рВоаЕЕег, 
ТМ 1пЕ п517е); 


ОТМТ МТМАРТ С]ора1СекАкопМапме (ТМ АТОМ пАком, ОЧТ ЪРЗТВ 1рВаЕЕег, 
ТМ 1пеЕ п512е); 


Описание 

Данные функции осуществляют все доступные операции с атомами 
(см. разд. 1.16). Макрос МАКЕТПМТАТОМ является вспомогательным средст- 
вом, создающим целочисленный атом по передаваемому в него в качестве па- 
раметра целому значению. Этот атом далее может добавляться в таблицу 
функциями АА ют и С1об а! АЧЧАф от. 

Функция ШшёАошТа Ме задает размер локальной таблицы атомов. По 
умолчанию в ней может быть до 37 входов. Так что если это вас устраивает, то 
вызывать функцию ШЁАтютТаШМе не требуется. Но если вы хотите, напри- 
мер, увеличить возможное число входов, то надо вызвать эту функцию, пере- 
дав в нее число входов пЗ12е. Такой вызов должен осуществляться до вызова 
какой-либо другой функции, работающей с таблицей. 
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Функции АЧаА4ющ и С1оБа1 Аа А цю т добавляют соответственно в локаль- 
ную или глобальную таблицы строку с именем атома, на которую указывает 
параметр 1рЭигшг. Размер строки, включая завершающий нулевой символ, не 
должен превышать 255 байтов. Строки, различающиеся только регистром, 
считаются идентичными. Если строка имеет формат «#494», то добавляется 
целочисленный атом. 

Если атома с указанной строкой в таблице нет, строка добавляется в таб- 
лицу и функция возвращает новый созданный для этой строки атом. Если та- 
кая строка уже есть, возвращается ее атом и строка в таблицу не добавляется. 
Для строкового атома при этом число ссылок увеличивается на 1. Если про- 
изошла ошибка, функции возвращают нуль. Тогда причину ошибки можно оп- 
ределить функцией Се Таз Еггог. 

Функции ВеаееАфют и С1оБаШеееАфощт удаляют соответственно из ло- 
кальной или глобальной таблицы атом пАфот. Точнее, для строкового атома 
уменьшается на 1 число ссылок на него. И только если число ссылок стало рав- 
но 0, атом действительно удаляется из таблицы. Тогда последующие обраще- 
ния к удаленному атому функций РеаефеАфот, С1оБаДХеееАфют и других 
приведет к ошибке. В случае успешного выполнения функции Ю@аееАфюот 
и С1офа ее еАфот возвращают 0. В противном случае они возвращают зна- 
чение пАфом. 

Функции ЕтаАюмт и С1оба Е 14 Афотш осуществляют поиск атома с име- 
нем, заданным параметром рЭ#гше. Поиск осуществляется соответственно 
в локальной или глобальной таблице. Если атом найден, функции возвращают 
его значение. В противном случае возвращается 0. 

Надо отметить, что хотя при занесении строк в таблицу строки, различаю- 
щиеся регистром, считаются идентичными, функции ЕшаА4фющт и С1оба!Е!1т9- 
Ают ведут поиск с учетом регистра. | 

Функции Се Аф4ютМаше и С1оБа Се АфотМаше заносят в буфер 1рВиЁег 
размера п$12е строку, связанную с атомом пАфощ, соответственно из локаль- 
ной или глобальной таблицы. Если атом найден, функции возвращают число 
прочитанных символов, не считая заключительного нулевого символа. При 
ошибке возвращается нуль. 

Примеры работы с атомами см. в разд. 1.16. 


АЧаЕоп{КВезоигсе — регистрация шрифта в системе 
Регистрирует шрифт в системе 
Заголовочный файл Ипа. 
Объявление 
116 АааРопЕВезоаигсе (ТРСТЗТВ 1р52Е11епапе ); 


Описание 

Параметр 1р$2ЕПепате — это полное имя файла шрифта с путем к нему. 
Файлы шрифтов — это файлы ./оп, пЬ НР, „№0. 

Функция возвращает номер нового шрифта, добавленного в таблицу 
шрифтов У т9до\$. Если добавить шрифт не удалось, возвращается 0. 

Результаты регистрации прифта почувствуют только те приложения, ко- 
торые будут запущены после выполнения соответствующей операции. 

Если установленный шрифт вам больше не нужен, его регистрацию можно 
отменить функцией КетоуеРотКезбопгсе. При этом надо иметь в виду, что 
сколько раз подряд вы выполните регистрацию, столько же раз надо выпол- 
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нить удаление шрифта функцией КетоуеЕ от Кезоигсе, чтобы он действи- 
тельно удалился. 

Регистрации шрифта функцией АдаЕо(Везоигсе временная. После пере- 
загрузки системы установленный шрифт не будет зарегистрирован. 

Если же вы хотите установить шрифт для постоянного использования и не 
только вашим приложением, надо просто скопировать файл шрифта в папку 
Утаошз\Ропзз. | 

Примеры применения регистрации шрифта см. в разд. 1.14. См. также 
описание функции ВетоуеЕоп& Везосгсе. 


Ада ТоКепРглуПерез — позволяет изменить привилегию 
См. функцию Ех Ц У шдом$Ех. 


АпеАгс — рисование окружности 
См. функцию Аге 


Арреп4Мепи — вставляет раздел выпадающего меню 


Вставляет раздел в конец указанной полосы меню, выпадающего меню, 
контекстного меню 


Заголовочный файл штизег.й 


Объявления | 
+АеЁ1пе АррепаМепоа АррепаМепоА 
#аеЁ1пе Арреп4Мепи АррепаМепой 


ИТМОЗЕВАРТ ВООЪ МТМАРТ АррепаМепоА (ТМ НМЕМО ПМепа, 
ТМ ОТМТ эаЕ1адз, 
ТМ ОТМТ РТВ а1ЮМемтЕем, 
ТМ ГРСЗТК 1рМ№емГ!Г% еп); 


ИТМОЗЕВАРТ ВООТ МТМАРТ АррепаМепом (ТМ НМЕМО ВМерпа, 
ТМ ОТМТ оЕ1ааз, 
ТМ ОТМТ_ РТК чТОМемГбем, 
ТМ ТРСИЗТВ 1рМ№емГТеем); 


Описание 

Функция АррепаМепи вставляет раздел в конец указанной полосы меню, 
выпадающего меню (в том числе системного), контекстного меню. Параметр 
№Мепи является дескриптором изменяемого меню. Параметр иЕ]1а7$ является 
комбинацией описанных далее флагов, определяющих вид вставляемого раз- 
дела. Параметр иОМемЦет определяет команду, связанную со вставляемым 
разделом, или, если в и 1а5$ задан флаг МЕ_РОРТОР, то и ШМе\хЦет является 
дескриптором выпадающего или каскадного меню. 

Значение параметра 1рМемЦет зависит от флагов, заданных в параметре 
иЕ]а52$ следующим образом: 
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Флаг в 9 ар$ Значение 1рМе\Цвет 
МЕ_В1ТМАР Дескриптор изображения. 


МЕ_ОММЕКОВАМ’ |Заданное приложением 32-битное значение, дающее ка- 
кую-то дополнительную информацию, связанную с про- 
рисовкой раздела. Оно является полем ЦетОафа записи, 
на которую указывает параметр П1рагашт сообщений 
\М_МЕАБЗОВЕ и \М_ОВАМТТЕМ, посылаемых 


при создании т И обновлении раздела. 


Указатель на строку с нулевым символом в конце. 


МЕ _ЭТЕМС 
| Понад 


Ниже приведена таблица флагов, которые могут задаваться в параметре 
иЕа55. Флаги объединяются операцией ИЛИ. 


МЕ_ВТТМАР В разделе меню отображается изображение, на кото- 
рый указывает дескриптор, заданный в параметре 
| __ 1рМемЦет. 


о том, что раздел выбран или не выбран. Изображе- 


МЕ_СНЕСКЕО | В разделе помещается индикатор, свидетельствующий 
‚ния индикатора задаются функцией Зе МепаЦетВЦК- 


тар$. 

МЕ ОЗАВГЕО Раздел делается недоступным, но не отображается се- 
рым. 

МЕ_ЕМАВГЕО Раздел делается доступным. 

МЕ СВАУЕО Раздел делается недоступным и отображается серым. 


МЕ _МЕМОВАВВВЕАК | Размещает в разделе переход на новую строку для по- 
лосы меню или на новый столбец для подменю. В по- 
следнем случае новый столбец отделяется разделите- 
лем в виде вертикальной черты. 


| МЕ. МЕМОВКЕАК То же, что МЕТ МЕМОВАВВВЕАК, но без раздели- 
теля в виде вертикальной черты. 


МЕ_ОММЕВОКАУМ’ Заказное рисование раздела меню. Для этого может 
использоваться сообщение \М_МЕАЗОВЕЫТЕМ, по- 

ступающее перед первой прорисовкой, и сообщение 

| \М_ОКАМТТЕМ, поступающее при каждом обновле- 

—- нии изображения. 

М 


Е РОРОР Указывает, что раздел открывает каскадное меню. 


МЕ_5ЕРАВКАТОКВ Разделитель в виде горизонтальной черты. Парамет- 
‚ры рМ№МемЦет и и№МемЦет игнорируются. 


МЕТ 5ТЮАМС Текстовое отображение раздела. Параметр 1|рМ№емЦет 
указывает на строку-текста. 


МЕ_ОМСНЕСКЕО Не помещает в разделе индикатор, свидетельствую- 
щий о том, что раздел выбран или не выбран. Если 
приложение задало функцией Зе МепиЦет В! тарз 

изображения индикатора, то индикатор задается не 

е включенным. 
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Не могут использоваться совместно следующие группы флагов: 


МЕ О1ЗАВГЕЕО, МЕ_ЕМАВГЕР и МЕ _СКАУЕР 
МЕ ВТМАР, МЕ_ЗТЕ1МС и МЕ О\УМЕВОКАУ 
МЕ МЕМОВАКВКЕАК и МЕ МЕМОВКЕАК 

МЕ СНЕСКЕР и МЕ ОМСНЕСКЕР 


Функция возвращает ненулевое значение при успешном выполнении и 0 
в случае ошибки. Подробную информацию об ошибке можно получить с помо- 
щью функции Се а Еггог. 

Примеры применения функции АррепаМепи см. в разд. 5.2.1. 


Агс и другие функции рисования дуги окружности или эллипса на кон- 
тексте устройства 


Рисуют дугу окружности или эллипса на контексте устройства 
Заголовочные файлы ит241.Й, итаоиэз.й 
Синтаксис 


#1пс1аАе <и1паом$.В> 


ИТМСОТАРТ ВООТ МИТМАРТ Агс (ТМ НОС Вас, ТМ 1106 пГеЕ%Весф, 
ТМ 116 пТорВесе, ТМ 116 пВзареБВесе, 
ТМ. 106 пВосбомВес®, ТМ 1п6 пХбфаг%Агс, 
ТМ 106 пУббагЕАгс, ТМ 1106 пХЕпаАгс, 
ТМ 106 пУЕпадАгс); 


МТМСОТАРТ ВООТ МТМАРТ АгсТо (ТМ НОС Бас, ТМ 116 пГЬеЕЕВесеь, 
ТМ 1пЕ пТорВес®,ТМ 1пе пВ1ар*Весе, 
ТМ№ 106 пВобопВесе, ТМ 1п6 пХббагфАгс, 
ТМ 1рЕ пУббаг Агс,ТМ 1пе пхХЕпаАгс, 
ТМ 1пе пуУЕпаАгс); 


ИТМСОТАРТ ВООГ МТМАРТ Апа1еАгс (ТМ НОС Вас, ТМ 110% Х, 1М 1106 У, 
ТМ ОМОВО амчВаа1аз, 
ТМ ЕГОАТ ебфаг®Апа1е, 
ТМ ЕБОАТ ебмеерАпа1е); 


ИТМСОТАРТ 11 ИТМАРТ СееАхгср1гес®1оп (ТМ НОС Вас); 


ИУТМСОТАРТ 1пеЕ МУТМАРТ ЗефАгср1гкесЕт1оп (ТМ НОС Бас, 
ТМ 106 АгсО1гесе1оп); 


Описание 

Все функции применяются при рисовании на контексте устройства 
(см. разд. 5.5.1). Функции Агс и АгсТо рисуют дугу окружности или эллипса, 
ограниченного описанным прямоугольником. Параметр В4с является деск- 
риптором контекста устройства. Параметры пей Вес+, пТорВес$, п ЖВес{ 
и пВоЙботКВесф определяют соответственно координаты левой, верхней, пра- 
вой и нижней граней описанного прямоугольника. В У/тао\мз 95 значения 
этих параметров и их сумма не должны превышать 32768. 

Начальная точка дуги определяется пересечением эллипса с прямой, про- 
ходящей через его центр и точку (пХ${$аёАгс, пУЗ4аё Агс). Конечная точка 
дуги определяется пересечением эллипса с прямой, проходящей через его 
центр и точку (пПХЕп9Агс, пУЕпдАгс). Если начальная и конечная точки сов- 
падают, рисуется полный эллипс. 

В Ушдомз 95 дуга всегда рисуется против часовой стрелки от начальной 
до конечной точки. В более современных версиях \У!1т4о\з дуга по умолчанию 
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также рисуется против часовой стрелки от начальной до конечной точки. Но 
направление рисования можно изменить функцией Зе АгеОгесйоп. Узнать 
установленное в данный момент направление можно функцией Сеё&АгеПгес- 
Ноп. Обе функции возвращают целое число, указывающее установленное на- 
правление рисования: АО_СООМТЕВСГОСК \М/ТЗЕ — против часовой стрел- 
ки, АО_СГОСКУ\УТЗЕ — по часовой стрелке. Функция Зе АгеПлгесйоп уста- 
навливает при этом новое направление, задаваемое параметром АгеО1гесйИоп. 
Значение этого параметра может задаваться равным АХ_СООМТЕВСГОСК- 
\ТЗЕ или АО СГОСКУ\УТЗЕ. | 

Функции Агс и АгсТо рисуют дугу текущим пером и не заполняют ее ки- 
стью. Функция АгсТо, помимо дуги, рисует линию, проходящую из текущей 
позиции пера в точку начала рисования дуги, а после окончания рисования 
дуги текущая позиция пера перемещается в конечную точку дуги. Это удобно 
использовать, например, при рисовании сектора. Функция Ап ]еАге выпол- 
няет те же операции, что и функция АгеТо, но работает только с окружностью 
(впрочем, с помощью трансформации координат окружность можно преобра- 
зовать в эллипс) и использует иную систему параметров. Параметры Х и У 
указывают координаты центра окружности. Параметр 9мКа41и$ — радиус. 
Параметр пХЕп@Агс указывает начальный угол дуги в градусах, отсчитывае- 
мый от оси х против часовой стрелки. А параметр еЗмеерАп]е указывает 
угол дуги, отсчитываемый от начального угла против часовой стрелки. Как 
и в функции АгсТо, помимо дуги, рисуется линия, проходящая из текущей 
позиции пера в точку начала рисования дуги, а после окончания рисования 
дуги текущая позиция пера перемещается в конечную точку дуги. 

Функции возвращают ненулевое значение в случае успешного выполнения 
и 0 вслучае ошибки. Тогда информацию об ошибке можно получить функцией 
Се Та Еггог. 


Рассмотрим примеры рисования дуг функциями Агс и АгсТо на контексте 
канвы компонента ТПпаге. 

Следующие операторы рисуют красным пером дугу в четверть эллипса или 
окружности на канве компонента Ппабе1. 


НОС НО = Тпаде1->Сапуаз->Напа1е; 

10Е И = ГПаае1->Изтаев; 

116 Н = Тмаде1->Незаве; 

НРЕМ ВеаРеп = СгеафеРеп (Р5_ЗОТТО, 1, с1Веа); 

Зе1есЕоОБ]есе (НО, ВеЯРеп); 

Агс (НО, 2, 2, И, Н, М, Н/ 2, и/2, 0); 

Результат приведен на рис. 8.1 а. 

Если в приведенном выше коде заменить последний оператор на приведен- 
ные ниже, то будет нарисован сектор (рис. 8.1 6). 

МоуеТоЕх (НО, И/ 2, Н/ 2, №1); 

АгсТо (НО, 2, 2, И, Н, И Н/ 2, \/2, 0); 

.1пеТо (НО, И/ 2, Н/ 2); 

Аналогичный результат можно получить, если заменить в приведенном 
коде вызов функции АгеТо вызовом функции Ап ]еАгс: 


Апа1еАгс (НО, И/ 2, Н/ 2, И /2, 0, 90); 


АгсТо — рисование дуги окружности или эллипса 545 


Рис. 8.1. Примеры рисования 
дуг функциями Агс (а) и АгсТо (6) 


а) 6) 


Если перед вызовом функций Аге и АгсТо поместить следующий оператор: 


бееАгср1гесе1оп (НО, АР _СТОСКИТЗЕ); 


то направление рисования дуг изменится, и те же вызовы функций будут рисо- 
вать дуги в три четверти эллипса. 


Следующий оператор нарисует полный эллипс: 
Агс (НО, О, 0, И, Н, О0, 0, 0, 0); 


АгсТо — рисование дуги окружности или эллипса 
См. функцию Агсе 


Веер — воспроизводит звук простого тона 
Синхронно воспроизводит звук простого тона через динамик 
Заголовочный файл шпизег.И 
Синтаксис 
ВОО Веер (ОМОКО АамЕгеа, ПОМОВО амрига®1оп); 


Описание | 

Функция Веер синхронно воспроизводит звук простого тона через дина- 
мик и не возвращается до окончания звука. Параметр 4мЕгед задает частоту 
звука в герцах. Он может иметь значения в диапазоне от 37 до 32,767 (от 0х25 
до ОхТЕЕР). Параметр 4мОигаНоп устанавливает длительность звука в милли- 
секундах. 

При успешном выполнении функция возвращает ненулевое значение. При 
аварийном завершении возвращается нуль. Тогда развернутую информацию 
об ошибке можно получить вызовом функции Се Та$Еггог. 

В У !п9домз 95/98 параметры функции Веер игнорируются и вместо нее 
компилятор подключает одноименную функцию Веер С++Во!аег. Если ком- 
ньютер имеет звуковую карту, то воспроизводится звук, сопровождающий со- 
бытия по умолчанию. При отсутствии звуковой карты воспроизводится стан- 
дартный звук через динамик. Так что данную функцию имеет смысл использо- 
вать только для УИт4омз МТ/2000/ХР. 

Более удобна функция АРТ \У/т4омз — МеззахеВеер. А еще большие воз- 
можности имеет функция АР1Г У/ш4дожз Р]ауЗоипа. 


ВЕВИ — копирует изображение на контекст устройства 
Копирует изображение на контекст устройства 


Заголовочный файл и{т2а1.й 
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Синтаксис 


ИТМСОТАРТ ВООЦГ В1%В1+ (ТМ НОС Васрезе, ТМ 11 пхрезе, ТМ 1пе пурезе, 
ТМ 1пе питаер, ТМ 106 пНезаЬе, ТМ НОС Вас5гс,. 
ТМ 1п0е пХ5бгс, ТМ 1106 пубгс,ТМ РИОВР аАмВор); 
Описание 
Функция ВЫВЁ копирует изображение на контекст устройства (см. разд. 5.5.1). 
Параметры №4ес)е$%, пХОе$$, пУОе$, п\У1Ч, пНесЪ{ определяют дескрип- 
тор контекста, координаты левого верхнего угла, ширину и высоту области 
контекста, в которую проводится копирование. Параметры В4е$гс, пХ$гс, 
пУ5гс определяют дескриптор и координаты левого верхнего угла области 
того контекста, из которого копируется изображение. Параметр 4мВор опре- 
деляет режим комбинирования цветов источника и приемника изображения. 
Значения ВГАСКМЕЗ5 и \УНТТЕМЕ$$ просто заливают область приемника 
цветом, соответствующим в палитре по умолчанию черному и белому. Эти зна- 
чения используются обычно для очистки области приемника. Значение 
ЭВССОРУ обеспечивает копирование изображения. 
Примеры применения функции ВИЫВЁ вы найдете в разд. 5.5.1 и 5.5.3. 


СаПМех{НооКЕх — передает сообщение следующей ловушке 


Передает сообщение следующей ловушке в цепочке и возвращает значе- 
ние, которое вернула последняя ловушка цепочки 


Заголовочный файл И71т0Озег.й 


Синтаксис 


ТВЕЗОЬТ МТМАРТ Са11МехЕНоокКЕх (ТМ ННООК ВБК, ТМ 1пЕ пСоае, 
ТМ ИРАКАМ иРагам, ТМ ГРАКАМ 1Рагам); 


Описание 

Передает сообщение следующей ловушке в цепочке и возвращает значе- 
ние, которое вернула последняя ловушка цепочки (см. о создании ловушек 
в разд. 4.3). Параметр ВВК в данном объявлении — дескриптор данной ловуш- 
ки, а пСоде, мРагат и 1Рагаш — значения параметров, поступившие в функ- 
цию ловушки. Так что чаще всего возврат из функции ловушки оформляется 
оператором: 


гесигп Са11МехЕНоокКЕх (НоокКНапа]1е, соае, мРагаш, 1Рагап)}; 


где НоокКНап Ме — дескриптор, возвращенный при установке ловушки функ- 
цией Зе \Утдом$НооКЕХх. 


СапсеПо — прерывает все незавершенные операции чтения и записи 


Прерывает все незавершенные операции чтения и записи указанного фай- 
ла в данном потоке 


Заголовочный файл штфазе.й 


Синтаксис 


#1пс1оае<и1пБазе. в > 
ВОО ИМТМАРТ Сапсе1То (ТМ НАМОЬЕ №Е11е); 


Описание 

Функция СапсеПо прерывает все незавершенные операции чтения и запи- 
си, файла (см. разд. 6.7.1) с дескриптором ВЕШе. Прерываются только опера- 
ции вызвавшего потока. Операции в других потоках нормально продолжают 
выполняться. 


СВапдеСИрБоаг4СВат — исключает свое окно из цепочки СИрБоага 547. 


Функция возвращает ненулевое значение, если все операции успешно пре- 
рваны. В противном случае возвращается нуль. Тогда причину ошибки можно 
определить функцией Се Га$&Еггог. 


СВапхеСПрБоагЧаСВат — исключает свое окно из цепочки СИрБоаг4 
См. функцию СИрЬоаг4. 


СВагТоОешт — перевод строки в текст М$-2О5 
Переводят строку в текст МВ-ООБ 


Заголовочный файл штизег.й 


Синтаксис 

ВООТ СЪагТооеп ( 
ТРСТУТВ 1рз$25гс, // исходная строка 
.РЗТВ 1р5з2036 // результат перевода 


); 


ВОО СРагТоОепВаЕЁЕ ( 
ЪРСТ$ЗТВ 1рз25гс, // исходная строка 
ЪРЗТВ 1р5$203$%, Х// результат перевода 
РИОВР ссррз+Ьепаер // число символов 
); 


Описание 

Функции применяются для перевода строки текста в формате АЗСП («про- 
сто текст») в строку формата «текст МБ-ООБ». Это требуется, в частности, 
в консольных приложениях для вывода на экран русских текстов. Необходим 
подобный перевод и в случаях, когда в окно редактирования загружен русский 
текст, и его надо сохранить в файле в формате РОВ. 

‘Параметр 1р$25гс — указатель на строку, которую надо перекодировать. 
Параметр 1р$205$% — указатель на строку, в которую заносится перекодирован- 
ный текст. Параметр сев ОзИ.еп в функции СВагТоОетВий определяет 
число перекодированных символов, которые заносятся в результирующую 
строку. Если это число меньше числа символов в исходной строке, то осталь- 
ные символы не заносятся в результирующую строку. 

Имеются два варианта функций, работающие с кодами АМК] и с много- 
байтными кодами Ошх. В случае, если работа идет с кодами АМТ, адреса ис- 
ходной и результирующей строк могут совпадать, т.е. параметры 1рз;$гс 
и 1р$205$$ могут указывать на одну строку. 

Функции всегда возвращают ненулевое значение. 

Имеется также функция ОетТоСВаг, которая осуществляет обратное пре- 
образование. 

Ниже приведен пример консольного приложения, демонстрирующий вы- 
вод и ввод сообщений в кодировке РОБ. Для вывода русских текстов использу- 
ется функция СвВагТоОет. 


#10с1аае <5зЕа1о.В> 
#1пс1аае <зузбем.Врр> 


106 маап() 
{ 
саг $1[20], $2[20]1; 
СВагТоОепм ("Введите Ваше имя:\п", $1); 
рг1пе# ($1); 
эзсапЕ ("%205", 52); 
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СрагТоОеп ("Привет, ", 51); 

ре1пЕЕ ($6 гсаф (зЕгсаф (51,52), "!!!\п")); 
// Чтобы не закрылось окно 20$ 

ЕЕ1а5$р ($411); 

аеесвах (); 

гебагп 0; 


} 


Следующий пример демонстрирует консольное приложение, в котором 
пользователь вводит пароль. 


#1п0с1аАе <з6А1о.В> 
#1пс1а4е <зузвет.Врр> 
#1пс1аае <соп1о.6> 


106 ма1п (106 агас, сраг* агау[]) 

{ 
116 1; 
сопзЕ п = 6; // число символов пароля 
сраг $1[17], раззмога [п+1]; . 
СРагТоОеп ("Введите пароль:\п", 51); 


рг1пеЕ (51); 

сраг св; 

Рог (1=0; 1<п; 1++) 
1Е( (св = дебсв()) != '\г') 
{ 
раззмогка [1] = св; 


рчеспаг('*'); 

} 

е1зе ргеаК; 
раззмога[1] = 0; 
// демонстрация введенного пароля (для тестирования) 
раесваг('\п'); | 


рге1пЕЕ (раззмога); 

// Чтобы не закрылось окно 100$ 
ЕЕ] азВ (5$6А1п); 

дееспахг (); 

гееагп 0; 


} 


Запрос пароля осуществляется функцией ргии!. Предварительно строка 
запроса переводится в формат текста в М5-ООБ функцией СвагТоОет. Симво- 
лы, вводимые пользователем, читаются функцией дееВ, что обеспечивает от- 
сутствие их на экране. Если введенный символ не Ещег (\г), то на экран функ- 
цией риёсВаг выводится символ *. Заключительные операторы кода введены 
просто для тестирования — чтобы вы видели, что пароль введен правильно. 

В следующем примере, текст из окна Ве ВЕЗИ1 сохраняется в формате 
РОБ в файле, указанном пользователем. 


#10с1аае <5зЕа1о.6> 


1Е (Збауер1а1о91->Ехесике ()) 


{ 


сраг *З = (сраг *) па11ос ($17еоЕ (В1свЕа1*1->Тех®) +1); 
СрагТоОем ( (В1спЕЯ1{1->Тех®) .с_$6г(), 5); 

ЕТЬЕ *Е; 

Е = Еореп ( (бауер1а1о31->Е11еМаме) .с_зех(), "мё"); 
Ере1пЕ ЕЁ (Е,"%5", 5); 

Ес1озе (Е); 


Егее (5); 


СНагТоОетВи{Т — перевод строки в текст М$-00$ 549 


Первый оператор в структуре # вызывает диалог сохранения файла. Если 
пользователь выбрал в нем файл, то далее отводится память под строку Ъ, не- 
обходимая для хранения в ней текста окна Васе ВЕЗИ1. Следующий оператор 
заносит в нее перекодированный текст. Дальнейшие операторы создают тек- 
стовый файл с заданным именем, заносят в него перекодированный текст и за- 
крывают файл. Последний оператор освобождает память. 


СВагТоОетВиЁ' — перевод строки в текст М5-0О5 
См. функцию СвагТоОетщ. 


СпескМепиЦет — устанавливает или удаляет индикатор выбора раз- 
дела меню 


Устанавливает или удаляет индикатор, показывающий, что раздел меню 
выбран или не выбран 


Заголовочный файл штпизег.Й 


Синтаксис 


ИТМОЗЕКАРТ ПМОКО ИМТМАРТ СпескКМепаТееп (ТМ НМЕМО БМепа, 
ТМ ОТМТ оатобсресктТеем, 
ТМ ОТМТ оаСВесКк); 


Описание 

Функция СВескКМепиЦет устанавливает или удаляет индикатор в виде га- 
лочки или радиокнопки, показывающий, что раздел меню выбран или не вы- 
бран. 

Параметр ВМепаи является дескриптором меню. Параметр иГОСВесКЦет 
указывает раздел меню. А параметр иСВесК определяет устанавливаемое со- 
стояние индикатора. Флаги, из которых формируется этот параметр, указыва- 
ют также, как именно идентифицируется раздел параметром аГОСвеск Цвет. 

Параметр аСБесК задается как сочетание следующих флагов: 


МЕ ВУСОММАМО Указывает, что параметр иГОСвескЦет определяет иден- 
тификатор команды раздела. При этом возможна неодно- 
значность, если в меню присутствует несколько разделов 
с одинаковыми идентификаторами. Флаг МЕ_ВУСОМ- 
МАМО подразумевается по умолчанию, если не задан 
флаг МЕ_ВУРОЗТТТОМ. 


МЕ_ВУРОЗТГТОМ |Указывает, что параметр «ТОСВескЦет определяет ин- 

декс раздела (индекс первого раздела 0). Если дескриптор | 
№Мепи указывает полосу меню, то индексы относятся 
к заголовкам меню. | 


МЕ_СНЕСКЕРО Включает индикатор. 


МЕ _ОМСНЕСКЕО |Выключает индикатор. о —_ О 


Из флагов МЕ ВУСОММАМО и МЕ_ВУРОЗТТТОМ может быть указан 
только один. Аналогично указывается только один из флагов МЕ_СНЕСКЕР 
и МЕ_ОМСНЕСКЕ. 

Функция устанавливает состояние индикатора раздела меню и возвращает 
его предыдущее состояние: МЕ_СНЕСКЕРО или МЕ ОМСНЕСК. Если указан- 
ного раздела меню нет, возвращается ОхЕЕЕРЕЕЕЕЕ. 

Пример применения функции СВескКМепиЦет см. в разд. 5.2.1. 
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Индикатором раздела меню можно также управлять с помощью функций 
СгежеМепи, шзег{Мепи, шзег{МепиЦешт, Гоа@Мепи т 1гес%, МодНуМепи, 
Зе МепиЦеш ш\Фо. 


СБога и Р1е — рисуют сегмент 


Рисуют фигуры сегмента и сектора, ограниченные дугой эллипса или ок- 
ружности 


Заголовочные файлы штаа1.й, илт4оиз.й 


Синтаксис 


ИТМСОТАРТ ВООТ МТМАРТ СПога (ТМ НОС Вас, ТМ 1пеЕ пЪеЕ& Вес, 
ТМ 116 пТорВесе, ТМ 1пЕ пла Весеь, 
ТМ№ 106 пВоЕбомВесе, ТМ 110 пхКа@а1а]11, 
ТМ№ 1пЕ пУКаа1а11,ТМ 1пе пхКа@а1а12, 
ТМ 106 пУКаа1а12); 


ИТМСОТАРТ ВООТ МИТМАРТ Р1е (ТМ НОС Пас, ТМ 1реЕ отеЕЕВесе, 
ТМ 1п0пЕ пТорВес®е, ТМ 1пЕ пвлар&Весь, 
ТМ 1пЕ пВоЕбомВесе, ТМ 1пЕ пхХВаа1а11, 
ТМ 106 пУКаа1а11,ТМ 1п6е пхХКа@а1а12, 
ТМ 1пе пуУКаа1а12); 


Описание | 

Функции применяются при рисовании на контексте устройства 
(см. разд. 5.5.1). Функция СВог4 рисует сегмент — фигуру, ограниченную ду- 
гой эллипса или окружности и хордой, соединяющей концы дуги. Параметр 
В4с — дескриптор контекста. Параметры пе Вес, пТорВесф, пе Вес 
и пВоЙНотВес{ задают соответственно координаты левой, верхней, правой 
и нижней граней прямоугольника, описанного вокруг окружности или эллип- 
са. В Уш4омз 95 значения этих параметров и их сумма не должны превы- 
пать 32168. | 

Начальная точка дуги определяется пересечением эллипса с прямой, про- 
ходящей через его центр и точку (пПХВаФа Ш, пУВа41а12). Конечная точка 
дуги определяется пересечением эллипса с прямой, проходящей через его 
центр и точку (пХВаа12, пУЕпдАгс). Если начальная и конечная точки сов- 
падают, рисуется полный эллипс без изображения хорды. Но эллипс проще 
рисовать функцией ЕШрее.. 

Функция Р1е рисует сектор — фигуру, ограниченную дугой эллипса или 
окружности, и радиусами, проведенными из центра в концы дуги. Все пара- 
метры функции совпадают с параметрами функции СБог@а. 

В \!19домз 95 дуга всегда рисуется против часовой стрелки от начальной 
до конечной точки. В более современных версиях \У/114о\з дуга по умолчанию 
также рисуется против часовой стрелки от начальной до конечной точки. Но 
направление рисования можно изменить функцией Зе АгеПО1гес оп. Узнать 
установленное в данный момент направление можно функцией Се АгеПлгес- 
Ноп. Обе функции возвращают целое число, указывающее установленное на- 
правление рисования: АД_СООМТЕВСГОСК\УТЗЕ — против часовой стрел- 
ки, АР_СГОСК\УТЗЕ — по часовой стрелке. Функция Зе АтеПлгесЙоп уста- 
навливает при этом новое направление. 

Контур фигуры рисуется текущим пером, а площадь фигуры заполняется 
текущей кистью. Текущая позиция пера не изменяется. Если для контекста 
устройства задана пустая кисть МОСЬ ВКОЗН, то рисуется только контур. 
А если для контекста устройства задано нулевое перо МОГГ_ РЕМ, то рисуется 
только заполнение фигуры, а контур не прорисовывается. 
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Функции возвращают ненулевое значение в случае успешного выполнения 
и 0 вслучае ошибки. Тогда информацию об ошибке можно получить функцией 
Се Газ Еггог. 

Рассмотрим пример рисования функциями СВог@ и Р1е. Следующие опера- 
торы рисуют на контексте канвы компонента Ппаре1 контур фигуры красным 
пером и заполняют площадь фигуры косой красной штриховкой. Дуги рису- 
ются в четверть эллипса. 

НОС НР = Тмааде1->Сапуа$->Напа]1е; 

100 М = Тмаде1->итафеь; 

1п© Н = Гмаде1->Не1а1*; 


// установка красного пера толщиной в 2 пиксела 
НРЕМ ВеаРеп = Сгеа®еРеп (РЗ_ЗОТТО, 2, с1Веа); 
5е1есеоОЬ)ес® (НО, ВеаРеп); 


// установка красной кисти с диагональной штриховкой 
ТОСВВИЗН 1р1Ь; 

1р1Ь.155Еу1е = В$_ НАТСНЕВ; 

1р16.1БНаесй = Н$_ВОТАСОМАГ; 

1р15.16Со1ог = с1Веа; 

НВКО$Н КВеаВгазВ = СгеафеВхазпТпа1гес® (&1р1Ъ); 
5е1есеОБ]ес® (НР, ВеЯаВгаз1); 


// рисование 
Свога (НО, 0, 0, И, Н, М, Н/2, И /2, 0); 


Р1е (но, 0, 0, и, н, 0, нН/2, и/2, Н); 
// удаление дескрипоторов пера и кисти 
Ре1есеОоь)еск (ВеаРеп); 

Ре1ефеоь]ес® (ВКеаВгоз1); 


Результат приведен на рис. 8.2. 


Рис. 8.2 
Примеры применения функций СПога и Ре 


к 


Если перед вызовами функций СБог4 или Р1е поместить следующий опе- 
ратор: 


ЗеЕАксо1 хесе1оп (НО, АБ СЪОСКИТЗЕ); 


то направление рисования дуг изменится, и те же вызовы функций будут рисо- 
вать дуги в три четверти эллипса. 
Следующий оператор нарисует полный эллипс: 


СВога (НО, 0, 0, И, Н, 0, 0, 0, 0); 
Но эллипс проще рисовать функцией ЕШрее: 
Е11]1рзе (НО, 9, 0, 1, Н); 
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ЧеагСоттВгеаК — возобновляет прерванную передачу данных 
См. функцию РигбеСотит 


СПрЬоаг4 и другие функции доступа к буферу обмена 
Получение доступа к буферу обмена 
Заголовочный файл ос/\СПрёга.Йрр 


Синтаксис 
#1п0с1аае <ус1\С11рЬга.Врр> 


ехсегп РАСКАСЕ ТС11рроага* __ЁЕаз®са11 С11рЬоака (\%о1а); 


роо1 _ Еаз®са11 НазГогма® (Мога ЕогтаЕ); 

НИМР бесС11рбоагаУ1емег (ТМ НИМР Р\памемУ1емег); 

ВООТЪ СвапдеСс11рБоахаСВалпт (ТМ НИМР БИпаВепоуе, 
ТМ НИМР РИпаМеи№ехе); 


Описание 

Получить доступ к буферу обмена можно через функцию СПИрБоаг@, 
не имеющую параметров. Функция возвращает объект класса ТСПрБоаг@, 
имеющий ряд методов и свойств. 

Информация в буфере обмена может быть записана в различных форма- 
тах. Функция НазРогтаф возвращает фгае, если формат, указанный парамет- 
ром Рогтай, зарегистрирован в системе. Значения параметра Рогтаф могут 
быть следующие: 


СЕ_ТЕХТ Текст, каждая строка которого заканчивается символами 
СКВ-ГЕ, а весь текст заканчивается нулевым символом. 


СЕ_ВТТМАР Изображение типа битовой матрицы. | 
СЕ_МЕТАЕЦШЕРГСТ | Изображение типа метафайлаа. __ 
СЕ _РСТОВЕ Объект типа ТРаеге. 


СЕ СОМРОМЕМТ. 


Любой объект, наследующий ТРегз1$4еп. и 


Возможны и другие значения формата, зарегистрированные пользовате- 
лем с помощью метода Вез1$егСИрБоагЧРЕогта{ класса ТРацаге. 

Все доступные форматы можно получить с помощью свойства РЕогтаф$ 
объекта типа ТСИрЬоаг4. Это свойство представляет собой индексированный 
список значений зарегистрированных форматов. Свойство ЕогтаСоип& опре- 
деляет число таких форматов. Пример использования этих свойств приведен 
в разд. 3.11. | 

Свойство АзТехф объекта ТСИрфоаг@ позволяет читать содержимое буфера 
обмена в виде строки типа Ап$1 55, а также заносить информацию в буфер 
обмена в текстовом виде. Например, чтение текста из буфера обмена в компо- 
нент В1с БЕЗ может быть организовано следующим образом: 


#1пс1а4е <ус1\С11рЬга.врр> 


1Е (С11рроака () ->НазКогта® (СЕ_ТЕХТ)) 
В1сьЕа161->Техе = С11рроага () ->АзТехе; 
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Следующий пример обеспечивает чтение изображения из буфера обмена 
в Ппабе1: 


1Е (С11рроахга () ->НазГогма® (СЕ_ВТТМАР)) 


{ 
фку 
{ . 

Тпаче1->Р1сбоге->ГоааЕгомС11рЬоагаЕГогта® ( 

СЕ_ВТТМАР, С11рроага () ->СесАзНапа1е (СЕ _ВТТМАР), 0); 


} 
саесв (...) 


{ 
СРомМеззасе ("Загрузка изображения невозможна"); 
} 
} 
е15е 
ЗпомМез5аде ("В буфере не точечное изображение"); 


Иногда может требоваться отслеживать события, связанные с изменением 
содержимого буфера обмена. При занесении любой программой в буфер обмена 
каких-то данных генерируется сообщение У/тдомз МУМ_ЮВАМСЫРВОАВЮ, 
не имеющее параметров. Это сообщение поступает только в те окна, которые 
включены в цепочку окон просмотра буфера обмена. Включить свое окно в эту 
цепочку можно функцией Зе СИрБоага\Уемег. Параметр В\УпаМемУ1е\мег 
является дескриптором окна, включаемого в цепочку. Функция возвращает 
дескриптор следующего окна в цепочке. 

Если вы включили свою форму в цепочку окон просмотра буфера обмена, 
вы должны обеспечить обработку сообщений У\УМ_ОВКАМСЫРВОАВКО 
и \М_СНАМСЕСВСНАТУ. Сообщение ММ_СНАМСЕСВСНА!М генерируется 
при изменениях в цепочке окон просмотра буфера. В конце обработчиков этих 
сообщений надо функцией Эеп4Меззахе передать то же сообщение следующему 
окну цепочки, дескриптор которого вам вернула функция Зе СПрБоага Я1е\ег. 

Перед завершением приложения надо исключить свое окно из цепочки. 
Это делается функцией СВапхеСПрБоагаСват. Параметр В\У/пЯКетоуе — де- 
скриптор удаляемого окна, а параметр В\п9ЯМемМехё — дескриптор следую- 
щего окна в цепочке. 

Примеры применения всех этих функций см. в разд. 3.11. 


СозеНап@е — закрывает дескриптор объекта 
Закрывает дескриптор объекта 
Заголовочный файл штразе.й 


Синтаксис 


#1пс]1иае<и1пЬазе. в > 
ВОО С1озеНапа1е (НАМОЪЕ ВОЮ)ес®) 


Описание | 

Функция С1озеНапШе закрывает дескриптор ВОБес{ объекта. Это может 
быть дескриптор файла, открытого функцией СгезжеЕ Пе. В момент закрытия 
дескриптора файла все содержимое буфера записи переносится в файл. Деск- 
риптор ВОБес& может также относиться к событию, мьютексу, семафору, про- 
цессу, потоку и иным объектам. 

Вызов функции СюозеНапШе уменьшает на 1 число ссылок на объект. 
Если в результате число ссылок стало равно 0, объект удаляется из памяти. 

При успешном завершении функция возвращает ненулевое значение. 
В противном случае причину ошибки можно найти функцией Се Таз Еггог. 
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При ошибочном дескрипторе генерируется исключение. Это, в частности, мо- 
жет произойти, если функция вызвана для уже удаленного из памяти объекта. 


Созе\/ 11 до\ — сворачивает, окно, указанное его дескриптором 
Сворачивает, не уничтожая, окно, указанное его дескриптором 
Заголовочный файл штпизег.й 
Синтаксис 


#$1пс1аАае <илпизег.Н> 
ВООГ МТМАРТ С]1]озей1паом (ТМ НИМР В\па); 


Описание 

Функция С1ю5е\114о\ сворачивает, не уничтожая, окно, указанное его 
дескриптором В\Уп@. Для получения этого дескриптора можно использовать 
функцию Еша\т9до\. Если функция применяется к тому окну, в модуле ко- 
торого содержится обращение к функции, то в качестве дескриптора можно 
подставлять свойство Нап Ше. 

Например, оператор 


‚ С1озей1пдом (Напа1е); 


сворачивает данное окно. 

При успешном выполнении функция возвращает ненулевое значение. При 
аварийном завершении возвращается нуль. Тогда развернутую информацию 
об ошибке можно получить вызовом функции Се ТГа$4Еггог. 

Функция С1озе\/ш4ом, работающая с дескриптором окна, минимизирует 
окно, но не перемещает его в Полосу Задач. Применение функции С1озе\Ут- 
дом в этом случае эквивалентно заданию свойству \Утдом$ {же формы значе- 
ния м$Миии7ей. Или выполнению функции ЭвомУш@4о\ с параметром 
З\_ЭНОМ/МТМТМТРЕО. Чтобы действительно свернуть все окна текущего 
приложения так, чтобы остался только значок в Полосе Задач, надо приме- 
нить функцию С1озе\/т4о\ к дескриптору приложения: 


С1озейм1паом (Арр11саЕ1оп->Напа1е); 


Или направить главному окну приложения сообщение \М_$ЗУЗСОМ- 
МАШМО с параметром 8С_МИМТМГАЯЕ: 


'Роз&Меззаде (Напа1е, ММ 5У$5СОММАМО, $С МТМТМТСЕ, 0); 


СошЫтевоп — позволяет комбинировать различным образом два региона 
См. функцию СгезжеВесе Вот. 


СоруЕЦе, СоруЕПеЕх — копируют файл 
Копируют указанный файл 
Заголовочный файл И’пфазе.А 
Синтаксис 


#1пс1аае <И1празе.в> 
ИТМВАЗЕАРТ ВООГ МТМАРТ СоруЕ11ТеА ( 

ТМ ГРСЗТВ 1рЕх15Е1паЕ11еМапе, 

ТМ ГРСЗТВ 1рМ№емЕ11еМаще, ТМ ВООГ ЮЕГа11ТЕЕх1$65$); 
ИТМВАЗЕАРТ ВООГ ИМТМАРТ СоруЕ1Тей ( 

ТМ ГРСИЗТВ 1рЕх15$®1п3Е11еМапме, 

ТМ ГРСИЗТВ 1рМемЕ11еМаме, ТМ ВООГ ЬЕГа11ТЕЕх1$е$); 
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#1ЕАеЕ ОМТСОПЕ 

#$аеЁ1пе СоруЕ11е СоруЕ11ей 
#$е1зе 

#аеЁ1пе СоруЕ11е СоруЕ11еА 
#епа1Е // !ОМТСОРЕ 


суреаеЕ 
РИОВО (МТМАРТ *ГРРКОСВЕ$$ ВОЧТТМЕ) ( 
ТАВСЕ ТМТЕСЕВ Тоба1Е11е512?е, 
ТАВСЕ ТМТЕСЕВ Тофа1Ву®езТгапзЕеггеа, 
ТАВСЕ ТМТЕСЕВ 5&геам5$12те, 
ТАВСЕ ТМТЕСЕВ 5&геапВу®езТгапзЕеггесд, 
РИОВКО ам геамМатрег, 
РИОКО АмСа11БасКВеазоп, 
НАМОЪЕ ПбоцгсеЕ11е, 
НАМОЪЬЕ ЮРезЕ1па&1опЕ11е, 
ТРУОТО 1ррафа ОРТТОМАТ 
); 


ИТМВАЗЕАРТ ВОО МТМАРТ СоруЕ11еЕХА ( 
ТМ ГРСЗТВ 1рЕх15Е1п9Е11еМате, 
ТМ ГРСЗТВ 1рМ№емЕ11еМапе, 
ТМ .РРВОСВЕ$$ ВОЧТТМЕ 1рРгодгеззВоц&1пе ОРТТОМАЬ, 
ТМ ГРУОТР 1рраба ОРТТОМАЦ, 
ТМ ГРВООТ рЬСапсе1 ОРТТОМАЦ, 
ТМ ОМОВО АмСоруЕ1аа$); 
ИТМВАЗЕАРТ ВООЪ МТМАРТ СоруЕ11еЕхиИ ( 
ТМ ГРСИЗТВ 1рЕх1$61п9Е11еМапе, 
ТМ ГРСИЗТВ 1рМ№емЕ11еМапте, 
ТМ ГРРВОСВЕ$$ ВОЧТТМЕ 1рРгодгез5Воц®1пе ОРТТОМАЬ, 
ТМ РУОТР 1ррафа ОРТТОМАЦ, 
ТМ БРВООТ рЬСапсе1 ОРТТОМАЦ, 
ТМ ОМОВО АмСоруЕ1адз); 
#1ЕАеЕ ОМТСОБЕ 
#$АаеЁ1пе СоруЁг11еЕх СоруЕ11еЕхи 
#$е1зе 
$аеЁ1пе СоруЕ11еЕх СоруЕ11еЕхА 
#епа1Е // !ОМТСОБЕ 


Описание 

Функции копируют файл, указанный параметром 1рЕх1$ИпоЕЦеМате, 
в файл, указанный параметром 1рМемЕПеМате. | 

Если функции вернули 0 (#а15е), информацию об ошибке можно получить 
с помощью функции Се Га$Еггог. При копировании файла описываемыми 
функциями не копируются атрибуты доступа к файлу, но остальные атрибуты 
ЕП.Е_АТТЕТВОТЕ (см. в описании функции СгезжеЕ1е) копируются. Напри- 
мер, копируются атрибуты «только для чтения», «системный файл» ит.п. 

В функции СоруЕПе' параметр БРа!Ех1$ {$ определяет, что будет проис- 
ходить, если файл с именем 1рМ№емЕЦеМаше уже существует. При 
Га !ГЕх!5 5 = бтие функция вернет в подобном случае #а15$е. При 
ЪЕа 1 Ех15 4$ = Ёа]15е функция перепишет файл 1рМ№емЕПеМаше и вернет фгие. 

Функция возвращает 0 (#а]5е) также в случаях, если не найден файл-ис- 
точник или если не существует путь, указанный в р№емЕПеМате. 

Следующий оператор копирует файл с:\Тезх1 в каталог с:\Т, и копия бу- 
дет иметь имя Тез И ахЕ 


СоруЕ11е ("с:\\Тезе.Ехе", "с:\\Т\\Тез&1.6хе", Егие) 
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Функция вернет #а[5е, если нет файла с:\Тезхь или нет каталога СТ. 
А если последний аргумент в вызове СоруЕ Пе задать равным Ёа[5е, то функция 
вернет #а]5е и в случае, если файл ТезЕ14хЕ в каталоге сЛТ уже существует. 


Более широкие возможности по управлению копированием дает функция 
СоруЕЦеЕх. Параметр рРгоггеззВои пе может указывать адрес функции 
ГРРКОСКЕ$З5 _ВОТТТУЪЕ, которая обрабатывает процесс копирования и мо- 
жет выдавать пользователю соответствующую информацию. Параметр 
]1рдафа — указатель на произвольные данные, которые могут быть переданы 
в функцию обработки. Эта функция будет рассмотрена несколько позднее. 
Если задать рРгоэгез5Коийпе = МОГ, то обработка процесса копирования не 
предусматривается, а параметр 1рдафёа игнорируется. 

Параметр рЬСапсе! указывает на переменную, которая может использо- 
ваться для прерывания копирования, если ее значение станет равным фгае во 
время копирования. 

Параметр ЧУ Сор аЕз может быть комбинацией следующих флагов: 
СОРУ_ ЕШЕ_ РА, _ ТЕ ЕХ!ЗТ$ ' Копирование прерывается как ошибочное, 
_ | если файл 1рМ№емЕЦеМаше уже существует. 


СОРУ_ ЕПЕ_  ВЕЗТАВТАВГЕ. `Скопированная часть файла копии остается 
в каталоге-приемнике, если копирование было 
прервано. Тогда копирование может быть про- 
должено при новом вызове СоруЕПеЕх с теми 
же значениями 1рЕх15поЕШеМаше и [рМ№ем- 


Ша __ 


Рассмотрим примеры. Следующий оператор копирует файл сЛТезёлл 
в каталог с:\Т, и копия будет иметь имя Тез ИахЕ 


СоруЕ11еЕх ("с:\\радеЁ11е.зуз", "с:\\Т\\ТезЕ1. хе", 
МОЪЬ, МОГ, 0, 0); 


Функция вернет #а15е, если нет файла с\Тезёхь или нет каталога с:\Т. 
А если последний аргумент в вызове СоруЕЦеЕх задать равным СОРУ_ЕП.Е_ 
КАП, ТЕ ЕХТЗТ$, то функция вернет #ае и в случае, если файл Тез 142+ 
в каталоге с^Т уже существует. 


Теперь рассмотрим использование функции обработки процесса копирова- 
ния. Эта функция создается пользователем, а ее адрес указывается в вызове 
СоруЕПеЕх параметром рРгосгеззВои те. Если значение этого параметра не 
МОТЕ, то в процессе копирования регулярно будет вызываться функция обра- 
ботки процесса копирования. Ее параметры Тоба1ЕЦе512е и Тофа1ВуеТгапз- 
Гегге4 содержат соответственно размер файла в байтах, и число уже скопиро- 
ванных байтов. Параметры 5%ёгеат512е и 54геатВуеТгапзЁегге4 содержат 
аналогичные данные относительно потока, который осуществляет копирова- 
ние. Параметр 4м5&геатМишфег содержит номер потока (обычно 1, но может 
создаваться и несколько потоков). Параметр а4мСаПБасКВеа5оп указывает, 
что именно привело к вызову функции: САТТВАСК _СНОМК_ЕТПМТНЕР — 
скопирована очередная порция данных, САГТВАСК _ЭТВЕАМ_$М\МТТСН — 
создан новый поток копирования. Параметры вЗоигсеЕ!е и В)езИпаНопЕЙе 
содержат дескрипторы соответственно входного и выходного потоков. Пара- 
метр 1р)авёа является указателем на необязательные дополнительные данные, 
переданные в функцию аргументом 1р)айа в вызове функции СоруЕШеЕх. 
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Функция должна возвращать одно из следующих значений: 


РКВОСВЕЗЗ _СОМТИМОЕ | Копирование продолжается. _ 


РВОСВКЕ$5_САМСЕГ, Копирование прервано и скопированная часть копии 
‘удалена с диска. 


РКОСВЕ$5_5ЭТОР Копирование остановлено. Оно может быть продол- 


| жено в дальнейшем. 


РКОСКЕ$5_©ООТЕТ Копирование продолжается, но функцию обработки 


больше не надо вызывать. 


Рассмотрим пример использования функции обработки процесса копиро- 
вания. Пусть в приложении на форме Еогт]1Т имеется полоса состояния 
Эта а$Ваг1, в которой вы хотите отображать ход процесса копирования. Для 
этого вы можете реализовать следующую функция обработки: 


РИОВР __3Е4са11 МУРВОСВЕ$$ (ТАВСЕ ТМТЕСЕВ Тофа1Е11е512е, 
ТАВСЕ ТМТЕСЕК Тофа1ВукезТгапзЕеггеа, 
ТАВСЕ _ТМТЕСЕВК 5©геам$12е, 
ТАВСЕ ТМТЕСЕК 5&геапВуезТгапзЕеггеа, 
ОМОЕКО Чи5е геамМапфег, 
ОМОВКО ЯмСа11]БасКВеазоп, 
НАМОТЕ ИбочгсеЕ11е, 
НАМОТЕ РПОезЕ1паЕ1опЕ11е, 
ТРУОТО 1ррафка ОРТТОМАЦ) 
{ 
Гоги1->5$фаба$Ваг1->51тр1еТехе = "Скопировано " + 
ТпЕТозЕг (5 геапВу$езТгап$Ееггеа.ОцааРаг®е >> 10) + 
" КБ из " + ТОЕТобЕг (56 геам5$12е.ОпааРахг® >> 10); 
гебагп РКОСВЕЗ$ СОМТТМОИЕ; 
} 


В этом коде значения параметров З4геатВу4ёеТгап$Ёегге4 и 54геат$17е 
с помощью функции-элемента @9ца4Раг& типа ГАВСЕ ТМТЕСЕВ, переводятся 
в целое, сдвигаются на 10 разрядов, чтобы преобразовать число байтов в число 
килобайтов, и результат выдается в полосу состояния. 

Вызов функции СоруЕПеЕх, обеспечивающий использование введенной 
функции, имеет вид: | 

1Е (СоруЕ11еЕх ("с:\\радеЕ11е.зуз", "с:\\Т\\ТезЕ1. хе", 

&МУРВОСВЕ$$, МОБ, 0, 0)) 
Коги1->5фасазВаг1->51тр1еТехЕ = "Копирование завершено"; 


е1зе Гогп1->5бабазВаг1->51тр1еТехе = "Ошибка: " + 
сузЕггогМезасае (СееТаз Е Еггог ()); 


В этом примере не использовался параметр 1р)афа. Пусть теперь мы хотим 
передать через этот параметр имя копируемого файла. Тогда операторы вызова 
функции СоруЕПеЕх могут выглядеть так: 

Ап5156г1па $5 = "с: \\радеЕ11е.зуз"; 

1Е (СоруЕ11еЕх ($.с $%г(), "с: \\Т\\ТезЕ1.Ехе", &МУРВОСВЕЗ$, 

&5, 0, О0)) 
ГКоги1->5фаеа$Ваг1->51тр1еТехе = "Копирование завершено"; 

е15е Гоги1->5баба$Ваг1->51тр1еТех® = "Ошибка: " + 

Зу5ЕггогМе$ асе (СееГаз®Егкгог ()); 


Тогда оператор, отображающий данные в функции МУРВОСВЕ$$, может 
быть переписан следующим образом: 
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Гоги1->5$аба$зВаг1->51тр1еТехе = "Файл " + 
* ((Ап$15Ег1па *)]ррафа) +": скопировано " + 
ТпЕТозег (55 геапВу$езТгапзЕеггеа .ОчаРаг® >> 10) + 
" КБ из " + ТаЕТобег (5Егеам5172е.ОпцааРак®е >> 10); 


СоруЕПеЕх — копирует файл 
См. функцию СоруЕ Пе. 


СоруЕЦеТо — копирует файл 
Копирует указанный файл 
Заголовочный модуль ГаС1ора1.Ррр 


Синтаксис 


#1пс]10аае <Тас1оБа1.Врр> 
Еипс®1оп СоруЕ11еТо (сопзЕ боигсе: зЕг1па; 
соп5Е РезЕ1па&1оп: $з6хг1па): Воо1еап; 


Описание 

Функция копирует файл Зойгее в файл Безипайоп. Копируются и атри- 
буты файла, такие как «только для чтения», «системный файл» и др. Атрибу- 
ты доступа к файлу не копируются. 

Функция возвращает #а]зе, если имя файла-источника БезНпаЙоп оши- 
бочно, если нет папки, указанной в имени ВезИпайоп, или если файл Оезйпа- 
Ноп уже существует. 


Пример 
Следующий оператор: 
СоруЕ11еТо ("с:\\Тезе.Ехе", "с: \\Т\\Тезе1. хе") 
копирует файл с:\ТезЕ4хт в папку с/ЛТ под именем Тез 11хт. Функция вернет 


Га]5е, если нет исходного файла, если нет папки с:\Т, или если эта папка есть, 
но в ней уже имеется файл Тез 1х. 


СоруЕгот — метод копирования 
См. ТЕЦе{геат. 


СгежеВгиз п 1гес{ — создает дескриптор нестандартной кисти 
Создает дескриптор нестандартной кисти контекста устройства 
Заголовочный файл штяа:.й | 
Синтаксис 


#1пс1аае <м1паа1.6> 


фуре4еЕ зегасе ФаадросвВво$нН 


{ 
ОТмТ 165%у1е; 
СОГОВВЕЕ 16Со1ог; 
ОЪОМС_РТВ 1ЬНаеси; 
} ГОСВВО$Н, *РЬОСВВО$ЗН, МЕАВ *МРЬОСВВОЗН, ГАВ`*ГРЬОСВКВОЗН; 


ИТМСОТАРТ НВКОЗН СгеафеВгазВТпЯ1гес® (ТМ СОМ$5Т ТОСВВИЗН * 1р15); 


Описание 
Функция СгежеВги$ В штгес& создает дескриптор нестандартной кисти для 
контекста устройства. Единственный параметр функции является указателем 
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на структуру типа ГОСВВО$Н, имеющую поля №5%4е — стиль, ЮСоюг — 
цвет, НаёсВ — заполнение. Поле №54Яе может принимать значения: 


В$_П1ВРАТТЕЕВМ, Шаблон кисти, определяемый спецификацией ПВ. Сам 
В$ _ПВРАТТЕВМ8Х8 | шаблон должен задаваться полем №НафеВ. Для \У/т- 
о\з 95 размер более чем 8 х 8 не поддерживается. 


В$ П1ВРАТТЕВМРТ |Палитра кисти, определяемая спецификацией ОВ. 
Сама палитра должна задаваться полем №НафеВ. 


В$_НАТСНЕР Кисть со штриховкой. _ 
В$_НОТТОМ, | Пустая кисть. 
В$_МОБЕ 


В$_РАТТЕКВМ, Шаблон кисти в виде битовой матрицы. 
В$ РАТТЕВМ8Х8 
В5_ЗОГО Сплошная заливка. __ 

Поле №Со]ог структуры ГОСВВОЗН определяет цвет кисти. Для пустой 
кисти и шаблона в виде битовой матрицы этот параметр игнорируется. Для 
шаблонов ПВ указывается наборы цветов: О1ТВ_РАТ, СОГОВ5 — текущая па- 
литра, МВ _ВСВ_СОТГОВ5 — значение, формируемое макросом ВСВ из крас- 
ного, зеленого и синего. 

Поле №НафВ игнорируется для сплошной или пустой кисти. Для шаблонов 


значение поля должно указывать на соответствующий шаблон. А для кисти со 
штриховкой поле ФНаёсВ может принимать одно из следующих значений: 


Н$_ВОТАСОМАГ == Косая штриховка снизу вверх. 


Н$_СКоО55 Штриховка горизонтальная и вертикальная. 


Н$_ПОТАССКО55 Крестообразная косая штриховка. 


Н$_ЕОТАСОМАГ Косая штриховка сверху вниз. | 
Н$_НОВт7ОМТАГ, Горизонтальная штриховка. _ 
Н$_УЕВТТСАГ Вертикальная штриховка. 


При успешном выполнении функция возвращает дескриптор кисти, кото- 
рый далее может быть передан контексту функцией З@аесОес{. В случае 
ошибки возвращается МОТ. 

После того как кисть более не нужна, ее следует удалить функцией 
РеееОБ}ес+. 


Например, следующие операторы создают дескриптор сплошной красной 
кисти: 


ТОСВВКО$ЗН 1р1Ь; 

1р1ю.165%у1е = В$_50.ТВ; 

1р16.1ЮСо1Тог = с1Веа; 

НВВКО$Н ВКеаВгазВ = СгеасбеВго$ВТпа1гкес® (&1р1Ъ); 


Значение поля №Со]ог можно было бы задать и с помощью макроса ВСВ: 
1р16.16Со1ог = ВСВ (255, О0, 0); 
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А если в приведенном коде изменить значение поля 5&е и задать 
6 НаеВ следующим образом: 


1р1ь.1Юю56у1е = В$ НАТСНЕБВ; 
1р1ь.15Наесь = Н$ ВОТАСОМАГ; 


то кисть будет заполнять поверхность диагональной красной штриховкой. 


Впрочем, в большинстве случаев сплошную кисть проще создавать функци- 
ей СгежеЗо19ЧВгизВ, а кисть со штриховкой — функцией СгежеНа&е В Вгиз В. 


См. также другие функции создания дескриптора кисти: де фосКОес+, 
СтежеЗопЧВгизВ, Сгеа{еНа&сЬВги$ в, СгеафеРавйегиВги$ В. 


СгежеЕШрисВ оп — формирует область в виде эллипса 
См. функцию СгеафеВес& Вот. 


Сгеже ШрисВ оп ш1тгесё& — формирует область в виде эллипса 
См. функцию СгеафеВес& Вт. 


СгеафеЕуеп{ — создает событие 
Создает событие 
Заголовочный файл шпбазе.й 


Синтаксис 


#1пс1аае <м1пБазе.Н> 

НАМОЬГЕ СгеафеЕхуепе (ТМ .РУЕСОКТТУ _АТТВТВОТЕ$ 1рЕуеп АЕ ег1расез, 
ТМ ВООТ БМапча1Везе®, ТМ ВООЪ Б1п161а156афе, 
ТМ ГРСЗТК 1рМаме); 


Описание 

Функция СгеафеЕуепф создает объект события (см. разд. 3.5). Параметр 
1рЕуе А бгЮие$ является указателем на структуру типа ЗЕСОВТТУ_АТ- 
ТАТВОТЕ$ или ТЗесогцуА г ие5 (см. в данной главе подробное ее описа- 
ние), определяющую, будет ли наследоваться возвращенный дескриптор до- 
черними процессами. Значение параметра 1рЕуеп 6 АНг ше можно задать 
равным МО... Это будет означать, что дескриптор не наследуется, и что будет 
использоваться дескриптор защиты процесса, заданный по умолчанию. Пара- 
метр БМаппа|!Ве5е{ определяет тип события: фгие — с ручным управлением, 
Га]5е — с автоматическим. Параметр БПийа1 $ $а&йе задает начальное состоя- 
ние: фгие — сигнальное, #а]5е — несигнальное. Параметр 1рМаше определяет 
имя объекта. Если имя соответствует уже существующему объекту, то пара- 
метры БМаппа!Везеё и Би а15 {же игнорируются, так как они уже установ- 
лены для события. Если при этом параметр 1рЕуеш 6 Авг ифе$ не равен МОТ, 
то он задает только наличие или отсутствие наследования, а дескриптор защи- 
ты игнорируется. Параметр 1рМате задает имя события и может равняться 
МОТТ — тогда создается событие без имени. Такое событие можно использо- 
вать в рамках одного процесса. Но его невозможно контролировать в другом 
процессе. Имя события не должно совпадать с именем синхронизирующего 
объекта другого типа: мьютекса, семафора и т.д. 

В случае успешного выполнения функция СгежеЕуеп{ возвращает деск- 
риптор события. Этот дескриптор может использоваться в любых функциях 
ожидания. Функции будут ожидать, пока событие не перейдет в сигнальное 
состояние. 
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Если событие, указанное в функции СгежеЕует&, уже существует, то 
функция вернет его дескриптор. Узнать после вызова Сгеза&еЕуепф, существо- 
вало ли раньше указанное событие, можно оператором: 


1Е (СектазЪЕггог () == ЕВВОВ_АЪВЕАОУ ЕХТ$Т$) 


Примеры применения функции СгежеЕуепф см в разд. 3.5. 


Сгез{еЕЦе — создает или открывает различные объекты 


Позволяет создать или открыть самые различные объекты: файлы, порты, 
диски, каталоги 


Заголовочный файл ифпфбазе.й 
Синтаксис 


#1пс1аае<и1пЬазе. в > 

НАМОТЕ СгеафеЕ11е (ГРСТЗТВ 1рЕ11еМаме, ОМОВОР Чмрез1гедАссез$$, 
РИОВР амбвагеМмоае, 
.РЗЕСОВТТУ АТТВАТВОТЕ$ 1р5есиг1 Е уАеег1риафез, 
ОИОВО амСгеа*1оп013Ег1БаЕ1оп, 
ОМОВР амЕ1ачзАпачаАЕЕг1риеез, 
НАМОТЕ БТепр1афеЕ11е); 


Описание | 

Функция СгежеЕ Пе позволяет создать или открыть самые различные объ- 
екты: файлы, порты, диски, каталоги (только открыть) и др. Она возвращает 
дескриптор указанного объекта и определяет множество флагов, регулирую- 
щих доступ к нему. | 

Параметр 1рЕ!еМате является указателем на полный путь с именем объ- 
екта: открываемого или создаваемого файла, порта и т.п. Этот параметр имеет 
некоторые ограничения: его длина не должна превышать константу 
МАХ_РАТН. В У тдомз МТ возможно использование путей, более длинных, 
чем МАХ_РАТН, с добавлением перед путем символов «\\$\». Это сочетание 
символов указывает, что требуется синтаксический анализ пути, причем сами 
эти символы не будут добавляться в путь. Например, если вы напишете: 
«\\2\О:\тура!\\...», это будет воспринято как «О:\тура!И\...». 

Параметр 4мОез1гед Ассе$$ определяет права доступа к объекту. Приложе- 
ние может получить доступ для чтения, доступ для записи, доступ для чтения 
и записи. Параметр может быть комбинацией следующих значений: 


Позволяет определить атрибуты устройства, не открывая его. 


СЕМ ЕВТС_ВЕАО |Определяет доступ для чтения и перемещения курсора. 


‚ СЕМЕВС_МЕТЕ | Определяет доступ для записи и перемещения курсора. 


Например, комбинация СЕМЕВС_ВЕАР | СЕМЕВ!С_\У/ЕВТЕ определяет 
доступ для чтения и записи. 

Параметр ЧмЭВагеМо4е определяет совместный доступ к объекту, т.е. 
можно ли читать и писать в него одновременно нескольким приложениям (на- 
пример, по сети). Этот параметр может быть комбинацией следующих значе- 
ний: 
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—— —: == ——— 


— Совместный доступ невозможен. 


ЕП.Е_ ©<НАВЕ _ РЕГЕТЕ Совместный доступ разрешает удалять файл (только 
для УЛшт4о\м$ МТ). 


ЕПЕ_ ЗНАВЕ_ ВЕАР. | _, Совместный доступ для чтения. 
ЕТЕ_ ЗНАВЕ_ _МВТТЕ_ _| Совместный доступ для записи. 


Например, комбинация ЕП.Е_$НАВЕ _ВЕАР | ЕПЕ_$ЗНАВЕ_ МЕТЕ 
обеспечивает другим приложениям доступ для чтения ‘и записи. 

Параметр 1р5ЭесигцуАИг,ще$ является указателем на структуру 
ЗЕСОВТТУ_АТТЕТВОТЕ$ или Т5ЗесигцуАИг иез$ (см. в данной главе под- 
робное ее описание), которая определяет, может ли дескриптор быть использо- 
ван процессами-потомками. Если фЭесигцуА ИгЬше$ = МОГГ, дескриптор 
не может быть унаследован. При работе в У/ш4омз МТ поле структуры 
- 1рЭесигцу)езег1рфюг определяет параметр безопасности для объекта. Если 
1р5есигцуА г Юще$ = МО, объект получает параметр по умолчанию. Фай- 
ловая система должна поддерживать режим безопасности. В \У/1194о\з 95 поле 
]р5Зесиг цу )езег1рфог игнорируется. 

Параметр 4мСгеаИоп 1 {гФиИоп определяет действие с файлом. Значе- 
ние этого параметра может принимать одно и следующих значений: 


`сввате. МЕМ Создает в новый файл. Ошибка, если указанный файл 


о | —_ уже существует. 
СВЕАТЕ _АТМАУ$ _ Создает новый файл.  Переписывает файл, если он 
| . уже существует. _ 
ОРЕМ_ЕХТЗТИМС ‘Открывает файл. Функциональные сбои, если файл 


‚не те существует. 


ОРЕМ _АТМАУ$ Открывает файл, если он существует. Если файл не 
, существует, функция создает его. 


ТВОМСАТЕ _ ЕХИЕТИМ@ Открывает существующий файл и устанавливает его 
размер равным нулю. Файл должен открываться, по 
‘крайней мере, с доступом СЕМЕВС_МЕ]ТЕ. Ошиб- 
_| ка, е‹ если файл не не существует. | 


Различные часто встречающиеся комбинации флагов и реакцию системы 
на функцию СгежеЕШе с этими комбинациями флагов см. в разд. 6.7.1. 

Параметр ОмЕ1а5$АпЧА Йгще$ — определяет атрибуты и флаги файла. 
Можно использовать эти атрибуты в любых сочетаниях, но все их перекрывает 
атрибут ЕП.Е_АТТЕАВОТЕ_МОКМАТ. 


Е р титиииииныния -= Е 


ЕП.Е_ЕТАС _ ‚ Записывает данные сразу на диск без предваритель- 
УЕТТЕ_ ТНЕООСН | Ной записи в буфер. 


ЕП.Е_ЕГАС_ Этот флаг, требующий определения в функциях Ве- 

ОУЕКВГАРРЕР а4ЕПе и УгцеЕ!е структуры ОУЕВГАРРЕО (ТОуег- 
| Шарред). Он используется в асинхронных режимах 

чтения и записи в устройства. 


ЕПЕ _ЕГАС_МО_ Открывает файл без использования промежуточного | 
БОРЕЕНМ@ _\ буфера. — 
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ж—мщ——=— ————— ——1 


Е Си и 
| ЕЕ_ЕГАС_ ро обращение к произвольной позиции фай- | 
- 

| 

| 


ВАМООМ _АССЕ$$ ла. Флаг используется У/ш4о\з для соответствую- 
| —_ | щей оптимизации кэширования файла. 


ЕП. _ЕТАС_ `Разрешает только последовательный доступ к файлу 
СЕООЕМТТАТ, $САМ от начала к концу. Флаг используется \У/11140\$ для 


| соответствующей оптимизации кэширования файла. | 
Пе — 
н 


‚РПЕ_ЕТГАС_ Сообщает системе о том, что она должна удалить файл ! 
РЕГЕТЕ _ ОМ. _СТОЗЕ после того, как все его указатели будут закрыты. 


—— 
ЕПЕ_ЕТГАС_ Создает или открывает файл резервной копии данных. 
 ВАСКОР_$ЗЕМАМТТС$ |При этом исключается проверка безопасности файла 
_ |Операционной системой (только для У/т4о\з М Т).. 


| 
| 
| 
| 
| 


| 
 ЕТЪЕ_ЕГАС_ | Требует обращения к файлу согласно правилам РОЗГХ 
| РОЗТХ_ЗЕМАМТ!С$ _ —_ о В 


Параметр ВТешр1а4еЕЙе определяет дескриптор с доступом СЕМЕЕВС_ 
ВЕАО к шаблону файла и задает шаблону атрибуты созданного файла. Для 
У!119омз 95 этот флаг должен быть равен МОШ.. Если вы все-таки зададите 
его, то ае Газ Еггог возвратит значение, равное ЕККОВ_ МОТ ЗОРРОКТЕО. 


Функция Сгеа4еЕЦе при успешном выполнении возвращает дескриптор 
устройства (файла). Если при вызове функции происходят какие-либо ошиб- 
ки, их код можно определить с помощью функции Се Га$Еггог. 


Ниже приведен пример оператора создающего файл с именем «Му. 5х 
в папке «с:\$тр» с доступом к нему для совместного чтения и записи: 
НАМОГЕ Н= СгеафкеЕ11е ("с:\\&пр\\Му. хе", СЕМЕВТС_ВЕАР | СЕМЕРТС МВТТЕ, 


ЕТЬЕ ЗНАВЕ ВЕАР|ЕТЬЕ ЗНАВЕ_МВТТЕ, 0, 
СВЕАТЕ АГМАУС, ЕТЬЕ_АТТВТВОТЕ МОВМАТ, №0); 


Предполагается, что каталог уже существует. Если он отсутствует, то вы- 
зов функции. завершится неудачей. 

_ Для закрытия дескриптора файла, полученного функцией Сгеа4еЕПе, ис- 
пользуется функция С]озеНапе. 

В У!т4о\мз МТ вы можете использовать функцию Сгеа4еЕ Пе для открытия 
дисковода. Функция возвращает указатель на дисковые устройства. Указатель 
может использоваться с функцией Оеу1се ОСопфго! и должны быть выполне- 
ны некоторые требования: 


1. Пользователь должен иметь права администратора. 


2. Чтобы открыть физический жесткий диск с номером х, путь к файлу — 
аргумент 1рЕПеМаше в вызове СгеафеЕПе должен иметь форму «\\.\РНУ- 
ЭСАГОВНТУЕх». Номера жесткого диска начинаются с нуля. Например: 
«\\.\РНУЗМСАГОЕУЕО» — это первый физический диск компьютера по- 
льзователя. | 


3. Чтобы открыть накопитель на гибких дисках или открыть один из логиче- 
ских дисков, на которые разбит физический диск, путь к файлу — аргу- 
мент 1рЕПеМаше в вызове СгезеЕПе должен иметь форму «\\.\х:», где 
х — буква диска (регистр буквы не имеет значения). Например: 
«\\.\А:» — диск А, «\\.\4:» — диск О. 
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4. Аргумент 4мСгеаНоп 015 гой оп в вызове СгеафеЕЙе должен иметь флаг 
ОРЕМ_ЕХТЗТТМХС. 


5. При открытии гибкого или жесткого диска вы должны в аргументе ам Ва- 
геМоде в вызове СгезеЕЩе установить флаг ЕП/Е_ЗНАВЕ_ МЮВТЕ. 


Функция Сгеа4еЕ Це не может создать папку. Для создания папки надо вы- 
звать функцию СгеафеП1гесфогу или Сгеа&еО1гесфогуЕх. В У ш4омз МТ вы мо- 
жете получить дескриптор к папке, задав в параметре Ом 1а5АпЧАЙг ще 
флаг ЕШШЕ_ЕГАС_ВАСКОР_ЗЕМАМТТС$. Дескриптор папки можно пере- 
дать некоторым функциям \1132 вместо дескриптора файла. 

После окончания работы с файлом, открытым функцией Сгез4е Е 1е, деск- 
риптор файла над закрыть функцией С1озеНапе. 


Основные операции с файлом, открытым функцией СгежеЕ Це, осуществля- 
ются функциями АРТ \Ушп4омз ВеааЕПе и УтцеЕЦе — чтение и запись, 
Зе ЕЦеРойцфег — позиционирование курсора, ЕТазВЕПеВиЁег$ очистка буфера. 


См. многочисленные примеры применения функции СгезжфеЕ Пе в разд. 2.5, 
6.1.2, 6.7, 


СгежеГопф — создает логические шрифты 
Создает на основе имеющихся шрифтов логические шрифты 
Заголовочный файл Утава1.й | 


Синтаксис 


НЕОМТ СгеафеГоп® (ТМ 1пЕ пНелзаве, ТМ 1пе пи1ажь, 
ТМ 1пЕ пЕзсаремеп®, ТМ 1пе пЕзсаремепе, 
ТМ 106 пОг1епфа1оп, ТМ ОМОВКО ЕпМелаве, 
ТМ ОМОВО ЕамТеа11с, ТМ ОМОВО ЕамОпаек11пе, 
ТМ ОМОВО Еам$Ег1кКеод0е, ТМ ОМОКО ЕамСваг$ек, 
ТМ ОРИОВО ЕамОц&ра®Ргес1$1оп, 
ТМ ОИОВО ЕамсС11рРгес1$1оп, 
ТМ РИОВО ЕамОца11®у, 
ТМ ГРСЗТВ ЕамР16спАпаЕГап11у); 


Описание 

Вы можете создавать на основе шрифтов свои собственные логические 
шрифты и использовать их в приложении. Например, нередко разработчики 
хотят делать надписи, расположенные вертикально или под каким-то углом. 
Все это можно делать, создавая логический шрифт функцией СгезжеЕоп%. Этот 
шрифт может использоваться для вывода текста на канву любого устройство. 
Если в системе не зарегистрирован шрифт с заданными характеристиками, 
система подбирает шрифт, наиболее близкий к заданному. 

Параметр пНе!В{ указывает высоту в логических единицах символов 
шрифта (если задается отрицательное значение) или ячеек, в которые вписы- 
ваются символы (если задается положительное значение). Если задано значе- 
ние 0, берется высота по умолчанию. Обычно целесообразно задавать отрица- 
тельное значение. Это то же значение, которое задается в свойстве Нез 
класса ТРоп&. И соотношение его с размером шрифта определяется так же, как 
в ТРопё: —11 соответствует размеру 8, —13 соответствует размеру 10 ит.д. Если 
задано ненулевое значение, система подбирает наиболее крупный шрифт с вы- 
сотой, не превышающей заданную. 
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Параметр п УВ указывает среднюю ширину символов. Если задано зна- 
чение 0, система сама выбирает подходящую ширину символов. 

Параметр пЕ5зсаретепф указывает в десятых долях градуса угол наклона 
надписей, которые будут выполняться данным шрифтом. А параметр 
пОпета1оп определяет угол наклона символов. Впрочем, эти значения можно 
задавать раздельно только для У/шдо\з МТ/200/ХР при работе в графическом 
режиме @М_АРУАМСЕО. В остальных случаях параметр пЕзсаретеп опре- 
деляет оба наклона и значение пОмета1оп надо задавать равным пЕзеаре- 
тепф. 

Параметр п \У еше определяет толщину символов. Значение этого пара- 
метра можно задавать в пределах от 0 до 1000. Значение 0 соответствует тол- 
щине по умолчанию. Другие значения можно задавать целыми числами или 
следующими константами: 


Константа 
ЕМ_ПОМТСАВЕ 


Е\ ОТТКВАШСНТ 
Е\ ТЛСНТ 


ЕУ\У/_МОВМАГ, 400 
Е\У_ВЕСОГАЕ 400 


Е\_МЕОГОМ 
Е\/ ЗЕМТВОГО 
Е\ РЕМПВОГО 


Е\ ЕХТВАВОГО 
ЕУ\У_ОТТЕАВОГЬ 
ЕУ\У/_НЕАУУ 
Е\/’_ВГАСК 


Параметры Ё{амЦаПе, #4мОпд4егИпе и {ам бКеОщ управляют модифика- 
циями шрифта: курсив, подчеркнутый, зачеркнутый. Если параметр равен 0, 
соответствующая модификация выключена, при значении 1 — включена. 

Параметр #аАмСВагЭе{ задает множество символов. Обычно используется 
значение РЕРАОТТ_ СНАВКЗЕТ — множество символов по умолчанию. Это 
значение в наибольшей степени гарантирует вас от неприятных сюрпризов, 
связанных с отсутствием на компьютере пользователя требуемого шрифта с за- 
требованным множеством символов. Можно также задавать значение 
ВО55ТАМ_СНАВЪЗЕТ, если есть уверенность, что множество символов кирил- 
лицы имеется в требуемом шрифте. Для вывода текста, записанного символа- 
ми МБ ООВ, следует задавать значение ОЕМ_СНАКЪЗЕТ. 

Параметр #4мОифри Ргес1$10п определяет поведение системы при поиске 
шрифта, наиболее соответствующего заданному. Обычно используется одно из 
следующих значений этого параметра: 
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ыы 1 
Значение О [ Опивавие 
ООТ_РЕРАЗЕТ_РВЕСГЗ | Поведение по умолчанию. 

М р рр рр) Уд . 

| ООТ РЕ\У!ТСЕ_РВЕС!$ Если имеется несколько шрифтов с одинаковым 

| именем, выбирается шрифт устройства. 


ООПТ _ ООТЫМЕ_ РКЕС!$ (Шрифт ищется среди прифтов типа ТгаеТуре 
и других эскизных типов. 


ООТ_ ВАЗТЕВ _ РЕЕСТЗ. . Если имеется несколько шрифтов с одинаковым 
‚именем, выбирается растровый шрифт. 


ОПТ ТТ ОМГУ _  РЕЕСи$ Идет поиск только шрифтов ТгаеТуре. Если нет 
| установленных шрифтов ТгиаеТуре, реализуется по- 


| ведение по умолчанию. 
——_—_— - А _ - - —— 


ОПТ ТТ_ РЕЕС!$ Если имеется несколько шрифтов с одинаковым 
____ (Именем, выбирается шрифт ТгиеТур. 


Параметр #АамСПрРгес1$10оп определяет, как производится усечение симво- 
лов, частично не помещающихся в заданную область. Обычно используется 
значение СТТР_РЕРАОТТ РКЕСТЗ — усечение по умолчанию. 

Значение параметра #Ам@иаШу обеспечивает критерий компромисса меж- 
ду качеством отображения символов и точностью соответствия шрифта задан- 
ным требованиям. При значении РЕЕАОТГТ @ОАШТУ приоритет отдается 
точности соответствия заданным требованиям. При значении РВООЕ_ФОА- 
СТТУ на первое место выдвигается качество отображения символов. Значение 
ОКАЕТ ОФОАШЫШТУ — промежуточный вариант. 

Параметр #4мРЦеВАп9аЕат у определяет шаг размещения символов, рас- 
стояние между ними. Точнее, это определяется двумя младшими разрядами. 
Они могут задаваться константами РЕРАТЗТЕТ_РТТСН — по умолчанию, 
ЕТХЕР_РТТСН — фиксированный шаг, УАВТАВГЕ _РТТСН — изменяющийся 
шаг. Старшие разряды определяют некоторые характеристики семейства 
шрифтов 

Параметр 1р$2Еасе является указателем на строку с нулевым символом 
в конце, определяющую имя шрифта. Длина строки не должна превышать 32 
символов. 

Как видно из изложенного, логический шрифт создается на основе како- 
го-то из шрифтов, зарегистрированных в системе. Задаваемые параметры слу- 
жат только ориентиром при выборе подходящего шрифта. Если шрифт уда- 
лось подобрать, функция СгезжеРГопё возвращает его дескриптор. В дальней- 
шем этот дескриптор можно передавать канве устройства, на которое выводит- 
ся текст. Если шрифт подобрать не удалось, возвращается 0. 

После того как созданный логический шрифт использован, его надо уда- 
лить из памяти функцией ее еОЦес&, в которую передается дескриптор 
шрифта. 

Примеры использования функции Сгеа&еЕоп& вы найдете в разд. 1.14. 
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СгежеЕоп пЧ1гес& — создает логические шрифты 
Позволяет создавать и использовать логические шрифты 
Заголовочный файл И и4оиз.Й 
Синтаксис 
НЕОМТ Сгеа®еЕГопЕТпа1гес® (1М№ СОМ5Т ГОСРГОМТА`* р1) 


Описание 

На основе существующих шрифтов можно создавать свои собственные ло- 
гические шрифты и использовать их в приложении. Например, нередко разра- 
ботчики хотят делать надписи, расположенные вертикально или под каким-то 
углом. Все это можно делать, создавая логический шрифт функцией Сгеа- 
феРоп п@гес+. Этот шрифт может использоваться для вывода текста на канву 
любого устройство. | 

Атрибуты шрифта задаются элементами структуры р1 типа ТГо#Еоп+. Эта 
структура имеет следующие поля: 


Поле структуры типа "Аналогичный параметр гр 0 Описание | 
ТровЕРоё о функции СгедеРо | 


| тОМ@ Нес _ оне Высота символов шрифта 
‘или ячеек, в которые впи- 


—- ТЯ С 


| 

‘рома. Та зав И ам _ О | Средняя пп ширина символов 
| ГоМ@ НЕзсаретет в: ` пЕзсаретеп _ | УГОЛ наклона надписей. | 
хоме НОнещайоп —_ пОмешаюп — _____ | Угол наклона символов. — 
| ГОМС Н\Уещ _ | тУеа в _ | Толщина символов. 
=———Н- —— д 

|ВУТЕ. ВУТЕ ИЦаЦс Иман Куре. с р 
ВУТЕ ИОпдегИпе _гач’ОпёегНпе_ Подчеркнутый шрифт. 
Ы— ООО ВВОДОВ 

[ВУТЕ 1 ВУТЕ ИЗбкеО4 {4х5 и\ще0щ — | Зачеркнутый шрифт. _ 
| ВУТЕ ИСВаг5е ____ |4 Сваг5е __ | Множество символов. — _ 
ВУТЕ 1 ОцёРгес1 101 ‚ ЕауОпёри{Ргес1510п ‚Определяет поведение сис- 

| ‘темы при поиске шрифта, 

| ‚наиболее соответствующего 

--— заданному. | 

о Ш и 
ВУТЕ НИСПрРгес1$10п га\СНррРгес!з1юп Определяет, как произво- | 
ОИ Пи __ _ дится усечение символов. — 

| ВУТЕ Н9цаШу | [9мОпаШу | ‘Обеспечивает критерий | 
| | ‘компромисса между качест- | 
‚ | вом символов и точностью | 
| ‹ соответствия заданным тре- | 
| бованиям. | 
И ЫЪмюшттт ОЪ——ты—Ыы = —_р ыы >——ыЫы5дющыЪы>_——— 
| В? ВУТЕ ИРИсВАпаРГаш! у 1арновАтаРашИу — __ПШаг. размещения символов. 
Г СЕ СНАВ НРасеМате ]р$2Еасе 'Имя шрифта. у 


| Е_ЕАСЕЗТИЕ] 
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Все поля соответствуют параметрам функции СгежеЕопф, так что их под- 
робное пояснение см. в описании функции СгежфеЕоп+. Примеры использова- 
ния функции СгежеРоп п@1гес{ вы найдете в разд. 1.14. 


СгезеНа&е  ВгизВ — создает дескриптор кисти со штриховкой 


Создает дескриптор нестандартной кисти с заданной штриховкой и цветом 
для контекста устройства 


Заголовочный файл итаа1.й 


Синтаксис 


#10с1а4е <и1паа1.8> 
ИТМСОТАРТ НВВОЗН  ИТМАРТ СгеафеНаесвВгазВ (ТМ 1пе Епбеу1е, 
ТМ СОГОВВЕЕ с1ттеЁЕ); 


Описание 

Функция Сгеаж&еНа&еВ ВгизВ создает дескриптор нестандартной кисти для 
контекста устройства (см. разд. 5.5.1) с заданной штриховкой и цветом. Пара- 
метр #15 {Уе определяет шаблон штриховки, а параметр с1гге?! указывает цвет 
штриховки. Для параметра #154Уе определены следующие значения: 


Н5 _ВРТАбОМАТ, Косая штриховка снизу вверх. 


р п 


Н$_СВО55 Крестообразна штриховка горизонтальная и вертикаль- 


Н5_ОТАССВО55 Крестообразная косая штриховка. 
Н5_ЕРТАСОМАГ |Косая штриховка сверху ВНИЗ. 


Н5_НОВРОМТАЕ Горизонтальная штриховка. 
|Н$_УЕВТТСАТ, | 


При успешном выполнении функция возвращает дескриптор кисти, кото- 
рый далее может быть передан контексту функцией З@есОЦес+. В случае 
ошибки возвращается МОТ... 

После того как кисть более не нужна, ее следует удалить функцией 
РеееОЩесе. | 


Следующие операторы создают дескриптор кисти, заполняющей поверх- 
ность диагональной красной штриховкой, и передают его контексту с дескрип- 
тором НО: 


НВВО$Н НВ = Сгеакенаеснвгизь (Н$ ВРТАСОМАТ, с1Веа); 
бе1есеоОБлес* (НО, НВ); 


Ре1етеоь]еск (НВ); 


См. также другие функции создания дескриптора кисти: де фоскКОБесф, 
СгтежеэоПпаВгизВ, СгежеВги В шгес&, СгежеРаНегипВгиз В. 


СгеазеМщех — создает мьютекс 569 


СгежеМщех — создает мьютекс 
Создает именованный или неименованный мьютекс 
Заголовочный файл итфазе.В 


Синтаксис 


ИТМВАЗЕАРТ НАМОТЕ УТМАРТ 
СгеафеМоафехА (ТМ ГРЗЕСОВТТУ АТТВАТВОТЕ$ 1рМибехАеег1иеез, 
ТМ ВОО Ь1п1&1а]1Омпег, Т1М№ ГРСЗТВ 1рМапе); 


ИТМВАЗЕАРТ НАМОЬЕ МТМАРТ 
Сгеа&еМикех\ (ТМ ГРЗЕСОВТТУ АТТВТВОТЕ$ 1рМабехАеЕг1риафез, 
ТМ ВОО Ю1п1%1а1Омпег, ТМ ГРСИЗТВ 1рМапе); 


#1ЕаеЕ ОМТСОРЕ 
#АеЁзпе Сгеафсемифех СгеафеМоакехи 


#$е1зе 

#АеЕ1пе СгеафеМисех СгеафеМакехА 

фепа1 Е 

Описание 

Мьютекс (шущцех оБ]есё) — это специальный синхронизирующий объект 


в межпроцессном взаимодействии, позволяющий определить, захвачен ли он 
каким-то другим потоком (см. описание работы с мьютексами в разд. 3.3). 
Функция СгеафеМщех создает такой объект с именем, заданным параметром 
]рМате, и возвращает дескриптор этого объекта. Дескриптор может использо- 
ваться в некоторых функциях АРТ Ут4домз (Уа|ЕРогМи р! еОес{$, 
УМацЕогМи!р1еОесё Ех, М5 У\УацЕогМи р еОес5) для организации 
ожидания в многопоточных приложениях. | | 

Параметр рМшехАИгЮще$ является указателем на структуру типа 
ЗЕСОВТТУ _АТТЕТВОТЕ$ или ТЗесагЦуА г Ьщез$ (см. в данной главе под- 
робное ее описание), определяющую, будет ли наследоваться возвращенный 
дескриптор дочерними процессами. Если |рМщехА г Ьше$ = МОТ, то деск- 
риптор не наследуется. 

Параметр БПиНа1Омпег указывает, будет ли созданный мьютекс захвачен 
потоком. При значении фгие — будет, при значении Ёа]5е — нет. 

Параметр 1рМаше определяет имя мьютекса. Если этот параметр равен 
МОТУТ,, то создается мьютекс без имени. Тогда доступ к нему можно получить 
только через возвращаемый дескриптор. Имя мьютекса не должно совпадать 
с именем уже существующего события, семафора и других объектов межпро- 
цессной синхронизации. Если совпадет, то при выполнении функции возник- 
нет ошибка. В этом случае функция проверки ошибок С@е Га$&Еггог вернет 
значение ЕВКВОВ_ ТМУАГТО_ НАМОГЕ. 

Несколько процессов могут вызывать мьютекс с одним и тем же именем. 
Тогда первый процесс действительно создает мьютекс, а последующие откры- 
вают дескриптор существующего мьютекса. Определить, существовал ли мью- 
текс до вызова СгеафеМщех можно, вызвав функцию Се Та$&Еггог. Если мью- 
текс уже существовал, то СгеафдеМщех вернет значение ЕВВКОВ_АГВЕА- 
РУ_ЕХТЗТЬ. См. в разд. 3.3 пример использования этого механизма для про- 
верки, работает ли уже на компьютере экземпляр приложений. 


570 Глава 8. Справочные данные по функциям и структурам АР! \ММтдо\и$ 


СгежеРаЙегпиВги$В — создает дескриптор кисти для контекста устройства 
Создает дескриптор кисти с заданным шаблоном для контекста устройства 
Заголовочный файл и1тёа1.А 


Синтаксис 


#1п0с1аае <м1паа1.1> 
ИТМСОТАРТ НВВКОЗН ИТМАРТ СгеасеРа®егпВгизВ (ТМ НВТТМАР ВЬпр); 


Описание 

Функция СгежеРаЦегипВги$В создает дескриптор кисти с заданным шаб- 
лоном для контекста устройства (см. разд. 5.5.1). Параметр ВБтр — дескрип- 
тор шабона. 

При успешном выполнении функция возвращает дескриптор кисти, кото- 
рый далее может быть передан контексту функцией эеесОес4. В случае 
ошибки возвращается МОТ... 

После того как кисть будет использована, ее можно удалить функцией 
ее еОЩес+. Это не повлияет на исходный шаблон, так что шаблон можно ИС- 
пользовать для создания нескольких кистей. | 


См. также другие функции создания дескриптора кисти: Се ЗфюоскОЩес+, 
_ СгееНа\феВВги$В, СгеафеВгиз тО1гес+, Сгежае5оаВгизВ. 


СгежеРеп, СгежеРепп@1гес& — функции создания нестандартного 
‚ пера контекста устройства 


Функции создания нестандартного пера контекста устройства 
Заголовочный файл штдаЕ.Й, илтаоиз.В 
Синтаксис 


#1пс1иае <и1лпаом$. 1 > 


ИТМСОТАРТ НРЕМ СгеафеРеп (ТМ 1пЕ ЕпРепзъуТе, 
ТМ 1пЕ питаЕр, ТМ СОГОВВЕЕ схСо1ог); 


ИТМСОТАРТ НРЕМ ИТМАРТ СгеаееРепТпа1гес® (ТМ СОМ5Т ЪОСРЕМ * р1арп); 


суре4еЕ зегасе ФадЪОСРЕМ 
{ 


ОТМТ 1орп5у1е; 
РОТМТ Торритаев; 
СОТОВВЕЕ 1орпСо1ог; 


} ГОСРЕМ, *РГОСРЕМ, МЕАБ *МРГОСРЕМ, РАБ *ГРГОСРЕМ; 


Описание 

Создать дескриптор нестандартного пера контекста устройства (см. разд. 5.5.1) 
можно функцией СгежеРеп. Функция возвращает дескриптор пера. Параметр 
гпРеп5 {Ее определяет стиль рисуемых линий и может принимать следующие 


значения: 


_ Шприховая линия 


| [28.1 _рот _| Пунктирная линия _ 
Р5 _РАЗНООТ | Штрихпунктирная линия 
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Линия ИЗ штрихов 1 И сдвоенных пУНЕТиров 


—) 


Р5_РАЗНРОТООТ 
Р5_МОГЕ Невидимое перо = 


—_—_ рр _ ТР 


Р5 _1ТМ5ТОЕЕВАМЕ _ ‘Сплошная линия.  Прир рисовании линий, ограниченных 
прямоугольником, линия при любой ширине пера распо- 
| лагается полностью внутри прямоугольной области. 
—— 


При рисовании линий, ограниченных ‘прямоугольником, линия при лю- 
бой ширине пера располагается полностью внутри прямоугольной области. 

Стили Р5_ОАЗН, Р5_РОТ, Р5_ОАЗНООТ и Р5_РАЗНООТРЬОТ не ис- 
пользуются при ширине пера превышающей 1. 

Параметры пУ\1Ч и сгСо]ог функции СгежеРеп определяют ширину 
и цвет линии. 

Например, оператор 


НРЕМ ВеаРеп = СгеафеРеп (Р5_5ОТЪТО, 2, с1Веа); 


создает дескриптор сплошного красного пера с шириной 2 пиксела. 

Функция СгезфеРепп1тгес{ создает дескриптор пера, описание которого 
дается структурой типа ГОСРЕМ. Поля этой структуры задают те же величи- 
ны, что и параметры функции СгежфеРеп. Поле 1орп5{У!е — аналог параметра 
{пРеп5{Уе, Поле 1орпСо]ог — аналог параметра сгСо]ог. Поле 1орп \/14® име- 
ет тип структуры РОТ\Т в которой поле х определяет ширину линии, а поле у 
не используется. Если 1орп \14В задано равным МОГ, то ширина линии 1 
пиксел. 


Чтобы использовать созданный дескриптор, его надо назначить для кон- 
текста данного устройства. Это осуществляется функцией Заес ОЦесф, в ко- 
торую передается дескриптор контекста и дескриптор пера. Например: 


Зе1есЕОБ]ес® (НО, ВеаРеп); 


где НБ — дескриптор контекста. 
| После того как необходимость в заданном пере отпала, оно должно быть 
удалено функцией ее еОЪес{. Например: 


Ре1есеоь]ес® (КедРеп); 


Примеры создания пера см. в разд. 5.5.1, 5.5.3, 1.6. 


СгежеРеппЧ1гес+ — функция создания нестандартного пера контекста 
устройства 


См. функцию СгезжеРеп. 


СгежеРо!угопВ п — формирует область в виде замкнутого многоуголь- 
ника 


См. функцию СгежеВес& Вот. 


СгежеРо1уРо]угопК п — формирует область из ряда замкнутых много- 
угольников 


См. функцию СгежеВес& Воп. 
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СгежеРгосез$; — порождает дочерний процесс 
Порождает дочерний процесс 
Объявление 


роо1 __ЁЕаз®са11 СгеафеРгосез$з 


' сопзе сраг * 1рАрр11са®*1опМаше, 
сраг * 1рСоштапаг1пте, 
_ЗЕСУОВТТУ АТТВТВОТЕ$ * 1рРгосеззАЕЕг1рисез, 
_ЗЕСОВТТУ АТТВТВОТЕЗ * 1рТЬгеадАЕЕЕ1Юиакез, 
Боо1 ЬТпрег1Напа1ез, 
ип$1апеа 1опа АмСгеа®1опЕ1ааз, 
%01Я * 1рЕпу1гоптепе, 
соп5Е сраг * 1рСаггеп®О1агес®оку, 
ЗТАКТОРТМЕО * 1р5еагеарТпЕо,. 
РВОСЕ$5 ТМЕОВМАТТОМ * 1рРгосеззТпЕогма®1оп 
); 

Описание 

Функция пришла на смену функциям УшЕхес и Гоа@Модше, которые 
теперь реализуются посредством вызова Сгеа&еРгосе5$. 

Функция СгезжеРгосез$ порождает новый дочерний процесс и его первый 
поток (нить). В рамках этого процесса выполняется указанный файл 
1рАррНсайоп Маше с командной строкой рСоттапаГлте. Впрочем, параметр 
1рАррИсайоп Маше может быть равен МОШ,, а имя выполняемого модуля 
в этом случае должно быть первым элементом командной строки, задаваемой 
параметром 1рСоттапаТГлте. Сам выполняемый модуль может быть любого 
вида: 32-разрядным приложением \У119о\$, приложением М$-0О$, 05/2 
и т.п. Однако если из приложения У ш@4о\5$ создается процесс М5-2ОВ, то па- 
раметр 1рАрр|сайоп Мате должен быть равен МОТЛ,, а имя файла и его ко- 
мандная строка включаются в 1рСоттапа Г те. Так что, как правило, чтобы 
не ошибиться, проще всегда задавать 1рАррИсаЯопМаше = МОТТ, и помещать 
всю информацию в 1|рСоттапа Г те. 

Если имя файла не содержит расширения, то предполагается расширение 
.ехе. Но если имя кончается символом точки или если файл задан вместе с пу- 
тем, то расширение .ехе к имени не добавляется. 

Если путь к файлу не задан, файл ищется в каталогах в следующей после- 
довательности: 


1. Каталог, из которого запускается приложение. 

2. Текущий каталог родительского процесса. 

3. Системный каталог У/1п49о\м$, возвращаемый функцией Се Зузет О 1гес- 
фогу. 

4. Каталог ЗУЗТЕМ в У\Ут4до\жз МТ. 

5. Каталог \/1140\$, возвращаемый функцией Се \ том П1гесфогу. 

6. Каталоги, перечисленные в переменной окружения РАТН. 


Параметры 1рРгосеззА г! ще$ и 1рТЬгеад4А_Йтще$ являются указате- 
лями на структуры типа ЗЕСОВТТУ АТТЕТВОТЕ$ (см. описание этой струк- 
туры в данной главе), определяющие соответственно для процесса и потока, 
будет ли наследоваться возвращенный функцией дескриптор дочерними про- 
цессами. Эти структуры задают также дескриптор защиты. Значения парамет- 
ров рРгосез 3 АНг фи е$ и 1рТЬгеад А г Ьще$ можно задать равными МОШ.. 
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Это будет означать, что дескриптор не наследуется и используется дескриптор 
защиты по умолчанию. | 
Параметр ЫпВегиНапез определяет наследование порождаемым про- 
цессом дескриптора родительского процесса. | 
Параметр 4мСгеаНопЕ1а5$ определяет флаги, задающие характеристики 
создаваемого процесса. Следующие флаги могут использоваться в любой ком- 
бинации, кроме оговоренных ниже запрещенных комбинаций: 


СВКЕАТЕ_РЕРГАОТ,Т_ Устанавливает, что порождаемый процесс не на- 
ЕВККОК_МОБЕ ‘следует режим обработки ошибок, установленный 
| в родительском процессе. Режим обработки оши- 
бок в порождаемом процессе устанавливается по 

умолчанию. См. во встроенных справках функ- 
цию Зе ЕггогМо4е, задающую режим обработки 
— ошибок. Если флаг не установлен, порождаемый 


‚ процесс наследует режим обработки ошибок. 


СКЕАТЕ_МЕ\М’_СОМЗОГЕ Порождаемый процесс создает новую консоль, не 
'наследуя ее от родительского процесса. Этот флаг 


не может использоваться совместно с флагом ОЕ- 


ТАСНЕР_РЕОСЕЗ5. 


Порождаемый процесс является корневым для 
новой группы процессов — всех процессов, кото- 
рые будут им порождаться. Идентификатор новой 
группы будет совпадать с идентификатором, воз- | 
вращаемым в параметр 1рРгосе$шогтайоп. По- 
‚нятие группы процессов используется функцией 
| 'бепегаеСоптзое СИЛЕ уе для разрешения по- 
‚сылки консольным процессам сигналов горячих 
клавиш Си|-С и Сн-Вгеак. 


"(СВЕАТЕ БЕРАКАТЕ | Флаг используется только в У/И1шо\мз МТ и толь- 
\О\/_УБМ | ко при запуске 16-разрядных приложений. Он 
означает, что процесс будет выполняться на отде- 
льной виртуальной машине РОБ (УШМ). 


СВЕАТЕ 5НАВЕО _ Флаг используется только в УМ ш4о\мз МТ и толь- 
МОМ УМ — | ко при запуске 16-разрядных приложений. Он | 
‘означает, что процесс будет выполняться на со- | 


вместно используемой виртуальной машине ОО. 

СВЕАТЕ 5ОЗРЕМОЕО Первый поток порождаемого процесса будет при- 
| 
| 


СВЕАТЕ МЕ 
РЕОСЕ55 СКООР 


й остановлен до вызова функции ВезитеТ,геа4. 
а 


СКЕАТЕ_ОМТСОПЕ _ ‘Определяет, что блок переменных окружения, на | 
| ЕМУТВОММЕМТ | который указывает параметр 1рЕпу1гоптепф, ис- | 
| ‚ пользует символы Ошсоде. Если флаг не установ- 

‘лен, то используются символы АМЫГ. 

РЕВОС_РВОСЕ$5 Указывает, что вызывающий (родительский) про- 

' цесс или поток является отладчиком, а порождае- 


‘мый процесс является отлаживаемым. Родитель- | 
| ‚ский процесс сможет использовать функцию Ма- 


| РогОеБихЕуепф, и система будет извещать его 


‚о всех событиях отладки, случающихся в порож- | 


В ‚ денном процессе. | 
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| РЕВОС_ОМГУ_ТНТ$ _ Вели этот флаг не установлен, а родительский 
РВОСЕ$5 процесс является отлаживаемым, порождаемый 

| `| процесс станет еще одним отлаживаемым для от- 
` ладчика, используемого для родительского про- 


| > 
цесса. В этом случае любые отладочные деиствия 


в родительском процессе запрещены. 
НИЕ — |Для консольных процессов порождаемый процесс | 
'РЕТАСНЕО _РВОСЕ$5$ Для консольных процессов порождаемый процесс 
не будет иметь доступа к консоли родительского | 
‘ процесса. Для создания новой консоли порождае- 
‚мый процесс должен будет вызвать функцию А1]- 
1осСоп5ое. Этот флаг не может использоваться 


_ |вместе с флагом СВЕАТЕ_МЕ\_СОМЗОТЕ. — | 


ООО ——————=— = 


Как видно из приведенного описания, в большинстве случаев можно не ус- 
танавливать ни один из перечисленных флагов. Тогда характеристики порож- 
денного процесса и его взаимодействие с родительским процессом будут уста- 
новлены по умолчанию. | 

Флаги, включаемые в параметр 4мСгеайопЕ1!а5$, задают также приоритет 
выполнения порожденного процесса. Приоритет задается одним из следую- 
щих флагов: 


НИ 

| ВЕАТЛТМЕ _ Высокий приоритет, превышающий приоритеты 

| РЕТОВТТУ _СТА$$ других процессов, включая приоритеты процес- 
сов операционной системы. Назначать подобный 

‘приоритет можно только в особых случаях, на- 

"пример, при необходимости немедленно реагиро- 

вать на какое-то аппаратное средство. Процесс 

| ‚с таким приоритетом может нарушить работу си- 


| Темы. — 


| ШСН_РЕТОЮТУ _СТГА$5$ Указывает на процесс как на критическую зада- 


чу, которая должна выполняться немедленно. 

| Подобный процесс может, например, прервать 
‚другие процессы, зависшие в бесконечном цикле, 
| ‘чтобы закрыть их. Для обычных процессов такой 
| приоритет использовать нежелательно. 


| 
ИНН 1... иван Иан 
АВОУЕ_МОВМАЕГ _ Приоритет, промежуточный между Веа! и №ог- 


 РЕТОВТГУ_СТАЗ5 та]. Введен, начиная с У тдо\з 2000. 


МОВКМАГ РЕВТОЕВТУ _ | Нормальный приоритет процесса. 
СГА$5 ПО ОИИИИ 


ВЕГО\У/_МОКМАТ _ Приоритет, промежуточный между Могта| и 1Ше. 
___ Введен, начиная с У/1пао\з 2000. 


‚ ОГЕ_РЕОЕВТТУ_СГА$$ Все потоки процесса выполняются только во вре- 
мя простоя системы. Примеры — хранители эк- 
‚рана и средства мониторинга, собирающие ин- 

| формацию о системе. Все наследники такого про- 
Е 


Приоритет, установленный для процесса, является базовым классом при- 
оритетов всех его потоков. Подробнее о приоритетах см. в разд. 3.8. 


} 
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Параметр !рЕпугоптепе определяет наследование дочерним процессом 
переменных окружения родительского процесса. Если этот параметр равен 
МОГГ, то порождаемый процесс наследует блок переменных окружения, ис- 
пользуемый в родительском процессе. Так что через переменные окружения 
можно передать в дочерний процесс какую-то дополнительную информацию 
(см. разд. 1.13). Но в параметре 1рЕпугоптеп можно задать указатель на 
другой блок, отличный от используемого родительским процессом. 

Параметр 1рСиггеп О1гесогу указывает на строку, определяющую теку- 
щий каталог и диск дочернего процесса. Это используется в приложениях-0бо- 
‚ лочках, выполняющих различные приложения с различными рабочими ката- 
логами. Если параметр равен МОТ, текущий каталог совпадает с родитель- 
ским. 

Параметр 1рефагрицо указывает на структуру типа Нагаи, Соот- 
ветствующего типу структуры ЗЭТАКТО М.УЕО (см. ее описание в данной гла- 
ве). Стркутура определяет свойства главного окна создаваемого процесса. Для 
процессов с графическим интерфейсом пользователя (@0]) эта информация от- 
носится к первому окну, создаваемому функцией Сгеже\М/1т94о\м и отображае- 
мому функцией ЭвВом \1т4о\у. Для консольных приложений эта информация 
относится к создаваемому консольному окну. Единственное поле этой структу- 
ры, которое обязательно должно быть заполнено, это поле сеБ — размер стрку- 
туры. Остальные поля можно не заполнять, что обеспечит вид окна по умолча- 
нию. 

Параметр фРгосез$[ш{огтайЙоп указывает на структуру ТРгосезшогта- 
оп, или тождественного ему типа структуры РВОСЕ$З_ ТМЕОКМАТТОМ АР! 
Ут 4о\з. Из этой структуры родительское приложение может получать ин- 
формацию о выполнении нового процесса. 

Структура объявлена следующим образом: 

суреаеЕ зегисе _РВОСЕ$5 ТМЕОВМАТТОМ {НАМОЬЕ ЮРгосезз$; 

НАМОГЕ ВНТЬгеад; 
РИОВКО АмРгосе$з$Та; 


| , РМОВР амТргеаата; 
} РВОСЕ$$ ТМРГОВМАТТОМ, *РРКОСЕ$$ ТМЕОВМАТТОМ, *ГРРКОСЕ$5_ ТМЕОВМАТТОМ; 


Поля структуры означают следующее: 


Возвращает дескриптор созданного процесса. Используется во 
всех функциях, осуществляющих операции с объектом процесса. 


В Ргосе$$ 


Ч 


ЬТЬгеа4 `Возвращает дескриптор первого потока созданного процесса. Ис- 
‘пользуется во всех функциях, осуществляющих операции с объ- 
`ектом потока. | 


4мРгосез$Т4 ‚Возвращает глобальный идентификатор 1 процесса. Значение до- 
‚ ступно с момента создания процесса и до момента его завершения. 


ЧуТЬгеа ТА | Возвращает глобальный идентификатор потока. 9 Значение до- 
_ | ступно. с момента создания потока и до момента его завершения. 


Если функция СгеафеРгосе$$ успешно выполнена, она возвращает ненуле- 
вое значение (фгие). Если произошла ошибка — возвращается 0 ({а15е). Тогда 
информацию об ошибке можно получить, вызвав функцию Се Га$Еггог. 

Порожденный процесс остается в памяти системы, пока не завершатся все 
его потоки и пока все его дескрипторы не закроются вызовом С1озеНапе. 
Если эти дескрипторы не нужны, лучше всего закрыть их сразу после инициа- 
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лизации процесса. Чтобы досрочно прекратить выполнение дочернего процес- 
са лучше всего использовать функцию Ех Ргосез$$. 

Функция СгежфеРгосе$$ возвращается, не ожидая окончания инициализа- 
ции порождаемого процесса. Если родительский процесс должен ждать окон- 
чания инициализации, чтобы взаимодействовать с порожденным, то ожида- 
ние его инициализации можно организовать с помощью функции УайЕогТ- 
ра Че. 

Примеры применения функции СгезжфеРгосе5$ вы найдете в разд. 3.7, 1.4 
и в некоторых других 


СгежеВес Всп — и другие функции создания регионов 
Создают различные типы регионов 
Заголовочный файл итд а1.1 


Синтаксис 


#1пс1аае<и1паа1.6> 

ИТМСОТАРТ НВСМ ИТМАРТ СгеафеВес®Вап (ТМ 1пе пЬеЕЕВеск, 
ТМ 116 пТорБесё, 
ТМ 10 пВзап%Весе, 
ТМ 106 пВоббошВес®); 


ИТМСОТАРТ НВСМ ИТМАРТ СгеакеВесеКапТпа1гес® (1М СОМЗТ ВЕСТ * 1ргс}); 


ИТМСОТАРТ НВСМ ИТМАРТ СгеафкеВоцпакесеВап (ТМ 116 пЪеЕфВесь, 
ТМ 10Е пТорВес%, 
ТМ 1106 пвзарЕБеск, 
ТМ 106 пВосбопВесё, 
ТМ 1пЕ пи1аерЕ111рее, 
ТМ 106 пНе196еЕ111рзе); 


ИТМСОТАРТ НВСМ ИТМАРТ СгеафеЕ111ре1сВап (ТМ 1пЕ пЬеЕ%Весе, 
[М 1пЕ пТорВес®е, 
‚ТМ 10106 пвзареБВесе, 
ТМ 106 пВосбомВесе); 


ИТМСОТАРТ НВСМ МТМАРТ СгеафеЕ111ре1сКапТпа1гесе ( 
ТМ СОМЗТ ВЕСТ * 1ргс); 


ИТМСОТАРТ НВСМ ИТМАРТ СгеакеРо1удопВап (ТМ СОМ$Т РОТМТ * 1рр\е, 
ТМ 10 сРо1пЕ$, 
ТМ 106 ЕпРо1уЕ111Моае); 


ИТМСОТАРТ НВСМ ИТМАРТ СгеакеРо1уРо1удопВап (ТМ СОМ$Т РОТМТ * 1ЬрЕ, 
ТМ СОМ5Т ТМТ * 1рРо1уСочпЕ$, 
ТМ 1пЕ пСочпе, 
ТМ 10Е ЕпРо1уЕ111Моае); 


ИТМСОТАРТ 1п6 ИМТМАРТ Сотю1пеВап (ТМ НВСМ Бгапрезе, ТМ НВСМ Вгапбгс1, 
ТМ НЕСМ Вгопбгса, 
ТМ 10е ЕпСотб1пеМмоае); 


Описание 

Имеется много функций формирования различных форм регионов 
(см. разд. 5.2.2.1). Все они возвращают дескриптор объекта сформированного 
региона. 

Функция СгежеВес Всп создает прямоугольную область. Ее параметры 
пре#Вес+, пТорВес, пВлКес& и пВоНотКВес{ определяют соответственно 
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координаты левой, верхней, правой и нижней стороны. Как и во всех осталь- 
ных функциях, система координат имеет началом левый верхний угол окна. 
Подчеркнем, что именно окна, а не его клиентской области. 

Функция СгежеВесВоп11гесё аналогична функции СгежевесВоп. 
Только она принимает всего один аргумент 1рге — указатель на прямоуголь- 
ную область типа ВЕСТ (ТВес®. 

Функция СгежевВоипЯВес Вет формирует прямоугольную область со 
скругленными углами. Первые четыре параметра совпадают с параметрами 
функции СгежеВес Втп и описывают ‘прямоугольник. Два последних пара- 
метра задают соответственно ширину и высоту эллипса, используемого для 
скругления углов. 

Функция СгежеЕШрИсВтп формирует область в виде эллипса. Ее пара- 
метры совпадают с параметрами функции Сгежекес& В тп и характеризуют 
описанный вокруг эллипса прямоугольник. 

Функция СгежеЕШрисВ оп п @гес{ аналогична функции СгежеЕШриеВ2т. 
Только она принимает всего один параметр — прямоугольную область типа 
ТВесё. 

Функция СгежеРо!]угопВ п формирует область в виде замкнутого много- 
угольника. Параметр !ррё — указатель на массив точек типа ТРощф, характе- 
ризующих углы многоугольника. Каждая точка повторяется только один раз. 
Функция сама замыкает многоугольник, соединяя первую и последнюю точ- 
ки. Параметр еРоп 5$ указывает число используемых точек массива. Так что 
в массиве может быть больше точек, чем используется для формирования мно- 
гоугольника. Параметр ЁпРо!уЕШМоде характеризует способ заполнения об- 
ласти внутри многоугольника. Он может принимать значения АЕТЕКМАТЕ 
или \УТМОТМС. При значении АГТЕВМАТЕ регион заполняет области между 
четными и нечетными сторонами многоугольника, а при значении \УПМОИМС 
заполняется вся внутренняя часть многоугольника. Различие этих двух режи- 
мов можно заметить только на достаточно сложных многоугольниках. См. со- 
ответствующий пример построения пятиконечной звезды в разд. 5.2.2.2. 

Функция СгежеРо|уРо]угопВ п формирует область, состоящую из ряда 
замкнутых многоугольников. Параметр !ррё — указатель на массив точек 
типа ТРотф, характеризующих углы многоугольников. В нем сначала разме- 
щаются точки первого многоугольника, потом второго и т.д. Параметр 
1рРо!уСоип {5 — указатель на массив целых чисел. В нем указывается число 
точек каждого многоугольника: первого, второго и т.д. Параметр пСоип& опре- 
деляет число многоугольников. А последний параметр #пРо!уЕШМоде харак- 
теризует способ заполнения области внутри многоугольника и может прини- 
мать значения АСТЕВМАТЕ или \ПУРИМ\МС так же, как в функции СгежеРо- 


]угопВ5п. 


Функция СотбБшеВоп позволяет комбинировать различным образом два 
региона. Параметр ВгпОез& — дескриптор результирующего региона, пара- 
метры Вгеп8гс1 и Вгепге2- дескрипторы первого и второго комбинируемого 
регионов. Параметр ЁиСотБтеМоде определяет способ комбинирования и мо- 
жет принимать следующие значения: 


г ЕЕ: ЗЕ ПЕ = ТТ” ЕЕ ЕЕ ЕЕ г ЕШ ВеЕ ПЕЕЕ 


вом. АМ Создать пересечение двух ‹ областей. | | 


У ао В инь оао А ИИ 


| ВСМ_СОРУ Создать копию первой комбинируемой области (вторая область | 


Ш не учитывается). 


ПИ 


578 Глава 8. Справочные данные по функциям и структурам АР! \М/т4о\/$ 


ВОСМ_ ЕЕ. Создать область, с состоящую из части первой ‚ комбинируемой об- 
ласти, не входящей во вторую. 


ВСМ_ОВ Создать объединение двух. областей. 


КОСМ _ Хок Создать объединение двух областей и исключить из него пересе- 
чение этих областей. 


См. примеры применения рассмотренных функций в разд. 5.2.2.2, 5.2.2.3, 
1.7, 5.3.1.2, 5.3.1.3. 


СгежеВес В оп ш1гес& — создание прямоугольной области. 
См. функцию СгежеВес+ Вот. 


СгежеВоипЯКес В п — формирует прямоугольную область со скруг- 
ленными углами 


См. функцию СгеаеВес{ Вот. 


СгежеЗетарвоге — создает семафор 
Функция создает семафор 
Заголовочный файл итЬазе.й 


Синтаксис 


НАМОТЕ Сгеафебемарвоге (ТМ .РЗЕСОВТТУ АТТВТВОТЕ$ 1р5емарпогеде Е г1рисез, 
ТМ ГОМС 110161а1СошпЕ, ТМ ТОМС 1МахлтамСочпЕ, 
ТМ ГРСЗТВ 1рМапе); 


Описание 

Семафор (зетарвоге) — объект синхронизации, который может регулиро- 
вать доступ к некоторому ресурсу (см. разд. 3.4). Функция СгеабезЗетарюоге 
создает объект семафора. 

Параметр рЭетарвогеА в гие является указателем на структуру 
ЗЕСОВТТУ АТТЕТВОТЕЗ или ТжесогцуАИгщез$ (см. в данной главе под- 
робное ее описание), определяющую характер наследования и защиты. Значе- 
ние параметра 1рЕуе { А_г,ше$ можно задать равным МОГ. Это будет озна- 
чать, что дескриптор не наследуется, и что будет использоваться дескриптор 
защиты процесса, заданный по умолчанию. 

Параметр 1Махипат(Соцп{ задает максимальное число счетчика. Это чис- 
ло должно быть больше нуля. Параметр ИиИа!Соций указывает начальное 
значение счетчика. Это число может быть больше или равно нулю и не может 
превышать значение 1Махипит(Соипф. 

Параметр Мате определяет имя объекта. Если имя соответствует уже 
существующему объекту, то параметры ШиЯа1Сойи{ и Шийа1Соипф игнори- 
руются, так как они уже установлены для семафора. Если при этом параметр 
]р5етарвогеА вг1Ьще$ не равен МОТ, то он задает только наличие или от- 
сутствие наследования, а дескриптор защиты игнорируется. Параметр 1рМате 
может равняться МОГТ, — тогда создается семафор без имени. Такой семафор 
можно использовать в рамках одного процесса. Но его невозможно контроли- 
ровать в` другом процессе. Имя семафора не должно совпадать с именем син- 
хронизирующего объекта другого типа: мьютекса, события, таймера и т.д. 


Сгеазе$ойЧВги$И — создает дескриптор сплошной кисти 579 


В случае успешного выполнения функция Сгежезетарвоге возвращает 
дескриптор семафора. Этот дескриптор может использоваться в любых функ- 
циях ожидания. Функции будут возвращаться немедленно, пока семафор на- 
ходится в сигнальном состоянии, т.е. пока число счетчика не равно 0. 

Если семафор, указанный в функции СгежеЭетарвоге, уже существует, 
то функция вернет его дескриптор. Узнать после вызова СгеафеЗетарвоге, су- 
ществовал ли раньше указанный семафор, можно оператором: 


1Е (Сее`азеЕггог () == ЕВВОВ_ АТВЕАРУ ЕХТЗТ5) 


Примеры использования семафоров см. в разд. 3.4. 


СгежеэонНаВги$В — создает дескриптор сплошной кисти 


Создает дескриптор сплошной кисти заданного цвета для контекста уст- 
ройства 


Заголовочный файл и11541.й 


Синтаксис 


#10с1о4е <м1паа1.8> 
ИТМСОТАРТ НВКОЗН ИТМАРТ Сгеа®&ебо11аВгазй (ТМ СОГОВВЕЕ сгСо1ог); 


Описание 

Функция СгеафеоПаВги$В создает дескриптор сплошной кисти заданно- 
го цвета для контекста устройства (см. разд. 5.5.1) с заданным цветом 
сгСо]ог. 

При успешном выполнении функция возвращает дескриптор кисти, кото- 
рый далее может быть передан контексту функцией З@аесО ес. В случае 
ошибки возвращается МОТГ.. 

Следующий оператор создает дескриптор сплошной красной кисти и пере- 
дает его контексту с дескриптором НО: 


бе1есеоОБ]есе (НО, Сгеафебо11аАВгазВ (с1Веа))}; 


См. также другие функции создания дескриптора кисти: де фюоеКОЩес%, 
СтежеНа{еВВги$В, СгеафеВгиз В Ш@1гес+, СгеафеРаЙегипВги$ В. 


СгеафеТЬгеа4 — создает поток 
Создает поток 


Синтаксис 


НАМОТЕ СгеафеТьгеаа (ТМ ГРЗЕСОВТТУ АТТВАТВУОТЕ$ 1рТЬгеадАЕ&г1риеез, 
ТМ $12Е_Т амзеасКк$12е, 
ТМ ТРТНВЕАР ЭТАКТ ВОЧТТМЕ 1р56аг®Аадагез$$, 
ТМ ГРУОТР ]1рРагамекек, 
ТМ РИОВОР ЧмСгеа&1опЕ1адз, 
ОПТ .РРИОВР 1рТргеаата); 


Описание 

При успешном выполнении функция создает новый поток (см. разд. 3.8), 
возвращает его дескриптор, а в переменную, на которую указывает параметр 
1рТЬгеа 14, заносит идентификатор потока. Начиная с У/1тдо\з 2000 в каче- 
стве значения 1рТогеа ТА можно задавать МО1Т,, если идентификатор потока 
вас не интересует. Но в У/114о\з$ 98 параметр 1рТЬгеа ТА должен указывать на 
некоторую переменную, даже если ее значение вам не нужно. 

Выполнение потока начинается с выполнения функции, адрес (имя) кото- 
рой указывает параметр 1р$агё А4@4гез$$. Это любая написанная вами функ- 
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ция, в которую передается один аргумент, являющийся указателем на любую 
величину, и которая возвращает 32-разрядное значение: 


ОМОВО МТМАРТ имя функции (ТРУОТО); 


Параметр 1рРагатеег задает значение аргумента, передаваемого в функ- 
цию, на которую указывает 1р$фагё А9@ге55. Если в функцию не требуется ни- 
чего передавать, можно задать 1рРагатефег = МОТ... | 

Остальные параметры функции СгежфеТЬгеа4 можно во многих задавать 
нулевыми. Параметр рТЬгеа4АИгще$ является указателем на структуру 
типа ЗЕСОВТТУ_АТТЕВОТЕ$ или ТЗесогцуА г ще$ (см. в данной главе 
подробное ее описание), определяющую для потока, будет ли наследоваться 
возвращенный функцией дескриптор дочерними процессами. Эта структура 
задает также дескриптор защиты. Значение параметра ШфТЬгеадаАНгЬ ще$ 
можно задать равным МОГ. Это будет означать, что дескриптор потока не на- 
следуется и используется дескриптор защиты по умолчанию. 

Параметр 4м$фасК$12е указывает размер в байтах стека, который будет 
использоваться в новом потоке. Если в качестве значения ам ЭфасК$12е за- 
дан 0, то размер стека будет таким же, как в первом потоке данного процесса. 
Стек расположится в памяти процесса и освободит ее, когда завершится. Впро- 
чем, если потребуется, то размер стека автоматически увеличится. Так что 
в большинстве случаев вас вполне устроит значение параметра 4м{фасЁЕ$1ге, 
равное 0. Если же вы задаете отличный от нуля размер, надо быть уверенным, 
что он не превысит размер доступной памяти. Иначе функция Сгез4еТЬгеа4 
завершится с ошибкой. 

Параметр АмСгеаИЙопЕ 1а5$ предназначен для флагов, которые определяют 
условия создания потоков. Но пока определено только одно значение флага — 
СВЕАТЕ_ 5ОЗРЕМОЕО. Если этот флаг не задан, то поток начинает выпол- 
няться немедленно после создания. А если задан флаг СКЕАТЕ_ ЗОЗРЕМОЕЮ, 
то поток создается в остановленном, «замороженном» состоянии. Это можно 
использовать для настройки каких-то характеристик потока. Он начнет вы- 
полняться только после того, как к нему будет применена описанная далее 
функция КезитеТЬгеа4. 

Примеры работы с потоками см. в разд. 3.8. 


Сгеже\УаЦаШеТипег — создает таймер 
Создает таймер 


Синтаксис 


НАМОТЕ Сгеафема1$ар1еТамег ( | 
ТМ ГРЗЕСОВТТУ АТТВТВОТЕ$ 1рТ1текгАЕ®г1риеез, 
ТМ ВООЪ ЮМапоа]1Везее, ТМ ТРСЗТК 1рТ1пегМаце); 


Описание 

При успешном выполнении функция создает новый таймер ожидания 
(ла{аЪШе Ятег) — объект синхронизации, переходящий в сигнальное состоя- 
ние в указанное время, или регулярно с заданным периодом (см. разд. 3.6). 

Параметр рТипегА г ще является указателем на структуру типа 
ЗЕСОВГГУ _АТТЕТВОТЕ$ или ТЗесогНуАЙгЬие$ (см. в данной главе под- 
робное ее описание), определяющую, будет ли наследоваться возвращенный 
дескриптор дочерними процессами. Значение параметра 1рТипегАЙг!Ь ще 
можно задать равным МОТ. Это будет означать, что дескриптор не наследует- 
ся, и что будет использоваться дескриптор защиты процесса, заданный по 
умолчанию. 


Се{Сиг$огРо$, 5е{СигогРо$ — работа с координатами курсора мыши 581 


Параметр 6ВМапиа!Везе{ определяет тип события: фгие — с ручным управ- 
лением, Ёа!5е — с автоматическим. Параметр рТипег Маше определяет имя 
таймера. Если имя соответствует уже существующему объекту, то параметр 
ЪМапиа1Везе{ игнорируется, так как он уже установлен для таймера. Если 
при этом параметр 1рТипегАИ г щез$ не равен МОГ, то он Задает только на- 
личие или отсутствие наследования, а дескриптор защиты игнорируется. Па- 
раметр 1рТипегМате задает имя таймера и может равняться МОТТ — тогда 
создается таймер без имени. Такой таймер можно использовать в рамках одно- 
го процесса. Но его невозможно вызывать в другом процессе. Имя таймера не 
должно совпадать с именем синхронизирующего объекта другого типа: мью- 
текса, семафора, события ит.д. 

В. случае успешного выполнения функция Сгеаже\УаЦаШеТипег возвра- 
щает дескриптор таймера. Этот дескриптор может использоваться в любых 
функциях ожидания. Функции будут ожидать, пока событие не перейдет 
в сигнальное состояние. Обратите внимание на то, что таймер, создаваемый 
функцией Сгеже\УаЦаШеТ!итег, первоначально всегда находится в несиг- 
нальном состоянии. | 

Если таймер, указанный в функции Сгеже\УаЦаШеТитег, уже существу- 
ет, то функция вернет его дескриптор. Узнать после вызова Сгеже\УаЦваБ- 
1еТ1тег, существовал ли раньше указанный таймер, можно оператором: 


1Е (СесЪаз®Еггог() == ЕВВОВ АЪВЕАРУ ЕХТЗТ5) 
Примеры использования таймеров ожидания см. в разд. 3.6. 


Се{СигзогРоз$, Зе СигзогРо$ — работа с координатами курсора мыши 
Получение и установка экранных координат курсора мыши. 
Заголовочный файл шпизег.й 


Синтаксис 
ВООГ СееСагзогРоз (О0Т БРРОТМТ 1рРо1п+); 


ВООТ Зе СитзогРо$ (1М 1пЕ Х, ТМ 10 У); 


Описание 

Получить экранные координаты курсора мыши можно функцией 
Се Соиг5огРо5. Функция заносит в структуру Рот значения координат. 

Например, операторы 

ТРо1пе А; 

сееСохзогРо$ (&А); 
позволяют найти экранные координаты курсора как значения полей Р.Х — 
координата Х, Р.Х — координата У. Методы ЭсгеепТоСПеп&, присущие всем 
оконным компонентам, позволяют пересчитать экранные координаты в систе- 
му координат клиентской области компонента. 


Задать экранные координаты курсора мыши можно функцией ЗеёСиг- 
5огРо5. Параметры Х и У — соответствующие координаты курсора. Например, 
оператор 


бееСигзогРо$ (0, 0); 


переместит курсор в верхний левый угол экрана. 
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ОажеТипеТозу ет те и ЗуетТииеТтТора{еТипе — преобразуют фор- 
маты отображения дат и времени 


Переводят друг в друга отображения дат и времени, заданные типами 
ТбузетТ!1те и Т)афеТипе 


Заголовочный файл 5у30115.йрр 


Синтаксие 
бЗузЕем: :ТРабеТ1ме __Еаз®са]11 ЗузкешТ1меТора®еТ1ме ( 

соп5Е _СУЗТЕМТТМЕ &бузфемТ1ие); 
Уу01А _ ЕазЕса11 РафеТ1меТобузеемТ1те ( 


сопзе бузеем: :ТРабеТ1ме РаееТ1те, _ЗУЗТЕМТТМЕ &бузеепТ1ме); 


Описание 

Функция ЗузетТипеТоа{еТите переводит дату и время, заданные типом 
ТБбузетТите (см. ее описание в данной главе) в значение типа 'ТОаеТ!те. Функ- 
ция Ю{еТипеТоЗуетТипе осуществляет обратное преобразование. Структуры 
типа ТЗузетТипе широко используются в АРТ У/114о\з для представления дат 
и времени. Применение функции ЗуешТипеТора{еТипе — наиболее простой 
путь преобразования этих структур в форму, с которой легко осуществлять раз- 
личные арифметические операции, например, вычислять разности — интервалы 
времени. А функция ВаёеТипеТоЗуетТипе используется для представления 
данных типа Т)аёеТ!те в формате, понятном функциям АРТ УЛш94о\з. 

См. примеры применения этих функций в разд. 1.15, 3.7, 3.10. 


ДеееАфот — удаляет из локальной таблицы атом 
См. функцию АдаАющ. 


ПеееЕ!е и другие функции работы с файлами 


`Удаляют, переименовывают файл, проверяют наличие файла 
Заголовочные файлы бузИН[5.Йрр, отало.й, То.А. 


Синтаксис 


Боо1 ПРе1ефеЕ11е (сопзЕ бузфем: :Апз15Ег1па Е11еМаме) 


роо1 __Еаз®кса]11 КепамеЕг11е (сопз® Ап$15&г1па О1амапе, 
сопзЕ Ап$15Ег1па МемМапе); 


ехфегп РАСКАСЕ Роо1 __ЁЕаз®са11 Е11еЕх15($ ( 
соп$Е Ап515Ег1па Е11еМапе); 


106 гемоуе (сопзЕ сраг *Е11]епапе) // Заголовочный файл 5Еа1о.В 
11 _00111К (сопзЕ сВаг *Ё11епапе) // Заголовочный файл ТО.В 
Описание 


Рассмотренные ниже способы работы с файлами универсальны в ТОМ 
смысле, что могут использоваться в приложениях любых версий У/ш9до%\з, 
в консольных приложениях, и даже в приложениях, созданных различными 
системами, использующими С++. Примеры их использования см. в разд. 6.8. 
Но по эффективности и сервису они несопоставимы с возможностями функции 
эвЕПеОрега оп. 

Удаление файла с диска осуществляется функцией еаваеЕЦе. Функция 
удаляет файл с именем ЕПеМате. Если удалить файл невозможно или указан- 
ного файла нет, функция возвращает #а|е. 


Ое!езеМепи — удаление указанного раздела меню 583 


Сочетание функции ОеееЕПе с функциями поиска файлов Ет@аЕ!г$$, 
Е1паМ№ хф, Е1паС]о$е легко позволяет организовать удаление из заданного ка- 
талога всех файлов, удовлетворяющих некоторому шаблону (см. пример 
в разд. 6.8). 

Еще один вариант удаления файла возможен с помощью функции гетоуе. 
Ее использование и результат аналогичен функции еаееЕ Ее. Возвращаемые 
значения 0 или —1 (при ошибке). Например, ее вызов 


гемоуе ("с:\\$пр\\&тр.*&птр"); 


удалит из папки ТМР файл #птрётр. 


Удаление файла можно также провести с помощью функции _апйикК. 

Функции гетоуе и _ипПиК возвращают 0 в случае успешного завершения. 
При ошибке возвращается —1. Тогда причину ошибки можно узнать по значе- 
нию переменной еггпо: ЕАССЕЗ — не разрешен доступ к файлу для соверше- 
ния операции удаления, ЕМОЕМТ — файл с указанным путем и именем не 
найден. 

Удаление файлов рассмотренными функциями приводит к их полному 
удалению, а не к перемещению в корзину, из которой их потом можно восста- 
новить. Удаления файлов с переносом их в корзину обеспечивает функция 
эпЕПеОрега{1оп. 

Копирование файлов средствами функций С/С++ может сводиться к соз- 
данию файла-приемника, после чего содержимое файла-источника читается 
по частям или целиком в некоторый буфер и записывается в файл-приемник. 
Если файл-приемник уже существует, можно создать его копию с расширени- 
ем .баЁЕ. Это осуществляется функцией переименования файла ВепатеЕ Пе. 
Параметры 014Мате и М№еМате — прежнее и новое имена файла. Если пере- 
именование невозможно, функция возвращает #а]5е. В частности, это происхо- 
дит, если файл с именем МемМащте уже существует. 

Проверку существования файла-приемника можно сделать функцией 
ЕПеЕх!1${5. Функция возвращает фгие, если файл ЕИеМате существует. 


ПеееМепи — удаление указанного раздела меню 
Удаляет указанный раздел меню 
Заголовочный файл ипизег.й 


Синтаксис 


ИТМОЗЕКАРТ ВООТ МТМАРГ ПШе]1есеМепа (ТМ НМЕМО ВМепц, 
ТМ ОТМТ оаРоз1Етоп, 
ТМ ОТМТ оЕТааз); 


Описание 

Функция ВеееМепи удаляет указанный раздел и освобождает занятую 
им память. Если указан раздел полосы меню или головной раздел выпадающе- 
го меню, то удаляются и все разделы выпадающего меню. 

Параметр ВМепи является дескриптором меню. Параметр иРо$11оп ука- 
зывает раздел меню. А параметр а 1ай5$ определяет, как именно идентифици- 
руется раздел параметром иРоз110оп. Возможные значения параметра иЕ]а5$: 
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 катор команды раздела. При этом возможна неоднознач- | 
ность, если в меню присутствует несколько разделов 

с одинаковыми идентификаторами. Флаг МЕ_ВУСОМ- 
МАМО подразумевается по умолчанию, если не задан 
| флаг МЕ_ВУРОЗТТТОМ. 


| ОНИ ОС НИИ _ _ ИНН 


—+ 
‚МЕ _ВУРОЗТТТОМ Указывает, что параметр иРо1Иоп определяет индекс раз- 
дела (индекс первого раздела 0). Если дескриптор ВМепи 


| 
указывает полосу меню, то индексы относятся к заголов- 


—_ | кам меню. __ 


———— р —— 


Функция возвращает ненулевое значение при успешном выполнении и 0 
в случае ошибки. В этом случае подробную информацию об ошибке можно по- 
лучить с помощью функции Че Газ Еггог. 

Примеры применения функции ВааеМепи вы найдете в разд. 2.4.2 и 5.2.1. 


Рее{еОЪзес& — удаляет созданный объект 
См. функцию СгежеРопф. 


Лез{гоу\ том — разрушает и удаляет из памяти окно 
Удаляет из памяти указанное окно 
Заголовочный файл штизег.й 


Синтаксис 


#1п0с1аае <м1пазегк.Н> 
ВОО И"ТМАРТ Ре гоуй1паом (ТМ НИМО В\та); 


Описание 

Функция Оезёгоу\У шдо\ разрушает и удаляет из памяти окно, указанное 
его дескриптором В\Упа. При этом в окно посылаются сообщения \М_БЕЗ- 
ТКОУ и \М_МСОЕЗТВОУХ, делающие окно неактивным и перемещающие из 
него фокус. Удаляются из памяти также все связанные с окном объекты: меню, 
таймеры и т.п., а также дочерние окна и окна, которыми владело удаляемое 
окно. Причем эти окна удаляются раньше, чем удаляется головное окно. 

При успешном выполнении функция возвращает ненулевое значение. При 
аварийном завершении возвращается нуль. Тогда развернутую информацию 
об ошибке можно получить вызовом функции Че Та$Еггог. 


Оеу1сеГоСопи:`о| — посылает команду драйверу устройства 
Посылает команду драйверу устройства (дисковода) 
Заголовочные файлы ирлпбазе.й, шртосН.И 


Синтаксис 


#10с1иае <и1пБазе.в> 
#1пс10ае <и1п10се1.6> 
ВООТ МТМАРТ Пеу1сеТоСопего1 (ТМ НАМОЪЕ Бреу1се, 
ТМ РБМИОКР АмТоСопЕго1Соае, 
ТМ БРУОТО 1рТпВоаЕЕек, 
ТМ ОМОВО пТрВаЕЕеуб12е, 
ОПТ ТРУОТР 1рОйЕВоЕЕег, 
ТМ ОМОВЬ пОчЕВаЕЕегб12е, 
ОПТ ЬРОМОВР 1рВукезВееаогпеа, 
ТМ ГРОУЕВЬЪАРРЕО 1рОуег1арреа); 
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Описание — 

Функция ОБез1сеГоСоп{го| напрямую посылает драйверу устройства (дис- 
ковода) команду, позволяющую управлять этим устройством или получить 
о нем информацию. Это многоцелевая функция управления вводом-выводом 
([ОСТГ,). Фактически, Оех1сеГоСопфго! представляет собой множество функ- 
ций, вид которых задается параметром дмТоСошгоСо4е. В зависимости от 
этого параметра изменяется смысл и большинства остальных параметров 
функции. Возможные значения параметра описаны в модуле шицосН.й, кото- 
‘рые надо подключать при работе с ВемсеГоСопфго1. 

Параметр В,еу1се определяет дескриптор устройства. Этот дескриптор 
возвращается функцией СгезжеЕ Це, которая должна быть предварительно вы- 
звана. При этом должны быть выполнены следующие требования: 


1. Пользователь должен иметь права администратора. 


2. Чтобы открыть физический жесткий диск с номером х, путь к файлу — 
аргумент 1рЕЦеМаше в вызове СгежеЕЦе должен иметь форму «\\.\РНУ- 
Э1САГОНУЕх». Номера жесткого диска начинаются с нуля. Например: 
«\\.\РНУЗМСАГОВТУЕО" — это первый физический диск компьютера по- 
льзователя. 


3. Чтобы открыть накопитель на гибких дисках или открыть один из логиче- 
ских дисков, на которые разбит физический диск, путь к файлу — аргу- 
мент 1рЕПеМаше в вызове Сгезэ{еЕПе должен иметь форму «\\.\х:», где 
х — буква диска (регистр буквы не имеет значения). Например: 
«\\.\А:» — диск А, «\\.\4:» — диск О. 


4.. Аргумент дмСгеаИоп 15 `Юийоп в вызове СгеафеЕПе должен иметь флаг 
ОРЕМ_ЕХТЗТЕХС. | | 


5. При открытии гибкого или жесткого диска вы должны в аргументе 4\5Ва- 
геМоде в вызове СгезёеЕе установить флаг ЕЦП.Е_ ЗНАВЕ МЩГТЕ. 


Таким образом, открытие устройства может осуществляться, например, 
таким оператором: | 

НАМОТЕ РБеу1се=СгеакеЕ11е (Е4161->Техе.с_56г(), 

| СЕМЕВТС ВЕАР | СЕМЕВТС МВТТЕ, 
’ЕТЬЕ ЗНАВЕ КЕАР | ЕТЬЕ ЗНАВЕ МВТТЕ, МОБ, 
ОРЕМ_ ЕХТЗТТМС, 0, №11); 
1Е (ПБеу1се == ТМУАБТРЬ НАМОЬЕ УАГОЕ) 
бПомМеззаае ("Невозможно открыть диск.\пОшибка: \п'!" + 

сузЕггогМе$ $ аде (СееазЕЕгког ()) + ""'!"); 


В этом коде подразумевается, что устройство задано пользователем в окне 
редактирования Еа 1 в формате, соответствующем приведенным выше требо- 
ваниям. Например, в окне может быть написано «\\.\Рвуз1саШОчуе0”, если 
надо получить доступ к первому физическому жесткому диску. А может быть 
написано «\\.\а:» или «\\.\4:», если надо получить доступ к гибкому диску А 
или к логическому диску О. Этот диск О не обязательно должен относиться 
к жесткому диску. Это может быть, например, устройство СО-ВОМ. 

Если вы хотите записать имя диска непосредственно в вызове функции 
СгежеЕШ!е, не забудьте о необходимости сдваивать символы слэша. Например, 
так: 

НАМОТЕ Бреу1се=СгеафеЕ11е ("\\\\.\\РВуз1са1Ог1уе0", 

СЕМЕВТС ВЕАШР | СЕМЕВТС МВТТЕ, 


ЕТТЕ ЗНАВЕ ВЕАШР | РТЬЕ ЗНАВЕ МВТТЕ, МОТ, 
_ ОРЕМ ЕХТЗТТМС, 0, МОЪЬ); 
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После того как нужные операции с диском, вызываемые функцией 
Деу1сеГоСош го], завершены, дескриптор следует закрыть функцией 
СозеНап е: 


С1озеНапа1е (преу1се); 


Параметр дмТоСошго!Со4е функции Оеу1сеГоСопфго| указывает код ко- 
манды, которая посылается устройству. Возможных кодов очень много. Ниже 
перечислены только некоторые из них: 


Значение 


ЕЗСТГ_О1ЗМОЧМТ_УОГОМЕ 


ЕЗСТТ, СЕТ_СОМРКЕ$$1ОМ 


ЕУСТЬ_ГОСК_УОГОМЕ 


ЕСТЬ _ЗЕТ СОМРВЕЗЗОМ Задать информацию о сжатии файла 
или каталога. 


ЕСТЬ ОМГОСК_УОГОМЕ Разблокировать диск. 


ТОСТГ_ Р1$К_СЕТ ОВТУЕ_СЕОМЕТВУ | Получить информацию о физических 
параметрах конфигурации диска. 


ТОСТЕ_01$К_СЕТ_ГЕМСТН 1МЕО 


ТОСТ 01$К_РЕКЕОКМАМСЕ Получить информацию о производите- 
льности дисковода. 


ТОСТЬ ЭТОКАСЕ_ СНЕСК_УЕВТЕУ Проверить готовность устройства к ра- 
| боте. 


ТОСТТ, ЗТОВАСЕ_ЕТЕСТ_МЕШОТА 


ТОСТЕ_5ТОВАСЕ_ТОАР_МЕОТА 


Описание команды 


Демонтировать диск. 


Получить информацию о сжатии фай- 
ла или каталога. 


Заблокировать диск. 


Получить размер диска в байтах. 


Извлечь носитель из устройства (от- 
крыть СО_ВОМ). 


Загрузить носитель в устройство (за- 
крыть СО ВОМ). | 


ТОСТГ_ 5ТОВКАСЕ_МЕОШТА_ВЕМОТХАТ |Блокировать или разблокировать воз- 
можность извлечения носителя из 
устройства. 


Остальные параметры функции ОехсеГоСопфго] зависят от значения 
4\ТоСопего!Со4е. Параметры 1ршВиЁег и пшВиЁег$12е определяют указа- 
тель на входной буфер и размер этого буфера. Вид буфера зависит от выпол- 
няемой командой. Для многих команд, не использующих входной буфер, надо 
задавать 1|ршВи@ег = МОТ, и ппВойЁЙег$12е = 0. Параметры 1рОшВиЁег 
и пПОшВоЁег$12е определяют указатель на выходной буфер и размер этого бу- 
фера. Вид этого буфера также зависит от выполняемой командой. Для многих 
команд, не использующих выходной буфер, надо задавать 1рОи&ВиЁЙег = 
МОМ, и пОшВойЁег$12е = 0. Единственный параметр, кроме ВО,езмсе 
и Ч\ТоСошго!Со4е, который практически всегда надо задавать, это параметр 
1рВуеВефигпе4 — указатель на переменную типа О\ОВО. Во многих коман- 
дах в эту переменную заносится число передаваемых байтов. Значение 
]рВуёезВеигпе4 не может быть равно МОТ при синхронном выполнении 
функции Без1сеГоСопфго1. А при асинхронном выполнении, которое рассмот- 
рено ниже, можно задавать 1рВуеВефигпед = МОТ... В этом случае число пе- 
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реданных байтов можно определять функцией Се ОуеарредВези{ или 
функцией Се Оиеиед4Сотр]е оп {фафи$, если устройство — порт. 

Параметр 1рОуег1арре может быть задан равным МОГ. В этом случае 
функция Вем1сеТоСопф го] выполняется синхронно, т.е. не возвращается, пока 
операция не завершена. Если же в качестве значения параметра 1рОуеарре@ 
задать указатель на структуру типа ОУЕВГАРРЕР (см. ее описание в данной 
главе), то заданная операция выполняется асинхронно. Но для этого устройст- 
во должно быть открыто функцией СгезжеЕПе ‘с флагом ЕП.Е_ЕГАС_ОУЕБ- 
ГАРРЕО. 

В асинхронном режиме структура ОУЕВЕАРРЕЮ, на которую указывает 
параметр 1рОуе!1арре4, должна содержать указатель на вручную устанавли- 
ваемый синхронизирующий объект события (см. разд. 3.5), создаваемый 
функцией СгеэфеЕуеп%. 

Если операция, заданная функцией ОБечм1сеГоСопфго|, не может быть вы- 
полнена немедленно, функция ОемееТоСопётго! вернет #а]15е, а последующий 
вызов функции Се Га Еггог вернет значение ЕКВОВ _1ТО0_РЕМОГ\С. Это оз- 
начает, что операция будет выполняться в фоновом режиме. При этом синхро- 
низирующий объект еуепф, заданный структурой ОУЕВГАРРЕЮ, сбрасывает- 
ся в несигнальное состояние. 

Поток, вызвавший функцию ОБеу!1сеТоСопф го] с асинхронным исполнени- 
ем, может затем использовать любую из функций синхронизации, чтобы уз- 
нать о завершении операции. Когда операция завершится, объект еуепё перей- 
дет в сигнальное состояние. После этого функцией Се Оуег1арре4Я Вези мож- 
но получить информацию о результатах операции: завершилась ли она успеш- 
но, и сколько байтов занесено в буфер 1рОщВийЁег (если, конечно, выходной 
буфер использовался этой операцией). 


Рассмотрим теперь основные из перечисленных операций, задаваемых 
функцией ВемсеТоСопёго!. В приведенных далее операторах подразумевается, 
что дескриптор В,е\м!се создан приведенным ранее примером вызова функции 
СгезжеЕ!е, и объявлена переменная: 


РИОКР ВеЕогпеаВуеез$; 


Информация 0 размере диска — операция с кодом ТОСТЬ_ 01$К_СЕТ_ 
ГЕМСТН_ТМЕО 


Вызов функции Оеу1сеТоСопфго] в синхронном режиме для этой операции 
имеет вид: 
СЕТ ТЕМСТН ТМЕОВМАТТОМ СЬЕ; 


Реу1сетоСопего1 (пОеу1се, ТОСТТ РТ$К СЕТ ЪЕМСТН_ТМЕО, 
МОБЬ, 0, &СЬЕ, э1хеоЕ(СЬЕ), &КебогреаВу®ез, М1) 


Информация возвращается в структуру типа СЕТ ТЕМСТН_ТМЕОВМАТТЮМ, 
объявленную в модуле ипосИ.Й следующим образом: 
суреаеЕ зекисЕ СЕТ ЬЕМСТН ТМЕОВМАТТОМ { 


ТАВСЕ ТМТЕСЕВ  ТепаёБ; 
} СЕТ ТЕМСТН ТМЕОВМАТТОМ, *РСЕТ ТЕМСТН ТМЕОВМАТТОМ; 


Поле Геп&В этой структуры имеет тип ГАВСЕ_ ТМУТЕСЕВ (см. описание 
этого типа в разд. 1.15.1). 
При успешном выполнении функции возвращает положительное значение. 
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Функция Оеу1сеоСоп го! с кодом ТОСТЬ_ ОК _СЕТ ТЕМСТН_ТМ№МЕО 
применима к системным и логическим жестким дискам и к съемным дискам 
(например, к СО-КОМ), если в них загружен носитель. При использовании 
функции для гибких дисководов или дисководов, в которые не вставлен диск, 
возвращается О — ошибка. Вид ошибки можно узнать вызовом функции 
Се .а$Еггог. | | 

Ниже приведен пример определения размера диска: 


СЕТ _ЪЕМСТН_ТМЕОВМАТТОМ СЬЕ; 

1Е (Реу1сеТоСопЕго1 (пОеутсе, ТОСТЬ РТ5К_ СЕТ _ЪЕМСТН ТМЕО, 
МОЪЬ, 9, &СЬЕ, з12еоЕЁ (СЬЕ), &КебогпеаВусез, 
МОБ) ) 


ГОМСЬОМС Г = СЬЕ; БердаЕрР .ОцааРаг®; 
ЗЕглпа $ = ТаЕТобек (1); 
Еог (1пЕ 1=5.ЪераеВ ()-2; 1>1; 1-=3) 
5.1п5егё(! !',1); 
ЗЕглпа 51 = "!"; 
ТЕ (Ь > 1073741824) 
$1 = Е|Тоа ТобеуЕ (Г / 1073741824., ЕЕЕ1хеа, 10, 2) +" ГБИ; 
е]зе 1Е(Т > 1048576) 
$1 = Е1оа ТоЗекуЕ(Т / 1048576., ЕЕЕ1ахеа, 10, 2) +" МБ"; 
е1зе 1Е(Т > 1024) | 
$1 = ЕТтоа ТобЕкЕ(Т / 1024., ЕЕЕ1хеа, 10, 2) +" КБ"; 


Мепо1->Ъ1пез->АЯа ("Размер " + $1 +" (" + $ + " байт)"); 
} 
е1зе 
ЗПомМеззачае ("Определить размер не удалось. \пОшибка:\п'" + 
сузЕггогМе$заде (СееГазЕЕгког ()) + ""'"); 


В этом примере предполагается, что диск ВОеу1се открыт и объявлена опи- 
‚ санная ранее переменная ВеёигпедВуе$. Полученный размер диска отобража- 
ется в окне Мето]1 в виде строки такого вида: 


Размер 186,31 ГБ (200 049 647 616 байт) 


Отображение размера в байтах формируется в переменной 3 и разбивается 
в цикле #ог пробелами после каждых трех разрядов. В переменной 51 форми- 
руется строка размера в ГБ, МБ или КБ в зависимости от размера диска. Если 
выполнение функции закончилось неудачей, пользователю показывается окно 
с замечанием. Например: | 

Определить размер не удалось. 


Ошибка: 
'Устройство не готово' 


Информация о конфигурации диска — операция с кодом 

ТОСТ ОТГЗК_СЕТ ОВТУЕ_СЕОМЕТКУ 

Вызов функции Оех1сееТоСопфтго] в синхронном режиме для этой операции 
имеет вид: | 


ОТ5К СЕОМЕТКУ ОС; 
Реу1сеТоСоп®го1 (ПРеу1се, .ТОСТЬ РТ$5К_ СЕТ _РВТУЕ СЕОМЕТКУ, 
МИЬЬ, 0, &0С, з1хеоЕ(р0С), &ВефбагпеаВуеез, МОЪЬ) 


Информация возвращается в структуру типа _ОТЗК _СЕОМЕТКУ, объяв- 
ленную в модуле шидосИ.Й следующим образом: 


суреаеЕ зегасЕе _рт$5К СЕОМЕТВУ { 
ТАВСЕ_ТМТЕСЕВ Су11паегз; 
МЕОТА ТУРЕ Меа1аТуре; 
РИОВО` ТхаскзРегСу11паекг; 
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ОМОВО ЗесфогзРегТгасК; 
РМОВР ВубезРегзес® ог; 
} ОТ5К СЕОМЕТКУ, *РОТЗК СЕОМЕТВУ; 


Поле Су|йп4ег$ этой структуры содержит число цилиндров и имеет тип 
ГАВСЕ ТУМТЕСЕВ (см. описание этого типа в разд. 1.15.1). Поля 
ТгаскзРегСуПпдег, ЗесфогзРегТгасК и ВуезРегЭеефог содержат соответствен- 
но число треков в цилиндре, число секторов в треке и число байт в секторе. 

Поле МеФаТуре характеризует тип диска. Возможные значения этого 
поля определяются перечислением типа _МЕОТА_ТУРЕ, объявленного сле- 
дующим образом: 


фуреаеЕ епим _МЕОТА ТУРЕ { 


ОпКкпомп, // неизвестный формат 

г5_1РЕ2_512, // 5.25", 1.2МВ, 512 БуЕе5/зесвог 
ЕЗ_1Р644_512, // 3.5", 1.44МВ, 512 БуЕе$/зесЕог 
ЕЗ_2Р%88 512, // 3.5", 2.88МВ, 512 БуЕе5/зесЕог 
гЗ_20Р%8_512, // 3.5", 20.8МВ, 512 БуЕе5/зесЕог 
ЕЗ_720_512, // 3.5", 720КВ, 512 БуЕез/зесЕог 
г5_360_512, // 5.25", 360КВ, 512 БуЕе5/зесвЕог 
Е5_320_512, // 5.25", 320КВ, 512 БуЕез/зесвог 
Е5_320 1024, // 5.25", 320КВ, 1024 БуЕез/зесЕог 
г5 180 512, // 5.25", 180КВ, 512 БуЕез/зесвог 
Е5_160_512, ` ИХ 5.25", 160КВ, 512 Буевез/зесвогк 
Ветоуаб1еМеаза, // Съемный диск 

Е1хедМеата, // Несъемный жесткий диск 

ЕЗ_120М_ 512, // 3.5", 120М Е1орру 

РЗ 640 512, // 3.5", 640КВ, 512 Букез/зеског 
г5_ 640 512, // 5.25", 640КВ, 512 БуЕез/зесёог 
г5_720_512, // 5.25", 720КВ, 512 БуЕез/зесвог 
ЕЗ 1РЕ2_ 512, // 3.5", 1.2МЬ, 512 Букез/зеског 
ЕЗ 1Р%23 1024, // 3.5", 1.23МЬ, 1024 БуЕе$/зесвог 
г5 1РЕ23 1024, // 5.25",. 1.23МВ, 1024 Букез/зесвог 
ЕЗ_128МЬ 512, // 3.5" МО 128МЬ 512 БуЕе5/зесЕог 
РЗ_230МЬ 512, // 3.5" МО 230МЬ 512 БуЕе$/зесЕог 
Е8_256 128, И// 8", 256КВ, 128 БуЕез/зеског 
РЗ 200МЬ 512, // 3.5", —200М Е1орру (Н1ЕБ) 
ЕЗ_240М 512, // 3.5", 240МЬ Е1Торру (НЕО) 

ЕЗ 32М 512 // 3.5", — 32МЬ Е1орру 


} МЕРТА ТУРЕ, *РМЕРТА_ТУРЕ; 


При успешном выполнении функции возвращается положительное значение. 

Функция ОемесеГоСопёго] с кодом 1ОСТЬЕ П1ЗК_СЕТ ТГЕМСТН_ТМЕО 
применима к любым дискам, физическим и логическим. Но если в дисковод 
со съемным диском (гибким или СО) не вставлен носитель информации, то 
функция возвращает нулевое сообщение — ошибку. 

Пример получения информации о диске вы можете посмотреть в разд. 6.1.2 


Проверка готовности к работе — операция с кодом 1ОСТГ ЭТОВАСЕ _ 
СНЕСК_УЕВТЕУ 


Вызов функции Оеу1сеТоСопёго] в синхронном режиме для этой операции 
имеет вид: 


Ре\1 сетоСопего1 (пре\у1се, ТОСТЬ $ТОВАСЕ СНЕСК_УЕВТЕУ, 
мМОТЬ, 0, М0, 0, &КебсогпеаВусез, МОТ); 


Функция возвращает положительное число (гие), если диск доступен, 
и возвращает 0 (Ёа1$е), если он недоступен. Пример вызова функции Ое\м!се- 
ТоСопф го] в этом режиме: 
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1Е (Реу1сеТоСопЕго1 (РШеутсе, ТОСТЬ ЗТОВАСЕ СНЕСК УЕВТЕУ, 
МОЪЬ, 0, М, 0, &ВебагпеаВувез, МОП)) 

Мепо1->1пез->Ааа ("Устройство готово к работе"); 

е1 зе 

Мепо1->11пез->Ада ("Устройство не готово к работе"); 


Управление извлечением носителя из устройства — операции с кодами 
ТОСТТ. $ТОВАСЕ_ЕЗЕСТ_МЕГЛА, ТОСТТ, $ТОВАСЕ_Т.ОАР_МЕПЛА, 
ТОСТТ, $ЗТОВАСЕ_МЕОТА_ВЕМОУАТ, 


В таких устройствах со съемными дисками, как СО-ВОМ, можно управ- 
лять выдвижением носителя. Выдвинуть лоток с носителем можно функцией 
еу1сеТоСопфго] с кодом ТОСТ ЭТОВКАСЕ_ЕТЕСТ_МЕПТА: 


Реу1сеТоСоп®го1 (БОеу1се, ТОСТЬ ЗТОВАСЕ_ ЕФЗЕСТ_МЕОТА, 
МОЬЬ, 0, №, 0, &ВебогпреаВуеез, М0); 


Программно задвинуть лоток с носителем можно функцией Беу1сеТоСопфтго! 
с кодом Г1ОСТЬ ЭТОКАСЕ ТОАО_МЕПГА: 


Реу1сеТоСоп*го1 (ПБеу1се, ТОСТЬ 5ТОВАСЕ ТОАР МЕОТА, 
МОГ, 0, МОЬЬ, 0, &ВебагпеаВуеез, №011); 


Функция с этими кодами может применяться только к устройствам, до- 
пускающим соответствующие операции. Функция возвращает фгае, если вы- 
полнена успешно. Так что в общем случае лучше проверять результат ее вы- 
полнение. Например, выдвигать лоток оператором вида: 

1Е (Реу1сеТоСопего1 (ПОеу1се, ТОСТЬ 5ТОВАСЕ ЕФЕСТ_МЕРТА, 

МОТЬ, 0, №11, 0, &ВебогреаВуеез$, М№0т1,)) 


Мепо1->Т1пез->Ааа ("Диск выдвинут"); 
е1зе Мето1->1пез->Ааа ("Диск нельзя выдвинуть"); 


и задвигать его оператором вида: 


1Е (Реу1сеТоСопего1 (Бреу1се, ТОСТЬ 5ТОВАСЕ ТОАР МЕРТА, 
МОГ, 0, №11, 0, &ВебогпеаВуеез$, МОЪ)) 
Мепо1->Т1пез->Ааа ("Диск задвинут"); 
е1зе Мето1->1пез->Ааа ("Диск нельзя задвинуть"); 


Вызов функции Оеу1сеГоСопфго! с кодом ТОСТГ. $ТОВАСЕ_МЕШТА_ВЕ- 
МОУХАТ, позволяет блокировать или разблокировать возможность выдвиже- 
ния лотка. Подобный вызов в синхронном режиме имеет вид: 


РВЕУЕМТ_МЕРТА_ВЕМОУАТ, РМВ; 


Реу1сеТоСоп*го1 (РОеу1се, ТОСТЬ 5ТОКАСЕ_МЕРТА_ВЕМОУАГ, 
&РМВ, $12еоЕ (РМВ), МОГ, 0, &ВебсагпеаВу$ез, МОЪЬ); 


Входным буфером служит структура типа _РВЕУЕМТ МЕОЮОТА_КЕМОУХАГ, 
объявленная в модуле шииосИ.Й следующим образом: 
суреаеЕ зекасе _РВЕУЕМТ МЕРТА_ВЕМОУАТ { 


ВООТЕАМ РгеуепЕМед1аВетоха1; 
} РВЕУЕМТ МЕРТА_КЕМОУАТ, *РРВКЕУЕМТ МЕШТА ВЕМОУАТ; 


Задание в этой структуре значения фгие поля Ргеуеп Ме 1аВКетотуа! бло- 
кирует выдвижение лотка, а задание значения #а]5е снимает блокировку. Если 
выдвижение лотка заблокировано, то носитель нельзя извлечь и вручную. Бо- 
лее того, если приложение закрылось, а блокировка не была снята, то устрой- 
ство так и останется заблокированным. Так что будьте осторожны с этой ко- 
мандой, чтобы не доставить неприятность пользователю. Если в приложении 
предусмотрено использование этой команды, то полезно во избежание непри- 
ятностей при закрытии приложения на всякий случай снимать блокировку. 
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Если подряд выполнено несколько вызовов Оем1ееГоСопфёго]|, задающих 
блокировку, то устройство разблокируется только после такого же количества 
вызовов, снимающих блокировку. 

В разд. 6.1.3 вы найдете примеры использования блокировки и гарантиро- 
ванного разблокирования. 


Блокировка диска — операции с кодами ЕСТЬ ГОСК_УОГОМЕ 
и ЕСТЬ ОМГОСК_УОГОМЕ 


Иногда надо на какое-то время заблокировать диск, например, на период 
его преобразования, форматирования и т.п. Это можно сделать функцией 
Пез1сеГоСопё го] с кодом ЕЗСТЬГ ТОСК_УОГОМЕ: 


Реу1сеТоСоп®го1 (преу1се, ЕЗСТЬ ЪОСК_УОБОМЕ, 
МОЬЬ, 0, МОТ, 0, &КебоагреаВуеез$, МОТ); 


Система не допустит к файлам заблокированного диска. Снять блокировку 
можно функцией Бех1сеГоСопфто] с кодом ЕЗСТТ ОМГОСК_УОГОМЕ: 


Реу1сеТоСоп®го1 (ПРеу1се, ЕЗСТЬ ОМЬОСК_УОБОМЕ, 
МОГ, 0, МОГ, 0, &ВебагпеаВуеез, МОЪ); 


Блокировка также снимется автоматически при закрытии дескриптора 
диска функцией С]1озеНапШе и при завершении приложения. 

Операции блокировки применимы только к логическим дискам, откры- 
ваемым функцией СгеафеЕПе с флагами ЕПЕ_ ЗНАВКЕ_КЕАО, ЕП.Е_$ЗНА- 
ВЕ_\ЕТЕ и с параметром 1рЕЦеМаште, заданным описанным ранее форма- 
том «\\.\х:». Для физических дисков операция выполняться не будет. 

Блокировка не выполняется, если в данный момент открыт какой-то ис- 
полняемый файл на блокируемом диске. 


Демонтаж диска — операция с кодом ЕСТЬ ОТЗМООМТ_УОГОМЕ 


Вызов функции Вез1сеТоСопфго] в синхронном режиме для этой операции 
имеет вид: 


Реу1сеТоСоп®го1 (Б/еу1се, Е$ЗСТЬ РТ5МОЧМТ УОТОМЕ, 
МОТЬ, 0, МОЬЬ, 0, &КебогпеаВуеез$, МОТ); 


Например: 


1Е (Реу1сеТоСоп&го1 (ПБеу1се, ЕСТЬ РТ$МОПМТ _УОГОМЕ, 
МОГ, 0, №15, 0, &ВебогпеаВуеез, МОЪЬ)) 
5ромМе5засде ("Диск демонтирован"); 
е]1зе 
ЗпомМеззаае ("Диск нельзя демонтировать. \пОшибка:\п'" + 
бузЕггогМе$заае (СеефазЕЕгког ()) + "!"); 


Операция применима только к логическим дискам, открываемым функ- 
цией СгежеЕПе с флагами ЕЦП.Е_$НАВЕ_ВЕАО, ЕПЕ_5НАВЕ_МЮМТЕ и 
с параметром 1рЕ|ПеМаше, заданным описанным ранее форматом «\\.\х:». Для 
физических дисков операция выполняться не будет. 

Демонтаж диска означает, что операционная система «не видит» его. Его 
файлы не видны в окне программы Проводник и в папке Мой компьютер, их 
невозможно открыть. 

Впрочем, операционная система, когда требуется доступ к дискам, пыта- 
ется смонтировать демонтированные диски. Например, это происходит при 
вызове функции @е{Т.о51са Отуе5. А нормальным образом демонтированный 
диск монтируется при закрытии дескриптора функцией С1о5еНап Ме или при 
завершении работы приложения. 
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Один из примеров применения демонтажа диска — программа, в которой 
диск форматируется с изменением системы с ГАТ на МТЕВ. Тогда после окон- 
чания форматирования следует демонтировать диск, а затем закрыть дескрип- 
тор. В результате диск зарегистрируется в системе уже как МТЕВ. 


Сжатие файлов и каталогов — операции с кодами. 
ЕЗСТГ, ЗЕТ_СОМРВЕ$ $ ТОМ и ЕЗСТТ, СЕТ_СОМРКЕЗ ТОМ 


Вызов функции в синхронном режиме для операции сжатия файла или ка- 
талога имеет вид: 


ОЗНОВТ БаЕЕ; 


Реу1сетТоСоп®го1 (П)еу1се, ЕЗСТЬ СЕТ _СОМРВЕЗЗТОМ, 
&роЕЕ, $5127еоЕ (БаЕЁЕ), МОИ, 0, 
&КесогпеаВуее$, МОТ); 


а для операции получения информации о сжатии имеет вид: 


Реу1сетоСоп®го1 (ВОеу1се, ЕЗСТЬ СЕТ _СОМРВЕЗЗТОМ, 
МОГ, 0, &роЕЕ, з17еоЕЁ (БоаЕЕ), 
&ВебогпеВу®ез, МОТЬ); 


В первом случае буфер Бай задается как входной, а во втором — как вы- 
ходной. 

Для сжатия в этот буфер предварительно должно быть записано одно из 
следующих значений: 


} СОМРЕЕЗ ТОМ _ `РОВМАТ_ МОМЕ | _ Несжатый й файл или каталог 


| СОМРВЕЗ51ОМ _ _РОЕМАТ_ ТУМТт _ Сжат форматом ТЯМТТ о 


ИИ ИВАН 


01$КЕгее — возвращает свободное место на диске в байтах 
См. функцию @еТ.ог1еа Омуе5&т1т5$. 


015К512е — возвращает размер диска в байтах 
См. функцию @е{Т.ог1еа Опуе И7т5$. 


ОгахАссер Е Цез и другие функции работы с технологией Огах&Огор 
Разрешает форме быть приемником 
Заголовочный файл зйеЦар:.В 
Синтаксис 


З$Н5ТРАРТ (уо1а) ОгадчАссерЕЕ11ез (НИМР Мпа, ВООТ Ассер®); 


ЗН5ТРАРТ _(ОТМТ) РгазОчекуЕ11е (НРКОР ПРгор, ОТМТ Е11етТпаех, 
ТРЗТВ Е11]еМапе, ОТМТ сЬ); 


ЗН5ТРАРТ (уо1а) РгадЕ1пАзр (НОВОР); 


ОгадЕ 15 — окончание перетаскивания файлов 593 


Описание 

Если желательно обеспечить пользователю возможность перетаскивать на 
форму файлы технологией Ога&Огор, как это делается во многих програм- 
мах \\шао\мз, прежде всего надо сообщить системе, что форма может быть 
приемником файлов. Делается это функцией ОгахАесер Е Ц|е$. Ее первый па- 
раметр Уп@Я является дескриптором окна формы, которая может служить 
приемником файлов. А параметр Аесерф, управляет регистрацией окна как. 
приемнмка файлов: фгие указывает на то, что окно регистрируется как прием- 
ник файлов, #а15е — окно снимается с регистрации. 

Если форма объявлена приемником файлов, она должна обрабатывать со- 
общение У\У114омз \УМ_РКОРЕП.Е$. В обработчике этого сообщения вы мо- 
жете получить информацию о полных именах перетащенных файлов с помо- 
щью функции ОгаёФиегуЕЦе. Параметр Огор указывает на поле \УРагат 
структуры сообщения \УМ_РКОРЕШЕ$. Параметр ЕПеп4ех указывает, что 
именно вы хотите узнать. Если значение ЕИет4ех лежит в диапазоне от 0 до 
числа перетащенных файлов, то этот параметр трактуется как номер файла 
(номкра начинаются с нуля). В этом случае функция занесет в массив 
ЕНеМаше размером 6 имя этого файла с полным путем к нему вернет число 
занесенных в буфер ЕИеМате символов, не считая заключительного нулевого. 

Если в качестве параметра ЕИеМаше задать МОТ.Т,, то функция вернет тре- 
буемый размер буфера. Так что по этому значению можно выделить в памяти 
буфер соответствующего размера, и при следующем вызове функции 
ОгаоОцегуЕЦе занести в него имя файла. 

Если задать значение ЕИЦе]пдех равным ОХРРЕРНТЕР, то функция вернет чис- 
ло перетащенных файлов. 

После того как вся информация о числе перетащенных файлов и их име- 
нах получена в обработчике события \УМ_ОВОРЕП.ЕЗ, надо вызвать функ- 
цию ОгаЕпи$В. В функцию надо передать в качестве аргумента поле \УРа- 
гат сообщения. Эта функция освободит память от информации о перетаски- 
ваемых файлах. 

См. примеры применения описанных функций в разд. 6.11. 


ОгахЕпизВ — окончание перетаскивания файлов 
См. функцию ОгагАесер  1|ез. 


ОгаОцегуЕЦе — получает информацию о перетащенных файлах 
См. функцию ОгахАсессер Е 1е$. 


Огам[соп — рисование пиктограммы 
Позволяет рисовать пиктограммы или курсоры 
Заголовочный файл И/пизег.Й 


Синтаксис 
ВООГ ОгамТсоп (ТМ НОС ВРС, ТМ 110% Х,]М 1108 У, [М НТСОМ ВТсоп); 


ВООЪ РгамТсопЕх (ТМ НОС Вас, ТМ 1пе хЬеЕф, ТМ 1пЕ уТор, 
ТМ НТСОМ ВТсоп, ТМ 1пе схМ1аев, ТМ 1106 сумзаеь, 
ТМ ОТМТ 156ертЕАп1Сиг, ТМ НВВКОЗН ПркЕЕ11скегЕгееркгам, 
ТМ ОТМТ 91Е1аа5); 
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Описание 

Функции используются при рисовании пиктограмм или курсоров на кон- 
тексте устройства (см. разд. 5.5.1). В функции Ога\[Шсоп параметр ВОС — де- 
скриптор контекста, на котором должна изображаться пиктограмма или кур- 
сор. Обычно это дескриптор канвы. Параметры Х и У задают координаты лево- 
го верхнего угла изображения, а параметр Шеоп — дескриптор пиктограммы. 

Например, если еоп — дескриптор пиктограммы, полученной из файла 
или иным путем, то оператор 


РгамТсоп (Ттмаде1->Сапуаз->Напа1е, 10, 10, Тсоп); 


изобразит эту пиктограмму на канве компонента Ппабе1. А если значение 
Эсгееп->Сиг5ог$[ МуСиг$] возвращает дескриптор какого-то курсора, загру- 
женного вами из ресурсов (см. функцию Боа4Сигзог) или из файла (см. функ- 
цию ГоааСигзогЕготЕЦе), то следующий оператор отобразит его на той’ же 
канве Ппаге1: у 


РгамТсоп (Тиаае1->Сапуа$->НапЯ1е, 10, 10, $сгееп->Сигзог$ [МуСиг$]); 


Правда, последний оператор сработает только для статического курсора. 
Анимированный курсор отобразить этой функцией невозможно. 


Функция Ога\[ТеопЕх позволяет изменять размер изображения пиктогам- 
мы, а также используется при рисовании курсоров, как статических, так 
‚ ианимированных. Параметр ВОС — дескриптор контекста, обычно канвы. Па- 
раметры Х и У задают координаты левого верхнего угла изображения, а пара- 
метр ВТеоп — дескриптор пиктограммы или курсора. Параметры сх М1 В 
и су\1 Ч — это логическая ширина и высота изображения. Эти значения мо- 
гут отличаться от ее реальных размеров. Параметр 5%4ерМАп!Сиг имеет отно- 
шение к изображениям курсоров и в этом случае указывает фрейм изображе- 
ния. Номера фреймов отсчитываются от нуля. При изображении пиктограмм 
этот параметр задается равным 0. 

Параметр Ш6гЕПеКегЕгееОгам — дескриптор кисти Вги$В контекста, ис- 
пользуемой для фона. Если в качестве ВБгЕНсеКегЕгееОгам задан допустимый 
дескриптор кисти, то система сначала создает невидимый объект ВТТМАР, за- 
полняет фон указанной кистью, рисует на нем изображение, а затем копирует 
этот объект на указанный контекст. Если задать ВБгЕПеКегЕгееОгам равным 
МОЕГГЕ, то система рисует изображение непосредственно на контексте. Это бы- 
стрее, но при рисовании большого изображения появляется эффект мерцания. 

Параметр 41 ]ай5$ — флаг, определяющий, в частности, размер изображе- 
ния. Если задать 91 а$$ = 0, то размеры изображения будут определяться 
значениями параметров сх 14 и су\ 141. А если значения этих параметров 
заданы равными 0, то размер изображения будет равен истинному размеру 
пиктограммы или курсора. Если задать 9 аз = ОТ СОМРАТ, то значения 
сх \У1 и су\14 будут игнорироваться, и размер будет равен заданному 
в системе по умолчанию. Если задать 91 ай$ = ОТ РЕЕАОГТЬТЯЕ, то разме- 
ры будут равны размерам по умолчанию, даже если сх УЛ и су\1 В равны 
нулю. 

Примеры использования описанных функций вы найдете в разд. 5.4.3, 
2.4.5, 2.4.1. 


Огам[сопЕх — изменение размера пиктограммы 


См. функцию Огам[соп 


ЕШр$е — рисует эллипс или окружность 595 


ЕШр5е — рисует эллипе или окружность 
Рисует эллипс или окружность 
Заголовочные файлы иёпё41.й, илпаоиз.В 


Синтаксис 


#10с]аае <и1паом$ .П>. 


ИТМСОТАРТ ВООГ МТМАРТ Е111рзе (ТМ НОС Пас, ТМ 1пе пЪеЕ%Вес®, 
ТМ 10е пТорБесеё, 
ТМ 10106 овтаневесь, 
ТМ 10рЕ пВоЕфбопВесе); 


Описание 

Функция применяется при рисовании на контексте устройства 
(см. разд. 5.5.1). Она рисует эллипс или окружность текущим пером и запол- 
няет фигуру текущей кистью. Параметр В4е — дескриптор контекста. Пара- 
метры пГеЁВес&, пТорВес+, п КВес{ и пВоботКВесё задают соответствен- 
но координаты левой, верхней, правой и нижней граней прямоугольника, опи- 
санного вокруг окружности или эллипса. В УИ ш94омз 95 значения этих пара- 
метров и их сумма не должны превышать 32768. | 

Текущая позиция пера этой функцией не изменяется. Если для контекста 
устройства задана пустая кисть МОГ ВКОЗН, то рисуется только контур. 
А если для контекста устройства задано нулевое перо МОТ. РЕМ, то рисуется 
только заполнение фигуры, а контур не прорисовывается. 

Функция возвращает ненулевое значение в случае успешного выполнения 
и 0 вслучае ошибки. Тогда информацию об ошибке можно получить функцией 
Се а Еггог. 


Епа]еМепиЦет — управляет доступностью раздела меню 
Управляет доступностью раздела меню 
Заголовочный файл ишпизетг.Й 


Синтаксис 


ИТМОЗЕКАРТ ВООГ МТМАРТ Епаю1еМепаТ+ещ (ТМ НМЕМО ВМепа, 
ТМ ОТМТ атрЕраб1етТеем, 
ТМ ОТМТ чЕплаЪ]е); 


Описание 

Функция Епа[еМепиЦет управляет доступностью раздела полосы меню, 
выпадающего меню или контекстного меню, делая его доступным, недоступ- 
ным или недоступным и отображаемым серым. 

Параметр ВМепи является дескриптором меню. Параметр иГОЕпа е {ет 
указывает раздел меню. А параметр иЕпае определяет устанавливаемое со- 
стояние доступности раздела. Флаги, из которых формируется этот параметр, 
указывают также, как именно идентифицируется раздел параметром 
иШЕпае{цет. Параметр задается как сочетание следующих флагов: 


тификатор команды раздела. При этом возможна неодно- . 
значность, если в меню присутствует несколько разделов ‹ 
с одинаковыми идентификаторами. Флаг МЕ_ВУСОМ- 
МАМУ подразумевается по умолчанию, если не задан флаг. 
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и . 


_ВУРОЗЕТЮМ. ` Указывает, ч что параметр › шЕпаЫеЦеш о определяет ин- 
‘декс раздела (индекс первого раздела 0). Если дескриптор | 
| ' ВМепи указывает полосу меню, то индексы относятся 
‚ К заголовкам меню. 

| 
| 
| 
| 


—®иИиИИррЫ—ы=—_—_я_®°т®_—т®_®ТОТОТО©Т©®©ТТ©®©®Т©®Ж©®©®О©— р[ ;- —ИыИИИ—ыы——ы[—ы;|УЫмыщЩ —- тттититтеымьыыы>==—=—= Ш ИУ ————— 1 
| 


МЕ _РТЗАВЕЕО | ‘Указывает, что раздел недоступен, но не > отображается се- 
м . 

МЕ ЕМАВТЕР — Указывает, _что раздел доступен. — В 

'МЕ_СВАУЕО —__ Указывает, что раздел недоступен и ‚ отображается сер серым. серым. _ 


Из флагов МЕ ВУСОММАМО и МЕ_ВУРОЗТТТОМ может быть указан 
только один. Аналогично указывается только один из флагов МЕ ОЗАВЕЕРО, 
МЕ_ЕМАВГЕО и МЕ_ СКАУЕО. 

Функция устанавливает состояние раздела меню в соответствии с задан- 
ным флагом доступности и возвращает предыдущее состояние раздела: 
МЕ_ПЗАВГЕО, МЕ_ЕМАВЕЕО или МЕ_СКАУХЕО. Если указанного раздела 
меню нет, возвращается ОхЕЕЕЕЕЕЕЕ. 

Доступностью разделов меню можно также управлять с помощью функ- 
ЦИЙ СгежфеМепа, Тлзег{ Мепи, Тозег{МепоаЦеж, Гоа9 Мепи т 1гес%, 
Мод{МуМепа, Зе МепиЦет Што. 


Епа Бе \/114о\ — делает указанное окно доступным или недоступным 
Делает указанное окно доступным или недоступным 
Заголовочный файл штизег.П 


Синтаксис 


#10Сс]1аае <и1пазег. [> 
ВОО. МТМАРТ ЕпабБ1еМ1паом (ТМ НММР Б\М№а, ТМ ВОО БЕпаБ1е}; 


Описание 

Функция Епае\ тво делает доступным или недоступным окно, ука- 
занное его дескриптором В\У’п@. Для получения этого дескриптора можно ис- 
пользовать функцию Еша\У’ш9до\м. Если функция применяется к тому окну, 
в модуле которого содержится обращение к функции, то в качестве дескрипто- 
ра можно подставлять свойство НапЩе. 

При значении параметра ЪЕпаШе равном фгие окно делается доступным, 
а при значении #а]5е — недоступным. Если окно недоступно, то предусмотрен- 
ные в нем процессы продолжаются, но пользователь не может воздействовать 
на это окно ни через клавиатуру, ни через мышь. Недоступными делаются 
также все дочерние окна данного окна. 

Функция возвращает нуль, если окно было до этого доступным, и ненуле- 
вое значение, если оно не было доступным. 

Например, следующий оператор делает недоступным окно формы Еогшт2: 


Ераб]1е\1паом (Гоги2->Напа1е, ЕГа]15е); 
А если объявлена глобальная переменная: 
ВООТ ББ = 6гае; 


то каждое выполнение следующего оператора будет переключать состояние 
окна между доступным и недоступным: | 


= Епаб1ей1паом (Гоги2->Напа1е, !1); 
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Впрочем, в этих примерах с тем же успехом можно было бы использовать 
свойство формы ЕпаШе@. Так что реально функцию ЕпаШе\ том имеет 
смысл использовать для окон, для которых известен только их дескриптор. 
Например, как показано в разд. 1.7, следующий код позволяет получить деск- 
риптор стандартной кнопки У/ш@4о\мз Пуск: 

НИМО Н; 


Н = Е1паМтпаочмЕх (Е1пЧ\1паом ("5ре11 Тгау\мпа", МОТ), 
0, "Воебоп", МОЬЬ); 


Тогда оператор 
Епаб]1е\1паом (Н, Еа15е); 


сделает кнопку недоступной, а оператор 


Ерар1е\1паом (Гоги2->Напа1е, Егое); 


восстановит доступность кнопки. 


ЕпишСВПА\/1140о\5$ — перебор окон родительского окна 
Позволяет перебрать дочерние окна указанного родительского окна 
Заголовочный файл И’лизег.Й 


Синтаксис 


#1п0с1аАе<Изтпазет. [> 
суреаеЕ ВОО (САЬЬВАСК* ММРЕМОМРКОС) (НИМ№О, ТРАКАМ); 


ВООТ ЕпаиСр11А\Й1паом$ (ТМ НИМР Б\раРагкепе, 
. ТМ ИМРЕМОМРВОС 1рЕпомРапс, 
ТМ ГРАВБАМ 1Рагапм); 


Описание 

Функция ЕпашСВПЯ\М140о\$ позволяет перебрать дочерние окна роди- 
тельского окна, указанного его дескриптором В\У/п4Рагеп+. Найдя дескриптор 
очередного дочернего окна, функция посылает его в качестве первого парамет- 
ра в написанную пользователем функцию обработки — так называемую функ- 
цию обратного вызова (саПЪаск ЁРапс оп). Адрес этой пользовательской функ- 
ции указывается параметром 1рЕпитЕипе. Третий параметр 1Рагат функции 
ЕпитСЬПЯЧ\/ т 4о\$ передается в качестве второго параметра в пользователь- 
скую функцию. Его пользователь может использовать по своему усмотрению. 

Пользовательская функция должна принимать два параметра: дескриптор 
родительского окна и переданный в нее параметр ГРАВАМ: 


ВООТ САЪТВАСК ЕпоаиИ1паом$Ркос (НИМО Випа, ГРАКАМ 1Рагам); 

Она должна возвращать фгие, если требуется продолжение перебора, или 
Га]5е, если перебор следует остановить. В С++ВоаПаег такая функция с двумя 
параметрами в вызове ЕпаитСЬПа\/1т9омз$ должна приводиться явным обра- 


зом к типу \УМОЕМОМРКОС. 
Примеры применения функции рассмотрены в разд. 5.1.2. 


ЕпитОБ]ес{$ — метод интерфейса ГЗвеПРо]4ег 
См. функцию 5НСеОе$ЕЁорЕо14ег. 
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ЕпотВезопгсеМате$ — позволяет получить список имен ресурсов 
указанного типа 


Позволяет получить список имен ресурсов указанного типа, содержащих- 
ся в ресурсе любого исполняемого модуля, в частности, ВСЁ 


Заголовочный файл И’пфазе.й 


Синтаксис 


ВОО ЕпойВезоцгсеМапез$ (ТМ НМОБОЪЕ ВМодо1е, ТМ .РСЗТВ 1рТуре, 
ТМ ЕМОМВЕЗМАМЕРВОСА 1рЕпопЕапс, 
ТМ ГОМС РТВ 1Рагам); 


Описание 

Функция ЕпатВезопигсеМатез$ позволяет получить список имен ресурсов 
указанного типа. Параметр ВМоде является дескриптором модуля, ресурсы 
которого исследуются. Параметр №Шф'Туре является строкой, указывающей тип 
исследуемых ресурсов. Этот параметр может принимать значения следующих 
констант: 


| ‚Вт АССЕГЕВАТОВ таблица символов клавиш быстрого доступа — 
| ВТ_АМСОВЬОВ _ курсор с анимацией 
| ВТ_АМПСОМ = _ | пиктограмма с анимацией — 
ВТ ВТТМАР ре _| ресурсы ВМР __ ИВ 
`ВТ_ С9В50В __ __| ресурсы аппаратнозависимых курсоров 
ВТА диалоговое кю | 
`ВТ_РОМТ_ _ | ресурсы шрифтов —_ 
ВТ _Ромтов _ ‘ресурсы каталогов шрифтов . 
в ВТ_СВООР_ соЕ50В | ‚ ресурсы аппаратнонезависимых курсоров о 
'ЕТ_СВООР_1С0м ___ | ресурсы аппаратнонезависимых пиктограмм — 
ВТ_1<ОМ . | ресурсы аппаратнозависимых пиктограмм 
ВТ_МЕМО — ___ | ресуреы меню —__ | ПИ | 
| ВТ. _МЕЗЗАСЕТАВТЕ вход таблицы сообщений | 
] ВТ_ ВСБАТА ___ __ | ресурсы, определяемые приложением (сырые данные) | 
ВТ_ ЭТЕТМОе_ _ | Вход таблицы строк И 
‚ ВТ УЕБЗ1ОМ ресурсы версии | | 


Параметр 1рЕпитЕипе определяет адрес функции, которая реагирует на 
каждое найденное значение ресурса. Параметр ШРагашт может определять ка- 
кой-то дополнительный параметр, передаваемый в функцию 1рЕпатГРиапс. 

Если в файле ресурсов исполняемого модуля имеются ресурсы типа, ука- 
занного параметром 1рТуре, то для каждого такого ресурса вызывается функ- 
ция обратного вызова, адрес которой указан параметром 1рЕпитГЕипе. Эта 
функция должна иметь заголовок вида: 


ВООТ САТЬВАСК МуЕпомВезМапеРгос (НАМРОЬЕ РЮМоао1е, БРСТЗТК 1рТуре, 
ТРТЗТВ рз2Мапше, ГОМС 1Рагам); 
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В функцию автоматически передаются параметры ВМодше, ШрТуре, 
Рагаш, указанные аргументами при вызове ЕпаитВезопгсеМате$. Кроме 
того, передается параметр р$7Мате — строка с именем ресурса. Функция 
МуЕпотВезМатеРгос может как-то обработать полученную информацию. 
Если требуется продолжать исследование ресурсов данного типа, то функция 
МуЕпишКезМатеРгос должна вернуть фгае. Если функция вернет #а15е, цикл 
вызовов этой функции, инициированный функцией ЕпитВезопгсеМанте$, 
прервется. 

Пример применения функции см. в разд. 4.4.1. 


Епит \/1100о\5 — перебор окон верхнего уровня 
Позволяет перебрать окна верхнего уровня 
Заголовочный файл И7Тпизег.й 
Синтаксис 


#11с10оАе<И1пазег. |! > 
фуреаеЕ ВОО (САЪЬГВАСК* УМОЕМОМРВОС) (НИМР, ТРАВАМ); 


ВООГ ЕпимМ1паом$ (ТМ ИМРЕМОМРВОС 1рЕпомРопс, ТМ ГРАКАМ 1Рагап); 


Описание | 

Функция Епит\/т9о\з$ позволяет перебрать окна верхнего уровня. Най- 
дя дескриптор очередного окна, функция посылает его в качестве первого па- 
раметра в написанную пользователем функцию обработки — так называемую 
функцию обратного вызова (саПасКк ЁГапс®й0оп). Адрес этой пользовательской 
функции указывается параметром 1рЕпитГЕипс. Параметр 1Рагат функции 
Епит \11д0о\$ передается в качестве второго параметра в пользовательскую 
функцию. Его пользователь может использовать по своему усмотрению. Поль- 
зовательская функция должна принимать два параметра: дескриптор роди- 
тельского окна и переданный в нее параметр ГРАВАМ: 


ВОО САЬЬВАСК ЕпопИ1паоиз$Ргкос (НИМО ПИипа, ЬГРАВАМ 1Рахап); 


Она должна возвращать фгие, если требуется продолжение перебора, или 
Га]зе, если перебор следует остановить. В С++Ви!И4ег такая функция с двумя 
параметрами в вызове Епит\У1т4о\з$ должна приводиться явным образом 
к типу УМОЕМОМРВОС. 


Пример применения функции см. в разд. 5.1.3. 


Ех Ргосе$5 и другие функции звершения процесса 


Обеспечивают досрочное прекращение выполнения дочернего процесса 


Синтаксис 
УОТО Ех1&Ргосез$ (ОТМТ зЕх1ЕСоае); 


ВОО СбеЕЕх1ЕСоаеРгосезв$ (ТМ НАМОЬЕ ПРгосез$, 
ОЧТ ГРОМОВ 1рЕх1&Соае); 


ВОО Теги1паеРгосез< (НАМОГЕ пРгосез$, ОТМТ цЕх1ЕСоае); 


Описание 

Порожденный процесс остается в памяти системы, пока не завершатся все 
его потоки (нити), и пока все его дескрипторы не закроются вызовом 
СозеНапе. Но выполнение процесса можно прекратить досрочно вызовом 
функции Ех Ргосе$$. 
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Параметр иЕх Со4е задает код завершения приложения. Этот код мож- 
но затем определить, вызвав функцию @е Ех ЦСо4еРгосе$$. Параметр 
1рЕх Соде является указателем на переменную, в которую будет занесен код 
завершения процесса пРгосе$$. Если процесс еще не завершился, в эту пере- 
менную будет записано значение ЭТП. АСТТУЕ. Так что вызов функции 
Се Ех Со4еРгосез$ может использоваться для проверки того, завершился ли 
процесс. | 

Вызов функции де Ех ЦСо4еРгосе$$ требует, чтобы доступ к процессу был 
РКОСЕ$5_ОЧЕКУ _ТМЕОВКМАТТОМ. Код завершения, получаемый функци- 
ей, может быть задан в процессе функцией ЕхИРгосез$, функцией Тегпипа- 
феРгосе5$, или возвращаться функцией У\УтМатш. 

При завершении процесса функцией Ех ИРгосез5 происходит следующее. 
Закрываются все дескрипторы объектов, открытые в данном процессе. Завер- 
шаются все потоки процесса. Объект процесса переходит в сигнальное состоя- 
ние, освобождая все потоки, ожидавшие этот объект. Состояние всех объектов 
синхронизации становится сигнальным, так что освобождаются все потоки, 
ожидавшие сигналы этих объектов. Код завершения изменяется с ЭТПЛ, _АсС- 
ТГУЕ на значение, заданное для данного процесса. 

Учтите, что завершение процесса вовсе не означает завершение его дочер- 
них процессов. Если их надо завершить, это необходимо сделать программно 
с помощью той же функции Ех ИРгосе$$. 


Завершить выполнение процесса можно также функцией ТегпитавеРго- 
сез5. При этом дескриптор потока должен иметь доступ РВОСЕ$ 5 _ ТЕВМИМА- 
ТЕ. Процесс может защитить себя от прерывания функцией Тегпицпа&еРго- 
се5$, только изменив права доступа к дескриптору. Параметр иЕхНСоде функ- 
ции ТегттафеРгосе$$ задает код завершения. Завершение процесса функцией 
Тегтта4еРгосез$ более грубое, чем завершение функцией ЕхИРгосез5. Его 
можно использовать только в тех случаях, когда известно, что процесс успел 
заверптить все необходимые операции. Могут также возникать проблемы, если 
данный процесс совместно с другими использует общие ОТ... А в остальном 
операции, присходящие при завершении процесса функцией Тегтта$еРго- 
сез5, подобны описанным выше для функции Тегицпа&еРгосе$$. 


Подробнее о взаимодействии с дочерними процессами см. разд. 3.7. 


Ех ТЬгеа4 и другие функции управления потоком 
Функции управляют потоком 


Синтаксис | 
УОТР Ех1ЕТЬгеаа(1М ОМОВР АмЕх1еСоае); 


ВООГ СеЕеЕх1ЕСоаеТигеаа (ТМ НАМРЬЕ ПБТЬгеаа, 
ОПТ .РОМОВР 1рЕх16&Соае}; 


ВООГ Тегп1паееТЬтеаа (ТМ ОЧТ НАМОЬЕ БТЬгеаа, 
ТМ ОМОВО амЕх1ЕСоае); 


РИОВР 5изрепаТркгеаа (ТМ НАМОЪЕ ВТЬгеаа); 


РИОВО ВезамеТЬгеаа (ТМ НАМОЪЕ БТЬтеаа); 


ЕхИТИгеа4 и другие функции управления потоком 601 


Описание . 

В общем случае вызов функций завершения не является обязательным ус- 
ловием удаления объекта потока. Он может удаляться из памяти и неявно при 
закрытии последнего его дескриптора. 

Завершение потока можно осуществить функцией ЕхИТИгеа4. Параметр 
4\ЕхИСо4е задает код завершения. Этот код, переданный в функцию 
Ех ТИгеа4 или возвращенный оператором гефигп, можно затем определить, 
вызвав функцию а Ех СодеТЬгеа4. Параметр 1рЕх&Соде является указате- 
лем на переменную, в которую будет занесен код, с которым завершился поток 
ВТЬгеаа. Если поток еще не завершился, в эту переменную будет записано 
значение ЭТИЛ,_ АСТТУЕ. Так что вызов функции бе Ех ИСодеТЬгеа4 может 
использоваться для проверки того, завершился ли поток с дескриптором 
ЪТЬгеа4, и если завершился, то с каким кодом. 

Функция Ех {'ТЬгеа4 является наиболее естественным способом заверше- 
ния потока. Она может вызываться как явно, так и неявно при окончании про- 
цедуры потока. Вызов функции приводит к удалению стека процесса из памя- 
ти. Все вызванные потоком ОШ, получают сообщения об отключении от них 
данного потока. Если завершающийся попток является последним в создав- 
шем его процессе, то заверттается и этот процесс. 

Объект потока переводится в сигнальное состояние, освободая другие по- 
токи, которые ждали его завершения. Код потока изменяется со значения 
ЭТП, АСТТУЕ на значение, заданное параметром дмЕхЁСофде. 


Завершить выполнение потока можно также функцией ТегипафеТЬгеа9. 
При этом дескриптор потока должен иметь доступ ТНКВЕАО_ТЕВМТМАТЕ. 
Поток может защитить себя от прерывания функцией ТегиипафеТЬгеа4 толь-_ 
ко изменив права доступа к дескриптору. Параметр 4мЕхЦСо4е функции 
Тегтша4еТЬгеа4 задает код завершения. Завершение потока функцией 
Тегипа&еТЬгеа более грубое, чем завершение функцией ЕхИТИгеа4. Его 
можно использовать только в тех случаях, когда известно, что поток успел за- 
вершить все необходимые операции. Могут также возникать проблемы, если 
данный поток совместно с другими использует общие ОГ, 

Выполняющийся поток можно приостановить с помощью функции %и$- 
репаТЬгеаа. , 

Применять эту функцию надо с некоторой осторожностью. В момент ее 
вызова поток может выполнять операции с каким-то ресурсом, заблокировав 
его. Например, может динамически выделять память, заблокировав Беар. То- 
гда другие процессы смогут воспользоваться этим ресурсом только после того, 
как поток возобновит работу, т.е. когда для него будет вызвана функция 
ВезитеТВЬгеа4. Эту же функцию следует вызвать, чтобы начал выполняться 
поток, для которого при его создании функцией СгежеТИгеа4 был задан флаг 
СКЕАТЕ_5ОЗРЕМОЕО. 

Система ведет счетчик вызовов функций ЗизрепдТЬгеа4 и ВезитеТЬгеа4 
для потока. Каждый вызов ЗазрепаТИгеа4 увеличивает этот счетчик на 1 (но 
результат не более величины, задаваемой константой МАХТМОМ_$05- 
РЕМО СООМТ), а каждый вызов ВезатеТ,геаЯ уменьшает его на 1 (но ре- 
зультат не менее 0). Обе функции возвращают предыдущее значение этого 
счетчика. Функция ВезитеТЬгеаЯ@ возобновит выполнение потока только 
в том случае, если счетчик стал равен 0. Иначе говоря, если для потока не- 
сколько раз была вызвана функция Зазреп4ТИгеаЯ, то выполнение возобно- 
вится только после того, как столько же раз будет вызвана функция 
ВезитеТЬгеа4. | 
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В случае ошибки при выполнении функций ЗазрепаТЬгеаЯ и Кезо- 
шеТ,геаЯ они возвращают значение ОхЕЕЕЕЕЕЕЕ. Тогда причину ошибки 
можно установить, вызвав функцию ве Га$Еггог. 

Примеры управления потоками вы найдете в разд. 3.8. 


Ех Ц Ут дом Ех и другие функции, обеспечивающие выключение 
компьютера и перезагрузку системы 


Производят выключение компьютера или перезагрузку системы 
Заголовочный файл идпизег.й, итфбазе.й, илт4оиз.В 


Синтаксис 
ВООТ, Ех1И1паомзЕх (ТМ ОТМТ иЕ1адз,ТМ№ ОМОВО амВезегуеа);// И1пизег.В 


ВООЬ ОрепРгосезз$Токеп (ТМ НАМРЬЕ Ргосез$Напа1е, 
ТМ РМОВР Рез1геадАссезз, ОЧТ РНАМОЪТЕ ТокепНапа1е);// И1пЬазе. В 


ВООТ ГооКирРЕ1 1 1еде\Уа1че (ТМ ТРСЗТВ 1рзузеешМате, 
ТМ ГРСЗТВ 1рМаше, ОЧТ РЦОТРО 1ра1а);// И1пЬразе.в 


ВООГ Аа] а5ЕТокепРг1у11еде$ (ТМ НАМРОЬЕ ТоКепНапа1е, 
ТМ ВООЬ Р1зар1еА11Рг1\у11едез, 
1М РТОКЕМ РЕТУТЬЕСЕЗ$ Мембфаке, 
ТМ ОМОВБР ВиЕЕегЪепсаеь, 
ОЧТ РТОКЕМ РВТУТЬЕСЕ$ Ргеу1очз$а%е, 
ООТ РРИОВО ВефигпЬепае\й); //Итпаом$.В 


Описание 

Выключение компьютера или перезагрузка системы осуществляется 
функцией Ех Ц \УИтдомзЕх. Параметр 4мВезегуе4 не используется, а параметр 
иЕ]1а25 может содержать следующие флаги, управляющие процессом выклю- 
чения компьютера. 


 Форсировать выключение компьютера. Если задан этот 
_ Фор то У\т9до\мз не посылает сообщения \УМ_@ОЕВУ- 
ЕМОЗЕ$ ТОМ и \УМ_ЕМОЗЕ$ ТОМ выполняющимся 

| | приложениям. Следовательно, эти приложения не смогут 
‘сделать запросов пользователю о сохранении данных 

‚ и могут потерять последние изменения документов, с ко- 
торыми они работали. Так что использовать этот флаг 


‚надо очень осторожно, только в каких-то аварийных си- 
1 _| туациях. 


`Е\Х _ТОбОЕЕ Сменить пользователя. Завершаются все процессы данно- 
‚го пользователя, и осуществляется переход в окно Уш- 
'4о\з смены пользователя. 


м оны 


| Ех. _РО\ЕВОЕЕ. | Выключить компьютер и его систему питания, если 

| компьютер поддерживает эту возможность. В У/ша4омз 95 
этот флаг срабатывает всегда, а в У/ш4аомз МТ\2000\ХР 
только в случае, если данный процесс имеет привилегию 
ЗЕ 5НОТРО\М/М_МАМЕ. 


- +! —— 


Е\!Х ВЕВООТ ‚Перезагрузить систему. В \У/114о\з 95 этот флаг срабаты- 
‚вает всегда, а в \пЧ4омз МТ\2000\ХР только в случае, 


если данный процесс имеет привилегию ЗЕ_ЗНОТ- 


ЕхИ\Мтаом/$Ех и другие функции, обеспечивающие выключение компьютера 603 


= — = - =— == Е 2:25 = —: | 


ЕМХ_ 5НОТОБОММ Выключить компьютер, но не выключать питание. Все 

‚ процессы завершаются нормальным образом. Если в них 
‘при завершении предусмотрены запросы о сохранении 

| ‘данных, они выполняются. Из всех буферов файлов ин- 

| | ‘формация сохраняется на дисках. В \У/1ш4о\з 95 этот 

‚ флаг срабатывает всегда, а в УИш4омз МТ\2000\ХР толь- 
‚ко в случае, если данный процесс имеет привилегию | 


Е ВНОТБОММ_МАМЕ. | 


—=— бы А) 


| 
| 
т 
р 
| 
| 
| 


Функция Ех Ц \шШдом Ех возвращает 0 при успешном окончании вызова 
и возвращается, не дожидаясь окончания выключения системы. 

Смена пользователя — единственный режим, не требующий особых при- 
вилегий. Все остальные режимы не будут выполняться, если приложение не 
имеет соответствующих привилегий. Получить доступ к привилегиям данного 
приложения можно функцией ОрепРгосезТоКеп. Параметр Ргосез$Нап @1]е 
является дескриптором процесса, к привилегиям которого требуется получить 
доступ. Для текущего процесса этот дескриптор можно получить, вызвав 
функцию Се СиггешРгосе$$. Параметр Вез1гед4Ассе$$ является комбинацией 
флагов, определяющих права доступа. Для задачи выключения компьютера 
или перезагрузки системы надо задать флаг ТОКЕМ_АОХТОЗТ_РЕТУП.ЕСЕ$З, 
обеспечивающий возможность изменения привилегий. Имеется также флаг 
ТОКЕМ_@ООЕКУ, позволяющий описанной далее функцией Ада ГокепР:у1- 
1егез получить информацию о предыдущих значениях привилегии. 

Параметр ТокКепНап Ме определяет переменную, в которую в результате вы- 
полнения функции будет занесен дескриптор, дающий доступ к привилегиям. 

Получив этот дескриптор, можно определить локальный уникальный 
идентификатор (Г.ОТО) привилегии с помощью функции ГоокорРыу|еге\а- 
]че. Параметр рЭузетМаште может указывать имя системы, для которой 
ищутся привилегии. Если это локальная система, то значение этого параметра 
можно задать равным МОГГ. Параметр рМаше указывает строку, определяю- 
щую имя привилегии, определенное в заголовочном файле илппЕ.Й. Для наших 
целей это строка «ЗеЗесигцуРиу!ейе» или константа ЗЕ_ЗЕСОВЛТУ МАМЕ. 
Параметр р 4 — это переменная, в которую возвращается ГОТО указанной 


привилегии. 
Получив доступ к привилегиям, можно изменить привилегию с помощью 
функции Ада ТокКепРнуЦехсе$. Параметр ТокКепНап ше — та переменная, 


которая была задана параметром ТокКепНапШе в вызове функции ОрепРго- 
сеззТоКеп и в которую был занесен дескриптор, дающий доступ к привилеги- 
ям. Параметр О1заеАПРиу!Пеге$ определяет доступность привилегий. При 
015аЁёЫй еАПРиуПерфез = фгие все привилегии недоступны. А при О15аЁЁ/ еАПРи- 
уПегез = Ёа!5е новые значения привилегий определяются параметром 
Мемдафе. 

Параметр Мем5 {же указывает на структуру типа ТТокепРму!ехе$, объ- 
явленную следующим образом: 

Куре4еЕ зЕгосЕ _ТОКЕМ РВТУТЬЕСЕ$ { 

РИОВО Рг1\у1]еачеСопцпе; 


ТОТО _АМР АТТВТВОТЕ$ Рг1у11едез [АМУЗТ2Е АВВА\У]; 
} ТОКЕМ РВТУТЬЕСЕ$, *РТОКЕМ_ РВТУТТЕСЕЗ; 


фуредеЕ _ТОКЕМ РВТУТТЕСЕ$ ТТоКкепРг1у11едез; 


Поле РчуПебез — это массив структур типа ГОШ_АМР_АТТЕВОТЕ$ 
или ТЕОШАпдАЙгифе5, поле РиуЦегеСопп& — число элементов в этом мас- 
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сиве. Структуры типа ГОТШ_АМО_АТТЕТВОТЕ$ (ТГОТЛАвдАИгще5) объ- 
явлены следующим образом: 


суредеЕ ' зе гасЕе _ЪУТр_АМО_АТТВТВОТЕЗ$ { 
ОТО База; 
РМОВР АЕег1Бабез; 
} ТОТР_АМО АТТВТВОТЕ$З, * РТОТР_АМО АТТВТВОТЕ$; 


суреаеЕ _ГОТр АМР_АТТВТВОТЕ$ ТЬОТРАПААЕЕЕаЬиеез; 


Поле ГлиЯ — идентификатор ГОТ. Поле А—_гфифез$ определяет совокуп- 
ность флагов. Его значение может быть сочетанием следующих флагов: 


ЕЕ =: =: === Гы == ДД 


ЗЕ_РЕТУП.ЕСЕ_ `ЕМАВТЕР_ ВУ. `РЕЕАОТТ | ` Привилегия д доступна по умолчанию _ 


д ОД——— а щ А 


ЗЕ_Р РЕТУП.ЕСЕ_ ЕМАВЕЕО — _ Привилегия, доступна. — В 
ЗЕ РЕУПЕСЕ_ОЗЕБ_РОВ_АССЕ$5 Привилегия была использована | 
. И ОИ _ Для ‚повышения. прав доступа | 


Параметр Ргеу1ои$$$ае функции Ада ТГокепРиуПегез$ определяет бу- 
фер, в который функция загрузит прежние значения привилегий, а параметр 
ВийЙегГепо В определяет размер этого буфера. Если вам не требуются эти све- 
дения, можете задать Ргеу1ои$ {же = МОШ и ВиЁЙегГепо В = 0. В параметр 
ВебйгиоГепо{ функция записывает требуемый размер буфера Ргеулоц$$афе. 
Надо отметить, что если требуется получать информацию о предыдущих зна- 
чениях привилегий, то кроме задания указанных параметров надо включать 
° флаг ТОКЕМ _@ОЕВУ в параметр БезгедАссез$ при вызове функции 
ОрепРгосе$$ТоКеп. 


Примеры работы с рассмотренными функциями вы найдете в разд. 2.2.1 
и 2.2.2. 


Ех СгежеКе210оп — восстановление региона по запомненному 
См. функцию Се КВегюопОафа. 


Ехфгас( А5ззосафе 1соп — возвращает дескриптор пиктограммы 
с указанным номером | 


Возвращает дескриптор пиктограммы с указанным номером 
Заголовочный файл ЗрепАРГ.А 


Синтаксис 


ЗН$ТРАРТ _(НТСОМ) Ехегас®Аззос1афеЯТсоп (НТМ5ТАМСЕ ПТп$е, 
ГРЗТВ 1рТсопРаЕ И, ТРМОВР 1р1Тсоп); 


Описание 

Функция Ехгасё АззосафедТсоп возвращает дескриптор пиктограммы 
с указанным номером в указанном файле. Параметр 6115$ является дескрипто- 
ром приложения, параметр 1р1ГеопРайёВ — полное имя файла, из которого же- 
лательно получить пиктограмму, фИсоп — переменная, указывающая индекс 
пиктограммы. В большинстве версий \У/114о\з параметр рЦИсеоп не влияет на 
результат. А поскольку индексы пиктограмм начинаются с 0, то практически 
всегда переменной рИсоп можно присваивать значение 0. 


Ех{гасИсоп — извлекает пиктограммы из исполняемых файлов 605 


Функция ищет пиктограмму в указанном файле. Если пиктограмма нахо- 
дится, функция возвращает ее дескриптор. Если в файле нет пиктограммы, но 
с файлом связан другой исполняемый файл, обрабатывающий его как доку- 
‘мент (например, У№ога для файлов .40с), то функция возвращает пиктограмму 
из этого связанного файла. Если пиктограмма так и не нашлась, возвращает- 
ся 0 (впрочем, не всегда). Если пиктограмма нашлась, ее идентификатор, со- 
гласно документации, сохраняется в рИсоп. Но это делается тоже далеко 
не во всех версиях У/ш4о\мз. 

Примеры применения функции Ехфгае Аз5ос1аеадТсоп см. в разд. 5.4.1. 

Извлекать пиктограммы из файлов и библиотек можно также функциями 
Ех(гас _ М соп и 5НСбеЕПеТт Фо. 


Ехфгас соп — извлекает пиктограммы из исполняемых файлов 
Извлекает пиктограммы из исполняемых файлов 
Заголовочный файл ЗйеЦАРГ.В 


Синтаксис — й 


ЗНУТРАРТ (НТСОМ) Ехекас®Тсоп (НТМ5ТАМСЕ ВТп$е, 
.РСОТВ 1рз2ЕхеЕ11еМапе, 
ОТМТ пТсопТпаех); 


Описание 

Функция Ехёгас _соп извлекает пиктограммы из исполняемых файлов, 
ОГ, и файлов пиктограмм со. В отличие от функции Ехга Аззоса4еЯГсоп, 
она позволяет извлечь все пиктограммы, содержащиеся в файле. Параметр 
[15% — дескриптор приложения, вызывающего функцию. Параметр 
р52ЕхеЕПеМаше — полное имя файла, из которого извлекаются пиктограм- 
мы. А параметр шШеоши4ех может в зависимости от ситуации трактоваться 
по-разному. Если Шеопдех = -1, то функция возвращает число пиктограмм 
в данном файле. А если пТеопш4ех — неотрицательная величина, то она вос- 
принимается как индекс затребованной пиктограммы, и тогда функция воз- 
вращает дескриптор этой пиктограммы. Если файл не является исполняемым, 
ОШ; или файлом 4со, то возвращается 1. Если в файле нет пиктограмм, возвра- 
щается 0. 


Примеры применения функции ЕхёгасМесоп см. в разд. 5.4.1. 
Извлекать пиктограммы из файлов и библиотек можно также функциями 
ЕхН`ас Аззосафе Ч Тсоп и ЗНСе Ее о. 


ЕПеЕх15 {5 — проверка существования файла 
. функцию Ва@аве Ее. 


ЕШВесф, шуег( Вес — заполняют область контекста устройства 


Заполняет указанную область контекста устройства заданной кистью или 
заданным цветом 


Заголовочный файл штизег.й 
Синтаксис 


#теАе <\мшиаизег. > 

ИТМОЗЕВАРТ 1пЕ ИТМАРТ Е111Вес® (ТМ НОС ВОС, 
ТМ СОМ$5Т ВЕСТ *1ргс, 
ТМ НВВО$Н РЬг); 
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ИТМОЗЕВАРТ ВОО ИТМАРТ ТрпуегЕВесе (ТМ НОС ВОС, 
ТМ СОМЗТ ВЕСТ *1ргс); 


Описание 

Функции применяются при рисовании на контексте устройства (см. 
разд. 5.5.1). Функция ЕШВесф заполняет указанную область 1рге типа ВЕСТ 
контекста устройства с дескриптором ге заданной кистью или заданным цве- 
том Иг. 

Функция шуег Вес осуществляет операцию НЕ с каждым пикселом 
внутри указанной области, изменяя цвета пикселов. Повторный вызов функ- 
ции туегё Вес приводит к восстановлению исходных цветов. 

Параметр ВБг может быть дескриптором, создаваемым функциями 
СгеафеНафеВгизВ, СгеафеРаЦегпВгиз В, СгеабеЗоПпаВгизй, Се фоскОБуесф. 

Функции возвращают ненулевое значение в случае успешного выполнения 
и 0 в случае ошибки. Тогда информацию об ошибке можно получить функцией 
Се{ Газ Еггог. 

Многочисленные примеры применения описанных функций вы найдете 
в разд. 1.6, 1.14, 5.2.2.3, 5.3.1, 5.3.2, 5.4.1, 5.4.4, 5.5.3 и др. 


ЕтаА{ют — осуществляет поиск атома в локальной таблице 
См. функцию А4Афот. | 


ЕшаСюозеСвВапоеМойЙйсайоп — функция мониторинга каталога 
См. функцию ЕшаЕР1$СвВапоеМойЙса оп 


ЕтЧЕхесиба Ме — возвращает имя и путь приложения, связанного 
с указанным файлом 


Возвращает имя и путь приложения, связанного с указанным файлом 


Заголовочный файл бРе[ПАРГ.И 


Синтаксис 

НТМЭТАМСЕ Е1паЕхесобаЬТе ( 

ЪРСТЗТВ 1рЕ1Те, // строка с именем файла документа 
ТРСТЗТВ 1рро1гесфоку, // строка каталога по умолчанию 
БРТСТВ 1рВези1% // строка с именем исполняемого файла 
); 

Описание 


Функция ЕшаЕхесифа Ме позволяет получить имя исполняемого файла 
ехе, связанного с файлом, указанным параметром 1рЕШе. Параметр 
| рОгесогу определяет каталог по умолчанию. Оба параметра являются указа- 
телями на строки с нулевым символом в конце. Параметр рВезий является 
указателем на буфер в виде строки с нулевым символом в конце, в который 
функция ‘заносит имя и путь приложения, связанного с файлом 1рЕ Пе. 

При успешном завершении функция Еш@аЕхесша Ме возвращает значе- 
ние, большее 32. Если возвращено меньшее значение, это свидетельствует об 
ошибке. 

Пример применения функции приведен в разд. 5.4.1. 


ЕиЧЕРИ${СПапдеМмоЯсаНоп и другие функции мониторинга каталога 607 


ЕшаЕ1 $ СВапоеМо сай оп и другие функции мониторинга каталога 
Функции, с помощью которых осуществляется мониторинг каталога 


Синтаксис 


НАМОЬЕ Е1лпаг1г5СБапоемо$1ЁЕ1сае1оп (ТМ ГРСЗТВ 1рРа\ПМапе, 
ТМ ВООЬ Бмаесб5обегее, 
ТМ ОМОВР аАмМо*1ЕуЕ11%ег); 


ВООГ Е1паМехеСрапаемо*1ЁЕ1са®1оп (ТМ НАМОЬЕ ЮСБапдеНапа1е); 


ВООЬ Е1паС1озеСВапаемМо*1Е1са®е1оп (ТМ НАМОЬЕ ПСрапдаеНапа1е); 


Описание 

Описываемые функции в сочетании с функциями ожидания позволяют 
осуществлять мониторинг заданного каталога или дерева каталогов, имеюще- 
го заданный корень. Такой мониторинг необходим, например, если в приложе- 
нии имеется отображение списка файлов некоторого типа, содержащихся в ка- 
талоге, и требуется знать моменты, когда надо обновлять этот список, так как 
какие-то файлы удаляются, добавляются, изменяются. 

Параметр 1рРайМаште функции ЕшЕ1$ СВапоеМойЯсаНоп указывает 
путь к каталогу, который будет контролироваться. Параметр БУ зе 5 игее 
определяет, должен ли контролироваться только данный каталог, или начи- 
нающееся с этого каталога дерево, т.е. все вложенные каталоги. При значении 
Га]5е контролируется только один каталог, а при значении фгиае — дерево, для 
которого указанный каталог является корневым. 

Параметр ЧмМойЁуЕЩег задает фильтр, который определяет, какие имен- 
но изменения в каталоге должны контролироваться. Этот параметр может 
включать в любой комбинации следующие флаги: 


ЕПЕ_ МОТТЕУ_ СНАМСЕ_ ЕПЕ_МАМЕ Любые 1 изменения имен : пфайлов — 


| 
переименование, удаление, создание 
й новых файлов. 


ЕШЕ_ МОТТЕУ_ СНАМСЕ_ ОТВ _ МАМЕ ‘Любые изменения имен каталогов — 
переименование, удаление, создание | 
новых каталогов. 


| 
ОО —_ — ИВ 


| 'ЕШЬЕ_ МОТТРУ_ СНАМСЕ_АТТМВОТЕ$ Изменение любых атрибутов файлов. | 


| ЕПЕ_МОТТЕУ СНАМСЕ_$12Е Изменение размеров файлов. Изме- 
‘нение происходит при записи на 

| ‘диск в момент очистки буфера кэ- 
‚ширования. 


ЕПЕ_МОТТЕРУ СНАМСЕ_ТАЗТ_ \ЕТЕ Изменение последнего времени запи- 
| ‘си в файл. Изменение происходит 
при записи на диск в момент очист- 


| ‚ки буфера кэширования. 


ЕП.Е_МОТТЕУ СНАМСЕ_ЗЕСОВТТУ Любые изменения дескриптора безо- 


_пасности. | 


При ошибке функция возвращает значение ПМУАГЛ_ _НАМОГЕ_УАГОЕ. 
При успешном завершении возвращается дескриптор объекта синхронизации, 
который далее может использоваться в любых функциях ожидания. Они сра- 
ботают, когда произойдет событие, указанное флагами 4мМойЁуЕ1Щег. 
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После того как результаты события обработаны, можно вызвать функцию 
ЕшаМех{СвапоеМо Иса оп, которая продолжит мониторинг. Параметр 
ВСпапоеНап @М4е — это дескриптор, возвращенный функцией ЕшаЕ1г$СВап- 
геМонЯсайоп. При успешном выполнении функция возвращает ненулевое 
значение. После вызова функции Еш@Мех&СвапоеМонЙсайоп можно опять 
вызывать функцию ожидания. Если событие успело произойти после вызова 
ЕтаЕ1 $ СВапоеМонЙсай оп, но до вызова Ет9Мех СвапоеМонЙса# оп, сис- 
тема запоминает это событие, и тогда функция ожидания среагирует на него. 

После того как функция ожидания сработает, можно повторно вызывать 
функцию ЕшЯаМех{СБапоеМоййсайоп. Вызовы ЕтЯМех СВапоеМонсайоп 
и функции ожидания должны чередоваться. Повторный вызов Е1аЯМ№ехёСвап- 
сеМойЙсайоп без промежуточного вызова функции ожидания приведет 
к ошибке. 

Когда мониторинг больше не требуется, для его завершения надо вызвать 
функцию Ет9СозеСвапхеМоййсаНоп. 

Мониторинг подробно рассмотрен в разд. 6.6.4. 


Е Мех СпапзеМойЙсаЙоп — функция мониторинга каталога 
См. функцию ЕшаЕР1т$СБапбеМонЙсайоп 


Ета\/ том — возвращает дескриптор окна заданного класса 
с заданным текстом 


Возвращает дескриптор окна заданного класса и с заданным текстом 
Заголовочный файл илпизег.й 


Синтаксис 


#10с1ааАе <итпиазег.Н> 
НИМ Е1паМ1паом (соп$Е сраг *1]1рС1аз$Маме, 
сопзЕ сраг *1рИ\И1пАомМате); 


Описание 

Функция ЕшаА\ том возвращает дескриптор окна заданного класса 
1рСаз5Маше и с заданным текстом заголовка окна 1р\т4омМате. Параметр 
1рЦаз$Маше указывает на строку с нулевым конечным символом, содержа- 
щую имя класса. Параметр ш\У1т4о\ Маше указывает на строку с нулевым 
конечным символом, содержащую имя окна (это свойство СарН_оп формы, ото- 
бражаемое в полосе заголовка окна). Если этот параметр равен МОШЕ, то счи- 
тается, что под критерий поиска подходит любое окно указанного класса. 

Если поиск прошел успешно, то функция возвращает дескриптор окна, имею- 
щего указанное имя класса и имя окна. В противном случае возвращается МО. 

Примеры применения функции даются в разд. 1.7, 1.8, 2.3.3, 5.1. 

Другой способ найти дескриптор окна — воспользоваться функцией 
Се Мех \Ут4ом АР \У!119 0%. 


Ета\’ п домЕх — возвращает дескриптор дочернего окна 
Возвращает дескриптор дочернего окна 
Заголовочный файл И’тпизег.й 


Синтаксис 


#1 пс1оае<и пизег. > 
НИМ Е1пА\1паомЕх (ТМ НИМО Рагеп®е, ТМ НИМР Со1та, 
ТМ ЬБРССТКВ 1р$52С1аз5$, ТМ ГРССТК М1паомМаше); 


НазА\Мпдоми — осуществляет мигание пиктограммы приложения в полосе задач 609 


Описание 

Функция Ета\т9омЕх позволяет получить дескриптор дочернего окна. 
Параметр Рагепф является дескриптором того родительского окна, дочернее 
окно которого надо найти. Если этот параметр равен 0, то подразумевается де- 
скриптор Рабочего Стола. Параметр СВИЯ является дескриптором того дочерне- 
го окна, после которого начинается поиск. Иначе говоря, поиск начинается со 
следующего окна в Х-последовательности. Если СВПЯ = 0 то поиск идет, начи- 
ная с первого дочернего окна. Таким образом, если и Рагепф, и СЫПЯ равны 0, 
то поиск идет среди всех окон верхнего уровня. 

Параметр 1р57Саз$ является указателем на строку, содержащую имя 
класса искомого окна, или является атомом, содержащим имя класса и уста- 
новленным ранее функцией С1оба1 А9аА4ц4ют. Параметр У\Ут4ом\Мащте являет- 
ся указателем на строку, содержащую заголовок окна. Если этот параметр ра- 
вен МОТ, ищется окно с любым заголовком. 

Примеры применения функции вы найдете в разд. 1.Т. 


Нап \1п4о\ — осуществляет мигание пиктограммы приложения 
в полосе задач 


Ссуществляет мигание пиктограммы приложения в полосе задач 


Синтаксис 
ВОО Е1азНМ1паом (ТМ НИМО ВБ\Мпа, ТМ ВоОГ ЬТпуег®); 


Описание | 

Функция ЕНазВ \М шоу позволяет организовать мигание пиктограммы 
приложения в полосе задач. Это иногда требуется, чтобы свернутое приложе- 
ние известило пользователя о том, что оно завершило какую-то работу. Пара- 
метр В\У/п@ является дескриптором окна, а параметр Ытуегё определяет ре- 
жим переключения окна. При значении Бтуег& = фгие заголовок окна при ка- 
ждом вызове Еа$ В \У/ том один раз мигнет и останется в подсвеченном со- 
стоянии. При Ытуег = Ёа15е окно переходит в подсвеченное состояние. Если 
первым параметром функции указан дескриптор приложения, то мигание от- 
носится не к заголовку окна, а к пиктограмме приложения в полосе задач. Функ- 
ция возвращает предыдущее состояние окна: фгие, если окно было активно. 

Пример применения функции дается в разд. 5.2.5. 


ЕщЕ ПеВойег$ — передает данные в порт 
См. функцию РагееСотт 


Еогта Меззаге — текстовое описание сообщений об ошибках 
См. функцию Зу$ЕггогМеззайе . 


ЕгатеКес{ и другие функции рисования прямоугольников на контексте 
устройства 


Рисуют прямоугольники 
Заголовочный файл илпизег.й 
Синтаксис 


#1пс1аАе <м1поазег. В > 
ИТМОЗЕВАРТ 1пе ИТМАРТ ЕгапеВесЕ (ТМ НОС Бас, 


ТМ СОМ$ЗТ ВЕСТ *1ргс, 
ТМ НВВО$Н ВЬг); 
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ИТМСОТАРТ ВООГ МТМАРТ Кесфкапа1е (ТМ НОС Вас, ТМ 1пЕ пЪеЕ%&Весь, 
ТМ 1пЕ пТорВеск, | 
ТМ 106 овларевВесе, 
ТМ 1пЕ пВоЕбеопВес®); 


ИТМСОТАРТ ВОО МТМАРТ КоопаВес® (ТМ НОС Вас, ТМ 1пЕ птеЕбВесь, 
ТМ 1пЕ пТорВесеё, | 
ТМ 10пЕ пвтавеВесе, 
ТМ 1пЕ пВоЕбопВесе, 
ТМ 106 пизафь, 
ТМ 10пЕ пНнезарБ®); 


Описание 

Функции применяются при рисовании на контексте устройства (см. 
разд. 5.5.1). Функция ЕгатшеВес& рисует прямоугольную рамку вргруг указан- 
ной области 1рге типа ВЕСТ контекста устройства с дескриптором Шге задан- 
ной кистью №г. Дескриптор кисти может создаваться функциями Сгеа- 
феНаф<ВВгизь, СгеазеРаКегпиВги$ В, СгежеЗо1ЧВгизв, Се ЗфосКОес+. На- 
пример: 

ВЕСТ К = Ттаде1->С11епЕВесе; 

ЕГгатеВес® (Ттаде1->Сапуаз->Напа1е, &В, Сгеабебо11аВгази (с1Веа)); 


Обратите внимание на то, что рамка рисуется не пером, как все остальные 
фигуры, а кистью. Толщина рамки всегда равна 1. 

Функция Вефап]е рисует прямоугольник текущим пером и заполняет 
его текущей кистью. Текущая позиция пера не изменяется. Параметры 
пе Вес+, пТорВес%, пВл Вес и пВоботВес{ задают соответственно коор- 
динаты левой, верхней, правой и нижней граней прямоугольника. Например: 

Весфапа]1е (Тмаде1->Сапуа$->Напа1е, Тпаде1->С11епеВес®.1еЕ%, 


Тпаче1->С11епВесе.бор, Ттаде1->С11епЕВесе.г1апе, 
Тпаче1->С11еп Вес .БоЕфом); 


Функция ВКоип@аВес{ подобна функции Вефапе, но рисует прямоуголь- 
ник со скругленными углами. Дополнительные параметры этой функции 
п \ 14 и пНе!х{ задают ширину и высоту эллипса, используемого для скруг- 
ления углов. Например: 


КоцпаВес+ (Ттадче1->Сапуаз->Напа1е, Ттаде1->С11епЕВесе.1еЕК, 
Тпаче1->С]11епЕВКесе.бор, Тмаде1->С11епЕВес®.г1анф, 
Тпаче1->С11епЕВесе.Боефош, 100, 100); 

ЕгееЕпу!1гоптеп( 5 1125 — удаление блока переменных окружения 


См. функцию Се Епу1гоптепт{ $ {115$ 


ЕгееГл6гагу — выгружает указанный модуль 


Выгружает указанный модуль из адресного пространства вызвавшего про- 
цесса 


Заголовочный файл шпфазе.й 
Синтаксис 


#11с1чае<им1пЬазе. > 
ВОО ИМТМАРТ ЕгееГ1Югагу (ТМ ООТ НМОРОЪЕ ВБЪ1ЬМоао1е); 
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Описание 
_ Функция ЕгееГ4Ьгагу выгружает модуль ОШ», заданный своим дескрипто- 

ром В. №Мо@дие, из адресного пространства вызвавшего процесса. Дескриптор 
ВГЛЬМодще является дескриптором модуля ОШ, загруженного ранее в адрес- 
ное пространство процесса функциями Гоа@ТГгагу или де МодшШеНапе для 
динамического связывания ОШ... При успешном выполнении функция Егее №Ъ- 
гагу возвращает ненулевое значение. 

Функция ЕгееТ4Ьгагу не осуществляет немедленной выгрузки модуля. 
Сначала она уменьшает на 1 число ссылок на модуль. И только если число ссы- 
лок станет равным 0, модуль выгружается. Так что если для этого модуля не- 
сколько раз вызывалась функция Гоа Фгагу, то столько же раз надо вызвать 
ЕгееГ.фгагу, прежде чем модуль будет выгружен. 

См. примеры применения функции в разд. 4.2.4, 1.4, 4.2.2, 4.2.6, 4.4.1. 


СеёАгеОгесноп — определяет направление рисования окружности 
См. функцию Аге. 


Се Аггитеп{5 и другие методы интерфейса Т5ве тк 


Интерфейс 15ВеТлюК имеется у объектов СОМ класса С.8ТШ_Зве!атк, 
отображающих ярлыки \Ушао\з. В этом интерфейсе определены следующие 
основные методы, специфичные для ярлыков. 

Метод Се Аггитет%$5: 

НВЕЗОЬТ ЗТРМЕТНООРСАЬТГТУРЕ СекАгдитепе$ (Т5НЕБЬЬТМК ЕАВ *р$Зр1Ьпк, 


ГРЗТВ р52Агоа$, 
1пЕ ссОМахРа®П); 


Возвращает в буфер р$2Аго$ размером ссВМахРайЙ аргументы командной 
строки при вызове файла, связанного с ярлыком. 

Метод Се ОезегрИоп: 

ВЕЗОГТ $ТОМЕТНОРСАЬЬТУРЕ Се резсг1ре1оп (ТЗНЕБЫЬТМК ЕАВ *р$В1Ьпк, 


.РЗОТВ рз2Мапе, 
1пе ссЬМахМапе ); 


Возвращает в буфер рз2Мате размером сс МахМате описание ярлыка. 
Метод Се Но%Кеу: | 


НВЕЗОГТ ЗТОМЕТНООСАЬГТУРЕ СееНноекКеу (ТЗНЕБЬЬТМК РАВ *роБ1рЬпк, 
МОВО *риНоекеу); 


Возвращает в риНо*Кеу горячие клавиши. 
Метод Се сопГ.осаЙоп: 
НВЕЗОТТ ЗТОМЕТНОРСАТЬТУРЕ СееТсопГосае1оп (Т5НЕГЬЬТМК ЕАВ *р5ь1тпк, 
ТРСОТВ р$2ТсопРа® В, 
110$ ссрТсопРа®В, 
106 *р1Тсоп); 
Возвращает в буфер рз2ТсопРа{ В размера се ВТеопРа{ В путь к файлу, содержа- 
щему пиктограмму, и индекс рЦШеоп этой пиктограммы. 
Метод Се Ра: 
НВЕЗОТГТ ЗТРМЕТНОРСАТГЬТУРЕ СеерРафВ (1$Не1111пк ЕАВ *р5Ь1Ьпк, 
.РЗТВ р5$2Е11е, 1пе ссЬМахРа\В, 


ИТМ32_ЕТМР РАТА *рёЕа, 
РМОВР ЕЕ]1ад3); 


Возвращает в буфер р$2Е1е размера ссВМахРа 1 путь и имя файла, связанно- 
го с ярлыком. В структуру рЁ4 типа Т\УшзЗ2Ет@Оафа (_\М1М32 ЕПМО_ 
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АТА) заносит информацию об объекте (файле или папке), связанном с ярлы- 
ком. Парметр {1а#$ — сочетание флагов, определяющих вид возвращаемого 
имени файла: ГОР ЗНОВТРАТН — формат 8.3, З.СР_ОМСРЕТОВТТУ — 
формат пути ОМС (Ошуегза! Машшя СопуепНоп). 

Тип структуры ТУ1а3 2Етарафа (_\М1М32_ЕПМО _ОАТА), используемый 
в параметре р{Ё4, объявлен следующим образом: 


фуредеЕ зЕгисЕ _И1М№М32_ЕТМОР_РАТАА { 
РИОКО аАмР11еАфег1Бафез; 
ЕТЬЕТТМЕ Е Сгеае1опТ1те; 
ЕТЬЕТТМЕ ЕбТаз®Ассез$Т1апе; 
ЕТЬЕТТМЕ Е Таз Иг1$еТ1пе; 
РИОВО пЕ11е512еН1ай; 
ОМОВО пЕ1]1е517хеГом; 
РИОВО аАмВезегуеа0; 
РИОВОР АмВезекуеа1; 
СНАК сг11еМаме [ МАХ _РАТН ]; 
СНАК СА1 егпафеЕ11еМаме[ 14 ]; 
} ИТМ32 _ЕТМО РАТАА, *РИТМ32 _ЕТМО РАТАА, *Т.РИТМ32_ЕТМО _РАТАА; 


суреаеЕ _ИМТМ32_ ЕТМОЬ РАТАА ТИ1п32Е1парака; 


Метод Се ЗвомСта: 


НВЕЗОГТ ЗТОМЕТНООСАЬЬТУРЕ Сее5вомСпта (ТЗНЕБЬЬТМК РАВ *р5В1Ьпк, 
1пе *р1бПпомСпа); 


Возвращает в рзвомСшт@ вид, в котором открывается окно файла: 5\ 
5ЗНОММОВМАЕ, 5\М_МАХТМТАИЕ и т.п. 
Метод де \\УогктеПгесфогу: 
НВЕЗОГТ 5ТРМЕТНООСАЬТТУРЕ СееМогк1пар1гесфоху ( 
ТЗНЕБЬЬТМК ЕАБ р$В1Тпк, 


ГРСОТВ рз201г, 
106 ссЬМахРа®\); 


Возвращает в буфер рз20 тг размера ссВМахРа{В рабочий каталог открываемо- 
го файла. 
Метод Везауе: 


НВЕЗОГТ 5ТОМЕТНОРСАЬЬТУРЕ Кезо1хуе (ТЗНЕБЬЬТМК ЕАВ *р5ь1рпк, 
НИМО Бмпа, ОМОВр ЕЕ1адз$); 


Указывает окно диалога Уп4@ и флаги Ё ]а#5$, определяющие способы разре- 
шения проблемы, возникающей при отсутствии файла, связанного с ярлыком 
(например, если файл переименован, перемещен, удален). Подробности см. 
в справке И’т3З2.Щр. 

Метод ЗеёАггатепф5: , 

НВЕЗОТТ ЗТОМЕТНОРСАГЬТУРЕ 5екАгаамепе$ (ТЗНЕБЬЬТМК ЕАВ *р5В1лпк, 
| .РСЗТВ рз27Агаз); 
Задает аргументы командной строки при вызове файла, связанного с ярлы- 
ком. 

Метод Зе ОезеериИоп: 


НВЕЗОГТ ЗТОМЕТНООСАТЬТУРЕ Зее,езсг1ре1оп (ТЗНЕБЬЬТМК РАВ *р5р1Г пк, 
ТРСУТВ рз2Маме); 


Задает описание ярлыка. 
Метод Зе Но{кеу: 


НВЕЗОГТ 5ТОМЕТНООСАТГЬТУРЕ ЗееНоекеу (ТЗНЕБЬЬТМК РАВ *р5В1Ьлпк, 
ИОВ мНоекеу); 
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Задает горячие клавиши. 
Метод Зе ЙсопГосайЙоп: 
НВЕЗОЬТ ЗТРМЕТНОРСАЬЬТУРЕ ЗееТсопрЬосае1оп (ТЗНЕБЬЬТМК РАБ *р5Ю11пк, 


.РСЗТВ рз2ТсопРа® В, 
106 1Тсоп); 


Задает путь к файлу рз2есопРа&В, содержащему пиктограмму, и индекс Исоп 
этой пиктограммы. 
Метод Зе Ра{ё: 


НВЕЗОЬТ 5ТОМЕТНООСАЬЬТУРЕ ЗееРафп (ТЗНЕБГЬТМК РГАВ *рэВ1ГпкК, 
.РСЗУТВ р$з2Е1]1е); 


Задает путь и имя файла, связанного с ярлыком. 
Метод Зе ЗВомСта: 


НВЕЗОГТ 5ТРМЕТНОРСАЬЬТУРЕ 5еф5помСпа (ТЗНЕБЬЬТМК РАВ *рэй1Трпк, 
1пЕ 1брпомСма); 


Задает вид, в котором открывается окно файла: 3З\_ЗНО\ММОЕВМАТ, 5\М_ 
МАХЛМТАЕ и т.п. 

Метод! Зе 5 ВомСта: 

НВЕЗОТГТ $ТРМЕТНОРСАЬЬТУРЕ Зе МогК1пар1гескоху ( 


Т5НЕБЬЬТМК РАВК*р5р1рпк, 
ГРСЗТВ р$201г); 


Задает рабочий каталог открываемого файла. 


Все перечисленные методы возвращают в случае успеха значение 
МОЕКВОК. | 

Методы с префиксом «Се{$» дают возможность получить информацию о ка- 
ком-то существующем ярлыке. А методы с префиксом «Зе» позволяют изме- 
нить свойства существующего ярлыка или создать новый ярлык. 

Примеры примененя методов интерфейса 15ВеюК см. в разд. 6.12. 


Се АзупсКеуэ{ же — асинхронное определение состояния клавиши 
Асинхронное определение состояние клавиши 
Заголовочный файл ИУтпизег.В 


Синтаксис 
ЗНОВТ бсесАзупсКеу5 $ аее (ТМ 1пе уКеу); 


Описание 

Определить состояние клавиши в данный момент можно функциями 
Се Кеу {же и СеКеуБоага же. Но иногда требуется узнать, не нажималась 
ли какая-то клавиша в течение определенного времени. Для решения подоб- 
ных задач можно использовать функцию СеАзупсКеу (же. Параметр 
уКеу — виртуальный код клавиши. Задаваемый виртуальный код может, 
в частности, различать левые и правые вспомогательные клавиши так же, как 
в функции деКеуафе. 

Функция СеАзупсКеу {же возвращает значение, в котором старший раз- 
ряд показывает, нажата ли клавиша в данный момент, а младший разряд пока- 
зывает, нажималась ли она с момента предыдущего вызова де АзупсКеу{же. 

Пример применения функции см. в разд. 2.3.2. 
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Се А4отМаште — заносит в буфер строку, связанную © атомом 
из локальной таблицы 


См. функцию АдаАюм. 


Се{Сарфиге — определяет окно, захватившее курсор мыши 


См. разд. «ВееазеСариге и другие функции, управляющие захватом кур- 
сора мыши». 


Се Са$5Маше — определение класса окна 
Позволяет определить класс окна 
Заголовочный файл И//тизег.й 


Синтаксис 


#$1п1с1аае<И1пазег. [> 
116 СееС1аз5Маме (ТМ НИМОР Б\па, одт ТРЗТВ 1рС1аззМапе, 
ТМ 1пЕ пМахСоппЕ); 


Описание 

Функция Се (Саз5Маше позволяет определить класс окна, заданного сво- 
им дескриптором ВУ\Уп@. Функция заносит в буфер р аз$Маше размера 
пМахСоцп( имя класса и возвращает число занесенных символов, или 0, если 
произошла ошибка. Если окно создано в С++Ви!аег, то класс окна — это соот- 
ветствующий класс С++Ви!аег. Если же это программа, которая создавалась 
не в С++Во!аег, то имена классов будут иными. 

Примеры применения функции см. в разд. 5.1.2 и 5.1.3. 


Се СПещКес$, Сер \т4домВес{ — определение размеров окна и его 
клиентской области 


Возвращают размеры окна и его клиентской области 
Заголовочный файл И/’/тизег.й 


Синтаксис 


#1п1с11Аае<И1пазег. | > 
ВОО СеЕМ1паомВес® (ТМ НИМО БМра, ОПТ ТРВЕСТ 1рВес®); 


ВООГ СефсС11епеВес+ (ТМ НИМР Рипа, ОЧТ ТРВЕСТ 1рВес®); 


Описание 

Функции Се \т4омВес& и Се СПетВес& заносят в структуру типа 
ВЕСТ, на которую указывает параметр 1рВесф, размеры окна и его клиентской 
области соответственно. Окно задается своим дескриптором В\У’па. 

При успешном выполнении функции возвращают ненулевое значение. 

Полученные размеры окна можно использовать далее в функциях 
Моуе\/т9до\м, Зе т9домРо$ и других. 

См. примеры применения функций в разд. 5.1.1. 


Се (СоттМазК — получает текущую маску событий порта 
См. функцию эЗеСотт Ма$К. 


Се Сотт5{ае и другие функции получения и установки параметров порта 
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Се Сотш5 {же и другие функции получения и установки параметров 


порта 


Получение информации о параметрах порта. 


Заголовочные файлы штфбазе.й, ИУтаошз.йрр 


Синтаксис 
ВООТ Сеесопибеафе(1М НАМОГЕ №Е11е,ООТ ГРОСВ 1ррСсв); 


ВООГ Зе Сопт5фаее (ТМ НАМРЬЕ ВЕ11]е, ТМ БРОСВ 1рроСсв); 


ВОО СееСопмТ1теосе$ (ТМ НАМРЬЕ ВЕ11е, 
ОЧТ ТГРСОММТТМЕОЧТ$ 1рСоппТ1меоц®$); 


воОГ 5$ееСопмТ1теоцез$ (ТМ НАМОБЕ ВЕ11е, 
ТМ ГРСОММТТМЕОЧТ$ 1рСопиТ1теос*$); 


Описание 
Если вы работаете с последовательным портом (см. разд. 2.5), то после того, 
как он открыт, можно получить информацию о его параметрах с помощью 
функции @аеСотт{ж{фе. Параметр ВЕЦе — дескриптор порта, а параметр 
1рОСВ определяет структуру типа ТОСВ, в которую функция Се Сотт5фафе за- 
носит информацию. Структура объявлена в файле итфбазе.й следующим обра- 


зом: 


фуреаеЕ $5 
ОМОВО 
ОИОВО 
ОМОВО 
ОМОВО 
ОИОВО 
ОМОВО 
РИОКВО 
РМОВО 
ОМОКВО 
ОМОКВО 
ОМОВО 
РИОКО 
ОИОВО 
РИОВО 
ОМОВО 
ОМОВО 
ИОВО 
МОВО 
МОВО 
ВУТЕ 
ВУТЕ 
ВУТЕ 
сраг 
сраг 
сраг 
сраг 
спаг 
МОВО 

} ОСВ, *Ь 


Егасе _ОСВ { 
рСВ1епаевВ; 
ВаоаВа*е; 

ЕВ1пагу: 1; 
ЕРаг1®у: 1; 
ЕОпехС+$Е10м:1; 
ЕОчехо$гЕ10м:1; 
ЕО хСопего1:2; 
Е0згбеп$161\%16у:1; 
ЕТХСоп&1паеОпХоЕЕ: 
ЕОцех: 1; 
ЕТпх: 1; 
ЕЕггогСрваг: 
Е№11: 1; 
ЕВЕ $Соп®го]1:2; 
ЕАБогЕОпЕггог:1; 
ЕБипму2 :17; 
иКезегуеа; 

ХопГ1м; 

ХоЕЕГ1 м; 

Вубе$12е; 

Раг1 у; 

5ЕорВ1*$; 

ХопСраг; 

ХоЕЕСрваг; 

ЕггогСНваг; 

ЕоЕСраг; 

ЕУЕеСраг; 

мВезегуеа1; 

РОСВ; 


1; 


1; 


Поле ОСЩепо В содержит длину структуры в байтах. 

Поле Ваи4Вафе определяет скорость передачи данных в битах в секунду 
(бпс). Это целое число, которое можно указывать или непосредственно, или 
с помощью констант СВК_110, СВК_300, СВВ_600, СВВ_1200, СВВ_ 2400, 
СВК_4800, СВК 9600, СВВ_14400, СВВ_19200, СВВ_ 38400, СВВ_56000, 
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СВВ_57600, СВВ_ 115200, СВВ_ 128000, СВК_256000. Смысл констант ясен 
из их наименований. Так что, если требуется установить значение Ваид Вафе, 
его можно задать, например, равным 14400, или равным СВК_ 14400. Резуль- 
тат будет одинаковым. 

Поле Вуе$12е определяет число битов данных в передаваемых и прини- 
маемых байтах. Это поле может иметь значения 4, 5, 6, Т, 8. Впрочем, не все- 
гда все перечисленные значения допустимы. 

Поле РагЦу задает схему контроля четности. Оно может принимать сле- 
дующие значения (константы объявлены в файле итфазе.Л): 


| Константа Значение | Описание | О | 
_МОРАВИТУ - Отсутствие бита четности о 
| ОРОРАВТТУ Дополнение до нечетности И 

| ЕУЕМРАЮМТУ о Дополнение до четности - 
МАВКРАЕВТТУ 3 Бит четности всегда равен 1 

`ЗРАСЕРАВТТУ |4 Бит четности всегда равен 0 ЫУ——_ 


Поле ЭорВЁ$ задает число стоповых бит. Оно может принимать следую- 
щие значения (константы и их значения описаны в модуле И’таоиЭ5): 


Константа | не Описание | 


| ОМЕЗТОРВУТ 0 —=@_й Один бит —_ 


| ОМЕБ5ЗТОРВТЕТ$ 1_ Полтора бита 


"Т\’ОЗТОРВЕТ8 2 Два бита 


Поле Еу&СвВаг задает символ, приход которого генерирует некоторое собы- 
тие. Этот символ может использоваться в асинхронном режиме работы. 

При ошибке выполнения функция @ЧеСотшт{а{е возвращает Ёа|5е. 
А если ошибки не произошло, функция заполняет структуру 1рОСВ типа 
ТОСВ текущими параметрами настройки порта. 

Далее можно изменить значения полей этой записи и передать новые зна- 
чения параметров в порт с помощью функции Зе Сотт5 фе. Параметры этой 
функции тождественны параметрам функции Че Сошш5фа{фе. В случае неуда- 
чи функция возвращает #а1$е. Неудача может быть связана с заданием недо- 
пустимых значений для данного порта. Например, заданное значение 
ВацаВафе может превышать допустимое. Или может быть задано недопусти- 
мое число бит данных в поле Вуёез1те. 


Помимо рассмотренных основных параметров, работа порта характеризу- 
ется еще рядом параметров, определяющих максимальное время, отводимое 
на операции чтения и записи. Эти параметры определяют тайм-аут 
({1теоц{) — интервал времени, в течение которого функции зациси и чтения 
ожидают появления новой информации. Если это время истекает, чтение или 
запись прерываются. 

Получить информацию о временных параметрах порта можно функцией 
СеСотшТИпеоц{$. Параметр ВЕ Пе является дескриптором порта, а рСотшТ1- 
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тео $ — структура типа ТСоттТипеоц 5. Эта структура объявлена следую- 
щим образом: 


#1пс1аае<и1празе.Н> 

суреаеЕ зегасЕ _СОММТТМЕООДТ$ 

{ 
РИОВР ВеааТпкегуа1Т1теоц*; 
РИОВР КеаЯТока1Т1теоцМи1+1р11ег; 
ОПИОВО ВеаЯТока1Т1теоч®Сопз$ап*; 
РИОВР Мг1кеТтофа1Т1меоцЕМо1{1р11ег; 
ОИОВО Иг1ЕеТоба1Т1теоч Е Сопзв ап; 

} СОММТТМЕОЧТ$З, *.РСОММТТМЕОЧТЗ; 


#1пс1аае<И1паом$ .Врр> 
суредеЕ _СОММТТМЕООТ$ *РСомшТ1теочцез; 
фуреаеЕ _СОММТТМЕООТ$ ТСопшТ1теочц®$; 


Структура содержит следующие поля: 


Поле Описание 
+ 
ВеааП\фегуа ТИ пео0ц$ Максимальное время, допустимое между двумя 


последовательными символами, считываемыми 
с коммуникационной линии. . | 


Веа4То{а!Тпео Мы ЯрЦег Множитель, используемый для вычисления об- 
щего тайм-аута операции чтения. | 

| 

| 


| 
| 
| 
О ООО ОНИ ВИ 


ВеадТоа!Гпеоц Соп${апе |Константа, используемая для вычисления обще- 
го тайм-аута операции чтения. 


УМгцеТоаТтеош МшШриИег | Множитель, используемый для вычисления 0б- 
щего тайм-аута операции записи. 


УгцеТоа ТИ тео Соп${ ап | Константа, используемая для вычисления обще- 
го тайм-аута операции записи. 


| 
| 
ПРИ 


Значения всех полей указываются в миллисекундах. Поле ВеадПщег- 
уа!Тпеоп{ определяет максимальный интервал между двумя последователь- 
ными символами, точнее, между началами передачи двух символов, включая 
время передачи самого символа. Если интервал между символами превысит 
заданное значение, операция чтения завершится, и все данные, накопленные 
в буфере, передадутся в программу. Нулевое значение данного поля означает, 
что данный тайм-аут не используется. Если же в этом поле задать значение, 
соответствующее МАХО\МОВО (4294967295) и одновременно задать нулевые 
значения полей ВеааТофа!Г1 тео Соп${ап{$ и ВеааТо{ а Тпеои М @ЯрПег, то 
операция чтения немедленно завершится и вернет уже принятый символ, 
даже если ни одного символа не было получено из линии. 

Поля УгицеТоа Тео МшШЯрИег и УгЦцеТо{а!Типео{Соп$ {ап анало- 
гичны параметрам Кеа4ТоёаТитеоп Мои! ЯрИег и Веа4Тофа1!ТГтеоц(Сопз- 
фапф, но относятся к операции записи. 

Рассмотренная функция Се СоттТипеоц{$ позволяет определить теку- 
щие временные параметры порта. А функция Зе СоттТипеоц $ устанавлива- 
ет эти параметры порта. 

Способы расчета временных параметров, задаваемых полями структуры 
ТСоттТпеоцв$, и примеры использования всех описанных выше функций 
даны в разд. 2.5.1. 


618 Глава 8. Справочные данные по функциям и структурам АР! МИпдо\и$ 


Се СоттТИпеоц&; — получение временых параметров порта 
См. функцию ЧеСотт$$фафе 


Се ОС, Се\Ут9дом“оС, ВееазерС — управление дескриптором 
контекста устройства 


Функции создания и удаления дескриптора контекста устройства 
Заголовочный файл шпизег.й 


Синтаксис 

#1пс1аае <м1пазег. в > 

МТМОЗЕКВАРТ НОС МТМАРТ Се ёрс (ТМ НИМО Б\а); 
ИТМОЗЕВАРТ НОС СееМ1паомос (ТМ НИМО ВИпа); 


ИТМОЗЕКАРТ 1пе ВКе1еазерс (ТМ НИМР В\па, тм НОС вос); 


Описание 

Доступ к контексту устройства (см. разд. 5.5) обеспечивается его дескрип- 
тором, который может быть получен с помощью функции АРТ У/ш4до\з Се ОС 
или Се\/т4о\)С. В качестве аргумента В \/п@ задается дескриптор окна. 

Отличие функции Се\Утдо\“0С от Се ОС заключается в том, что 
Се \Ут94о\)С возвращает дескриптор контекста всего окна, включая его по- 
лосу заголовка, полосы прокрутки, меню. 

Если функцией Се ОС или бе \У1т4о\0С был получен дескриптор кон- 
текста, то после того, как необходимость в нем отпадет, он должен быть осво- 
божден функцией В@щеазерС. 

На контексте устройства можно отображать изображения, рисовать линии 
и фигуры. Все это подробно рассмотрено в разд. 5.5. 


Се{ОезстрИоп — метод интерфейса ТЗвВе пк 
См. функцию СбеёАгбитеп{5. 


Се ОезКор\У/шт49о\м — возвращает дескриптор Рабочего стола 
Возвращает дескриптор Рабочего стола. 
`Заголовочный файл Ито. 


Синтаксис 
#1пс1аае<И1паомз . В > 
НИМР СеерезКеорИ1паом (УОТр); 


Описание 

Функция возвращает дескриптор Рабочего стола. Полученный с помощью 
этой функции дескриптор можно далее использовать в любых функциях АР! 
\М/114о\з. См. примеры в разд. 1.6. 


Се л15КЕгееЗрасеЕх — информация о размере диска и свободном 
месте на нем 


См. функцию Че ТоглсеаШОмуе {гштсв. 


Се 15 р1ауМатеО{? — метод интерфейса 15веПЕо]4ег 
См. функцию 5НСеОез орЕРо1@ег. 


СеОмуеТуре — определяет тип диска 619 


Се ОтуеТуре — определяет тип диска 
См. функцию Сбе|.о1са Оиуе 5 И т5$. 


Се Епу1гоптет{ $ И`115$ и другие функции работы с переменными 
окружения | 


Функции работы с переменными окружения 
Заголовочный файл И’1паошз.Й, биз 115.Прр, ИТтбазе.й 


Синтаксис 
ТРЗТК СесЕп\1 гопмере $ г1 паз ( УОТр ); 


ВООЬ ЕгееЕпу1гопмепе 5 г1паз$ (ТМ ГРЗТВ); 


РИОВР СеЕЕпу1гоптепеУаг1ар1е (ТМ ГРСЗУТВ 1рМапе, 
ОПТ ТРЗТК 1рВаЕЕегк, 
ТМ РИОКР п5127е); 


ехеегп РАСКАСЕ Ап$15%х1па __Еаз®са11 
СееЕпу1 гопмепеУаг1аЪ1е (сопз® Ап515%&г1па Маме); //5у$0Е115.Прр 


ВООТ ЗееЕпу1гоптеп®Уаг1аЪ1е (ТМ ЬРСЗТК 1рМапе, 
ТМ ГРСУТВ 1рУа1ае); // И1пЬБазе. В 


Описание 

В ряде случаев надо уметь читать и устанавливать переменные окруже- 
ния. Прочитать полный список переменных окружения текущего процесса 
можно с помощью функции Се Епу!гоптеп{ $ {г1т55. Функция возвращает ад- 
‹ рес блока строк вида 


имя переменной=значение 


Эти строки можно только прочитать. Изменять значения переменных с по- 
мощью этих строк невозможно. 

После того как вы извлекли информацию из блока переменных окруже- 
ния, блок надо удалить функцией ЕгееЕпу1гоптеп $ $гт5$. В качестве аргу- 
мента ЕГРЗТВ в нее надо передать тот адрес, который ранее вернула функция 
Се Епугоптеп 5 {т 5$. 

Функция Се Епу!г0оптеп{ $ {1155$ используется в 32-разрядных версиях 
\У/1пЧо\з. В 16-разрядных У\УЛш@Чо\з вместо нее используется аналогичная 
функция Че ООЗЕпугоптепф. После получения информации о переменных 
окружения в этом случае вызов ЕгееЕпу1гоптеп{ $ {1155$ не требуется. 

Получить информацию о значении какой-то конкретной переменной окру- 
жения можно функцией Се Епу1гоптеш{Уана Ше. Здесь 1рМате — указатель 
на строку: с именем переменной, а рВиЁег и п512е — буфер и его размер. 
Но применять удобнее другую форму этой функции. Здесь единственный аргу- 
мент Мате — имя переменной. 

Задать значение переменной окружения или создать новую переменную 
можно функцией Зе ЕпугоптетУагаЫе. Параметр 1рМате — это имя пере- 
менной, параметр 1рУаае — задаваемое значение. Если параметр 1рУаШе ра- 
вен МОГ, то переменная 1рМаше удаляется из списка переменных окруже- 
ния данного процесса. Если переменной с именем 1рМаше нет и 1рУаШше не 
равняется МОГ, то создается переменная с заданным именем и значением. 

Учтите, что функция Зе ЕпугоптетУагае задает значение перемен- 
ной только для данного процесса. Например, вы можете изменить значение 
переменной РАТН, включив в него пути, требуемые для вашего приложения. 
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Но другие приложения будут при этом работать со своими значениями пере- 
менных. 
Примеры работы с переменными окружения вы найдете в разд. 1.13. 


Се Епугоптет Уага Ме — получение информации о значении пере- 
менной окружения 


См. функцию Се Епу1гоптеп{ $ {гщ5 


Се Ех Со4еРгосез5 — получает код завершения дочернего процесса 
См. функцию Ех ЦРгосез$. 


Се Ех Со4еТЬгеа4 — получает код завершения потока 
См. функцию ЕхИТИгеа4 


Се{Но{Кеу — метод интерфейса ТЭве лок 
См. функцию де Аггитепт{$. 


Се _сопГосайоп — метод интерфейса ГЗВеШлаикК 
См. функцию Че Аггитепт%5. 


СеКеу{ж{е — получает сведения о состоянии клавиши 
Получает сведения о состоянии клавиши 
Заголовочный файл И/пизег.й 


Синтаксис 
ЗНОВТ СесКеубфафе (1М№ 1пе пУ1геКеу); 


Описание 

Сведения о текущем состоянии той или иной клавиши дает функция 
СеКеу же. В функцию передается единственный параметр пУп{Кеу — вир- 
туальной код клавиши, состояние которой требуется определить. Возвращае- 
мый результат содержит в старшем бите 1, если клавиша нажата, и 0, если 
клавиша отпущена. Младигий бит содержит 1, если соответствующая клавиша 
переключена, и 0 в противном случае. Возможность переключения известна 
для таких клавиш, как |пзей, ЗН, Мит [осКк, Сарз 1юосК, Зсго! [1оск. Переключен- 
ное состояние (1 в младшем бите) для клавиш Мот [осК, Сарз 1юосК, Зсгой [оск со- 
ответствует включенному индикатору клавиатуры. Для клавиши |пзеп 1 
в младшем бите соответствует тому состоянию, в котором текстовые редакто- 
ры осуществляют режим замены символа, а не вставки. 

Функция де Кеу5 {же позволяет различать левые и правые вспомогатель- 
ные клавиши.Если коды заданы константами УК_ЭНТЕТ, УК_СОМТВОЕ, 
УК_МЕМО, то вернется состояние соответственно клавиш ЗВ, Сн|, АН, незави- 
симо от того, какая из клавиш нажата: левая или правая. Но виртуальные 
коды могут быть заданы константами УК_ТГЗНТЕТ, УК_ТСОМТВОГ, УК _ 
СМЕМО, позволяющими найти состояние левых клавиш, или константами 
УК_В5НТЕТ, УК_ВСОМТВОЕГ, УК_ВЕМЕМО, относящимися к правым клави- 
шам. Причем состояния переключения этих клавиш не зависит друг от друга. 
Например, состояние, выдаваемое для виртуального кода УК_Т.ЗНТЕТ, будет 
переключаться при каждом нажатии левой клавиши №14, но не будет изме- 
няться при нажатии правой клавиши ЭВ. Состояние, выдаваемое для вирту- 


— 


СеНа$\Еггог, ЗеНа$Еггог — работают с кодом ошибки данного потока 621 


ального кода УК_ВЗНТЕТ, будет переключаться при каждом нажатии только 
правой клавиши 56. А состояние, выдаваемое для виртуального кода 
УК_ЭНТЕТ, будет переключаться при каждом нажатии левой или правой кла- 
виши 961. 

Функция СбеКеу$ же дает состояние только одной клавиши. Имеются 
также функции бе КеуБоага {ж{е и Зе Кеубоага {{е, определяющие и ус- 
танавливающие состояние сразу всех клавиш. 

Функция бе Кеу {же дает состояние клавиши в данный момент времени. 
Имеется также функция дСеАзупеКеу же, производящая асинхронный оп- 
рос клавиши, т.е. позволяющая определить, не нажималась ли это клавиша 
в течение определенного времени. 

Примеры применения функции деКеу{фэж{е вы найдете в разд. 2.3.1 и 2.3.3. 


_ Че Таз Еггог, Зе Газ Еггог — работают с кодом ошибки данного потока 
Работают с кодом последней ошибки данного потока 
Заголовочный файл шптфбазе.й 


Синтаксис 


#1п0с1аае <итпБазе.В> 
РИОВО СеЕТазЕЕггог (УоОтТрО); 


УОТР бееГазЕЕгког (ТМ ОМОВО амЕггСоае); 


Описание 

Большинство функций АР \Упо\з возвращают результат, который по- 
зволяет понять, произошла ли ошибка при выполнении функции. Это может 
быть булево значение #а]5е, свидетельствующее об ошибке, значения МОТГ, 
ОхЕРЕЕГЕЕЕ, -1 и др. При этом система вырабатывает некоторый код ошибки 
в виде 32-разрядного числа. Выполнив вызов какой-то функции АР] \У/1п4о\з, 
и поняв по возвращенному результату, что произошла ошибка, код этой ошиб- 
ки можно определить, вызвав функцию Се Таз Еггог, которая возвращает 
значение кода последней ошибки данного потока. Эти коды индивидуальны 
для каждого потока и другие потоки их не изменяют. 

Вы можете и в своих собственных функциях использовать аналогичный меха- 
низм сообщений об ошибках. Это делается с помощью функции Зе Га Еггог. Ар- 
гументом при вызове этой функции задается устанавливаемый вами код ошибки. 
Код должен содержать 1 в 29-ом бите. Этот бит указывает, что код задан прило- 
жением. Во всех системных кодах 29-ый бит равен 0. Так что установка его в 1 
гарантирует, что ваш код не перекроется с каким-то системным кодом. . 

Функция Се Таз Еггог должна вызываться сразу после возврата той библио- 
течной функции, ошибку которой вы хотите проверить. Это связано с тем, что не- 
которые функции вызывают при своем успешном завершении Зе Га$ Еггог(0), 
что уничтожает код ошибки. 

Код ошибки — 32-битовое значение. Наиболее значимый бит 31. Бит 29 
зарезервирован для кода, определяемого приложением. В системных кодах 
этот бит не используется. Таким образом, этот бит показывает, что код был оп- 
ределен приложением. Это гарантирует отсутствие пересечения между ваши- 
ми и системными кодами. | 

Список системных кодов ошибок дается в файле У1М№М№Т.Н. Но этот список 
кодов мало о чем говорит. Имеются функции Зу5ЕггогМез$ асе и Еогта{Мез- 
загсе, которые позволяют получить текстовое объяснение ошибки, причем 
на русском языке. 
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Се Гоглса Омуе тез и другие функции получения информации 
о дисках 


Функции получения информации о дисках 


Синтаксис 


РИОВО СеЕоч1са1Рг1уе5г1па$ (ТМ ОМОВКР пВоаЕЕег ета, 
ООТ ГРЗТВ 1рВаЕЕег); // И1пЬазе. В 


ОТМТ сбеерхлуеТуре (ТМ .РСЗТВ 1рВоокРа&РМате); 


ВОО Сефр1$КЕгеебрасекх ( 
ТМ ГРСЗТВК 1р01гесбогуМапе, 
ОЧТ РУЪАВСЕ ТМТЕСЕВ 1рЕгееВукезАуа11ар1еТоСа11ег, 
ОЧТ РУГАВСЕ ТМТЕСЕВ 1рТоба1М№атрегоЕВу*ез, 
ОЧТ РОБАВСЕ ТМТЕСЕВ 1рТоЕа1МапьегОЕЕгееВуеез); //И1пЬаз5е.В 


ехеегп РАСКАСЕ __ 11664 _ Еаз®са11 213К$1хе (Вуее Ог1уе);// $5у$0Е11$.В 
ехсегп РАСКАСЕ 11664 _ ЁЕаз®са11 Р1зКРгее (Вусе ПОг1уе}; 


ВОО СефУо1амеТпЕогма®1оп (ТМ ГРСЗТВ 1рКооеРа&ПМате, 
ООТ ГРЗТВ 1рУо1амематеВоЕЕег, 
ТМ ОМОВО пУо1амемаме$1те, 
ОПТ ГРРМОВО 1рУо1атмебег1а1Мапег, 
ОЧТ БРОМОВО 1рМах1тамСотропеп® Гепаеп, 
ОЧТ .РОМОВО 1рЕ11ебузещЕ1аа$, 
ОЧТ БРЗТВ 1рЕ11ебузбешМапеВоЕЕег, 
ТМ РМОВР пЕ11ебузкетМаме$17те); 


Описание 

Список всех доступных дисков можно получить функцией Се Т.оглса О- 
уе5 {гп 55. Параметр пВиЙегГепо&В определяет длину буфера 1рВий ег, в кото- 
рый функция заносит список дисков. Функция возвращает длину буфера, ко- 
торая нужна была бы для размещения всей информации. Если возвращенная 
длина больше пВиЁЙегГепо& В, значит, список не удалось занести полностью. 
Если функция вернула 0, значит, произошла ошибка. 

Список размещается в буфере в виде строк, обозначающих корневые ката- 
логи. Например, «С.\». Отдельные строки отделяются друг от друга нулевыми 
символами. В конец списка заносится два нулевых символа. 

Определить тип конкретного диска можно функцией де ОмуеТуре. Пара- 
метр 1рКооё{Ра Маше — это корневой каталог диска в той форме, в которой 
заносит диски в список функция Че П.оглсеаШнуе  и`тсз. Если 1рКоо{ Ра Ма- 
те = МОТГ,, подразумевается текущий диск. Функция возвращает целое чис- 
ло, которое может принимать следующие значения: 


о Тиндиека не определен 
Заданный корневой каталог отсутствует 


Съемный диск 
ОВТУЕ_ЕГХЕО Постоянный диск 
Удаленный сетевой диск 


СеНодксаОтуе$гта$ и другие функции получения информации о дисках 623 


Информацию о размере диска и свободном месте на нем можно получить 
функцией Се О15КЕгееЗрасеЕх. Параметр 1рО1гесфогуМаште — имя каталога 
на том диске, о котором требуется получить информацию. Это не обязательно 
должен быть корневой каталог. Если [|рПО1геффогуМате = МОТГ, будет получе- 
на информация о текущем диске. Параметр 1рЕгееВуе5АуаПаМеТоСаПег — 
свободное место (в байтах) на диске, доступное данному приложению. Пара- 
метр ШрТофа!МишегО!{Вуйе$ — емкость диска, параметр 1рТофаМит- 
ЪегОЁЕгееВуёе$ — указатель на свободное число байтов на диске. 

Перечисленные выше функции — это функции АРТ Ут94о\з. Однако 
в С++Ви!аег есть более простые и удобные функции. Функция 01$К$17е воз- 
вращает размер диска в байтах. Параметр Омхуе задает диск, о котором жела- 
тельно получить информацию: 0 — текущий, 1 — А, 2 — Вит.д. 

Функция 01$КЕгее возвращает свободное место на диске в байтах. Пара- 
метр Омуе имеет то же смысл, что и в функции 01$К$12е. Обе функции возвра- 
щают -1, если указанного диска нет. Так что, организовав цикл по номерам 
дисков, легко определить, сколько дисков имеется на компьютере. 

Информацию о файловой системе, расположенной на диске, можно полу- 
чить функцией дСеУоащтеП{огтайоп. Параметр 1рКооё Ра Маше — корне- 
вой каталог диска. Параметр 1рУоатеМатеВиЁЙег — буфер размера пУош- 
шеМаше$12е, в который возвращается имя диска. В параметр 1рУоште»е- 
га Мишьег возвращается серийный номер диска. Учтите, что это отнюдь не 
заводской номер винчестера. Это чисто служебный номер логического диска. 

В параметр рМахппитСотропеп еп возвращается допустимое число 
символов в элементах имен файлов, т.е. число символов, которые могут разме- 
щаться между обратными слэшами. Например, если поддерживаются длин- 
ные имена, то обычно рМахипатСотропеп Геп>® = 255. 

В параметр 1рЕПеЗузетЕ1а55$ возвращаются флаги, характеризующие 
файловую систему на диске. Параметр может быть сочетанием следующих 
флагов: 


Е$_САЗЕ_1$_РВЕЗЕКУЕО Система сохраняет регистр, в котором за- 
| даны имена файлов, помещаемых на диск. 
Е$_САЗЕ_ЗЕМЭЕГТУЕ Система поддерживает чувствительность 
имен к регистру. 


Е ОМСОБЕ_5ТОВЕО_ОМ_ОТ$К | Система поддерживает символы Оп1соде 
‘в файлах, помещаемых на диск. 


Е$ _РЕКЗТЗТЕМТ_АСТ.5 Система поддерживает АСГ.. 

Е5_ЕПЕ_СОМРВКЕЗЗОМ Система поддерживает сжатые файлы. 
| Е$_УОГ, 1$ _СОМРВЕЗЗЕО 'Данный том сжатый. | 
В буфер 1рЕПеЗу ет МатеВиЁЙег размера пЕЦеЗузетМате$12е возвра- 


щается имя файловой системы, например, «ЕАТ» или «МТЕБ». 
См. примеры в разд. 6.1.1. 
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Се{Мепи и другие функции получения информации о меню 
Позволяют получить информацию о главном меню окна 
Синтаксис | 
НМЕМО СеЕМепи (ТМ НИМО Вита); 

10 бесМепотТеетСоцпЕ (ТМ НМЕМО ЮМепо); 


1пЕ СбеЕМепабЕг1па (ТМ НМЕМО БМепо, ТМ ПТ\Т ато ем, 
ОЧТ .РЗТК 1]р5Ег1па, ТМ 1пе пМахСоцп®, 
ТМ ОТМТ оЕ1ад); 


ВООЬ СсееМепаТ$етТпЕо (ТМ НМЕМО ПМепо, ТМ ОТМТ огем, 
ТМ ВООГ ЕВуРо$1®1оп, 
ТМ ООТ ЬРМЕМОТТЕМТМЕО 1рм11); 
НМЕМО СеббаБМепц (ТМ НМЕМО ЮМепо, ТМ 1пе пРоз); 


ОТМТ беЕеМепотТееттр (ТМ НМЕМО БЬМепа, ТМ 1106 пРоз); 


Описание 
Дескриптор полосы главного меню окна возвращает функция беМепи. 
Единственный аргумент, передаваемый в эту функцию — дескриптор окна 


Определив дескриптор меню, можно узнать число его разделов (выпадаю- 
щих меню) функцией Се МепиЦетСоип&. 

Функция Се Мепи&гше позволяет получить тексты разделов. Параметр 
В Мепи является дескриптором меню. Параметры 1р5%гте и пМахСоипё опре- 
деляют соответственно буфер, в который будет записан текст, и его размер. Па- 
раметры а Цет и иЕЙ!ай определяют раздел, текст которого над найти. Если 
иЕ]ах = МЕ_ВУРОЗГТТОМ, то «ГОЦет — позиция раздела. Первый раздел 
имеет позицию 0, второй — Ти т.д. Если “Нах = МЕ_ВУСОММАМЮ, то 
иГОЦет — команда. Функция бе Мепи$ {т возвращает число символов, 
скопированных в буфер, или 0 в случае ошибки. 

Сейчас функция де Мепиа тя считается устаревшей. Вместо нее реко- 
мендуется использовать функцию бе МепиЦет Ш?о. Параметр иЦет эквива- 
лентен иФЦет в функции беМепо ите. Параметр {ВуРоз1оп должен рав- 
няться фгае, если иЦет указывает позицию раздела. А параметр 1рши являет- 
ся указателем на структуру типа МЕМОТТЕМТ\ЕО (см. ее подробное описание 
в данной главе), в которую записывается информация о разделе. 

Функция Се За Мепи позволяет получить дескриптор выпадающего 
меню. Параметр пРо$ указывает позицию раздела, который соответствует вы- 
падающему меню. Если в данном разделе выпадающего меню нет, возвращает- 
ся 0. 

Для последующего обращения к разделу меню часто требуется знать его 
идентификатор. Этот идентификатор может быть получен функцией 
Се МепиЦет О. Параметр ВМепи является дескриптором меню, а параметр 
пРо$ указывает позицию раздела в этом меню. 

См. примеры работы с меню в разд. 5.1.2 и 5.2.1. 


Се МепиЦетСоип+ — определяет число разделов меню 
См. функцию Се Мепи. 


Се{МепиЦет!О — получение идентификатора меню 625 


Се МепиЦет Ш) — получение идентификатора меню 
См. функцию аеМепи. 


Се МепиЦеш шо — позволяет получить тексты разделов меню 
См. функцию @аеМепи. 


Се Мепи {аж {е — получает флаги раздела меню 
Возвращает флаги, характеризующие указанный раздел меню 
Заголовочный файл штизег.й 


Синтаксис 


ТМОЗЕВАРТ ОТМТ ИТМАРТ сеЕМепибфа®е (ТМ НМЕМО БМепа, 
ТМ ОТМТ ота, 1мМ МТ оЕР1аа5); 


Описание 

Функция @е Мепифэже возвращает флаги, характеризующие указанный 
раздел полосы меню, выпадающего меню или контекстного меню. Эту функ- 
цию имеет смысл использовать, если не требуются расширенные возможно- 
сти, даваемые более мощной функцией СеМепаЦет шо. 

Параметр ВМепа является дескриптором меню. Параметр и указывает 
раздел меню. А параметр иЕ1ай5$ определяет, как именно идентифицируется 
раздел параметром и. Возможные значения этого параметра: 


МЕ_ВУСОММАМО Указывает, что параметр и определяет идентификатор 

команды раздела. При этом возможна неоднозначность, 
если в меню присутствует несколько разделов с одинако- 
выми идентификаторами. Флаг МЕ_ВУСОММАМР подра- 
зумевается по умолчанию, если не задан флаг МЕ_ВУРО- 
ЭГТОМ. 


МЕ_ВУРОЭПТОМ |Указывает, что параметр и определяет индекс раздела 
(индекс первого раздела 0). Если дескриптор ВМепи ука- 
| зывает полосу меню, то индексы относятся к заголовкам 


меню. 


Если указанного раздела меню нет, функция возвращает ОхЕГЕГЕЕЕЕЕ. 
Если раздел имеется, функция возвращает маску раздела — флаги, объединен- 
ные операцией ог. Если раздел является головным для выпадающего меню, то 
маска возвращается в младших разрядах, а старшие разряды содержат число 
разделов выпадающего меню. 

Возвращаются следующие флаги, характеризующие раздел: 


МЕ_СНЕСКЕО В разделе имеется индикатор, свидетельствующий о том, 


| 
И что раздел выбран. 
МЕ_ПББЗАВЕЕР Раздел недоступен. 


у 


МЕ_СКВКАУЕО Раздел недоступен и отображается серым. 


Раздел подсвечен. 
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МЕ _МЕМОВАКВ- |Раздел содержит переход на новую строку для полосы 
ВЕАК меню или на новый столбец для подменю. В последнем 

случае новый столбец отделяется разделителем в виде вер- 
тикальной черты. 


МЕ _МЕМОВВЕАК |То же, что МЕТ_МЕМОВАЕВВКВЕАК, но без разделителя 
в виде вертикальной черты. 


МЕ _ЗЕРАКАТОВ |Раздел является разделителем в виде горизонтальной черты. 


Примеры применения функции см. в разд. 5.2.1. 


Се Мепи {гте — позволяет получить тексты разделов меню 
См. функцию Се Мепи. 


Се Мех том — определяет дескриптор следующего. 
или предыдущего окна 


Определяет дескриптор следующего или предыдущего окна в /-последова- 
тельности. 


Заголовочный файл штпизег.Й 


Синтаксис 


#$10с1аае <м1пазег. НВ > 
НИМО СеЕМехЕ\М1птаом (НИМО В\па, ЧОТ\МТ мСпа); 


Описание 

Функция Се Мех У т4о\м определяет дескриптор следующего или преды- 
дущего окна в Й-последовательности. Следующее окно — это то, которое вызы- 
валось из указанного или к которому пользователь обращался после создания 
указанного окна. Если указано дочернее окно, то поиск ведется среди дочер- 
них окон. 

Параметр В\/п@ — дескриптор окна, от которого начинается отсчет. Пара- 
метр “Сш4 определяет направление поиска. Если мСт@ = С\_НУ\УМОМЕХТ, 
то ищется следующее окно, находящееся ниже. Если \мСшЯ = С\М_ 
Н\УМОРКЕУТХ, то ищется предыдущее окно, находящееся выше. 

Если окно найдено, то возвращается его дескриптор. Если следующего или 
предыдущего окна нет (в зависимости от значения \МСт9), то возвращается 0. 
Развернутую информацию об ошибке можно получить вызовом функции 
Се Газ Еггог. | 

Использование функции бе Мех \114о\у/ дает тот же самый результат, 
что и вызов функции Се \Уш@4дом со значением параметра иСт@, равным 
С\’_Н\УМОМЕХТ или С\М’_НУ\УМОРВЕТХ. 

См. примеры в разд. 5.1.3. 


Се Оуе1арред4 Вези{ —получение информации о завершении записи 
или чтения в порт 


См. функцию Зе СоттМазК. 


Се Рагеп& — возвращает дескриптор родительского окна 
Возвращает дескриптор родительского окна 


Заголовочный файл И’пизег.й 


Се{Ра{И — метод интерфейса 5ненипк |, 627 


Синтаксис 


#1пс1аАе<Итпизег. В > 
НИМО СефсРагеп* (ТМ НИМР ВМ\Ма); 


Описание 

Функция С@е{Рагеп{ возвращает дескриптор окна, родительского по отно- 
шению к окну с дескриптором В\/п4. Если родительского окна нет, возвраща- 
ется МО. 

Используется при определении родительского окна (см. разд. 5.1.2). 


Се Ра — метод интерфейса ТЗве/пК 
См. функцию деАггитеп $. 


Се Ргогку( аз и другие функции информации о процессе 
Получают информацию о процессе 


Синтаксис 
РИОКО СееРг1ог1®уС1а$$ (НАМОЬЕ ПВРгосезз); 
ВООГ ЗеРг1ог1®уС1а$$ (НАМОЬЕ ВРгосезз$, ОМОВКО амРг1ог1®УС1аз$3$); 


ВООГ СеЕРгосеззТлмез$ (НАМОТЕ ВБРгосез5$, 
.РЕТЬЕТТМЕ 1рСгеа®*1опТаше, 
.РЕТЬЕТТМЕ 1рЕх1%Тапе, 
ТРЕТЬЕТТМЕ 1]рКегпе]1Т1ме, 
ТРЕТЬЕТТМЕ 1рОзегТлпе); 


Описание 

Функция де Рногцу(1аз$ позволяет определить приоритет выполнения 
процесса, а функция Зе Риогцу(а$$ позволяет изменить приоритет выполне- 
ния. 

Возвращаемое функцией Се Риогцу(азз значение и параметр 4\Рг1ог- 
+УСа$$ в вызове функции Зе Риогцу аз$ могут принимать значения: НТОН__ 
РЕТОВТТУ_СГА$$, ШОТГЕ_РВОВТТУ СГА$5, МОКМАГ РЕОВТТУ _СТА$$, 
КЕАГТТМЕ РЕТОВТТУ_СТА$$5. Смысл этих значений описан в функции 
СтезжеРгосез$. 

Функция Че РгосезТипез позволяет получить сведения о времени выпол- 
нения процесса. Все параметры, кроме, конечно, дескриптора ВРгосез$, имеют 
тип ГРЕП.ЕТТМЕ — указатель на структуру типа ЕШЕИМЕ, хранящую зна- 
чение времени. Значения хранятся как число сотен наносекунд. Параметр 
1рСгеайопТипе указывает момент создания процесса. Параметр 1рЕхйТипе 
указывает момент завершения выполнения процесса. Если процесс еще вы- 
полняется, то значение, возвращающееся в этот параметр, не определено. Зна- 
чения обоих параметров 1рСгеаНопТ1ше и 1рЕх\'Типе — это число интервалов 
по 100 нс., отсчитанных с полуночи 1 января 1601 года по Гринвичу до соот- 
ветствующего момента времени. Параметр 1рКегпе!Г1ще указывает время, за- 
траченное процессом на работу с системой. А параметр 1рО5егТ1те указывает 
время, затраченное процессом на выполнение кода приложения. 

Примеры применения описанных функций см. в разд. 3.1. 
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Се РгосА94гез$ — возвращает адрес указанной функции 
Возвращает адрес указанной функции, экспонированной указанной ОШ, 
Заголовочный файл штфазе.й 


Синтаксис 


#1п1с1аАе<и1пБазе. | > 
РГАВРВОС МТМАРТ Се РгосАаагез$з$ (ТМ НМОРОЬЕ РМоао1е, 
ТМ ЬРССТК 1рРгосМапе); 


Описание | 

Функция Се РгосА@4@4ге$$ возвращает адрес указанной функции, экспони- 
рованной указанной ОШ.. Этот адрес требуется для вызова экспортированной 
функции при динамическом связывании ОШ.. Параметр Моде является де- 
скриптором модуля ОШ. загруженного в адресное пространство процесса 
функциями Гоа@Г.Югагу или бе МодшШеНап Ме. Параметр 1рРгосМаше указы- 
вает строку, содержащую имя функции, или определяет в младшем слове по- 
рядковый номер функции. | 

Если функция выполнилась без ошибок, она возвращает адрес экспониро- 
ванной функции. В противном случае возвращается МОТ. Тогда узнать при- 
чину ошибки можно функцией Се Та$Еггог. 

См. применение этой фунцкии в разд. 4.2.4. 


Се Ргосез$Типез — позволяет получить сведения о времени 
выполнения процесса 


См. функцию Че Риогцу(а5$. 


Се{Верз1оп)аа, Ех Сгез{еВе10оп — запоминание и восстановление 
региона 


Запоминание и восстановление региона 


Синтаксис 


РИОВО СесКед1опрВа*а (ТМ НВСМ ВВап, ТМ РМОВО амСочпЕ, 
ОЧТ .РЕСМРАТА 1рБапрафа); 


НВСМ ЕхеСгеакеВеатоп (ТМ СОМЗ5Т ХРГОВМ *1рХхХЕогш, ТМ РИОВР пСоипе, 
ТМ СОМЗТ ВСМРАТА *рКапрафа); 


Описание 

Задачи создания форм и окон произвольной формы решаются с помощью 
понятия области, региона окна (см. разд. 5.2.2.1). Регион — это часть окна, 
воспринимаемая именно как окно. Все, что находится за пределами региона, 
не воспринимается пользователем и системой как окно. | 

Если регион сформирован, то его задание для оконного компонента, включая 
форму, осуществляется функцией Зе \т4ом/ В. После ее выполнения владель- 
цем заданного региона становится система. Так что этот регион нельзя использо- 
вать повторно — его надо заново создавать. Но пока регион не использован в вызо- 
ве функции Зе \Утдо\чВет, его можно запомнить функцией Се Везоп)Оа4а. Па- 
раметр ВВеп является дескриптором запоминаемого региона. Параметр амСоцп® 
указывает число байтов в буфере 1рВоп)Оаца, в котором должны сохранятся дан- 
ные региона. Если объема буфера не хватило для записи всех данных, или если 
в вызове Се Веглоп)аёа параметр рВеп)аёа задан равным МОЩ,, то функция 
возвращает число байтов, необходимое для хранения данных. В остальных случа- 
ях при успешном выполнении функция возвращает 1, а при ошибке — 0. 


Се{5КомиСт — метод интерфейса 15$Пе!Ипк 629 


Запомненные данные можно использовать для восстановления по ним ре- 
гиона с помощью функции Ех СгежеВег1оп. Параметр рХ#огт указывает 
структуру типа ХРОВМ, которая может использоваться для трансформации 
региона. С ее помощью можно проводить любые линейные преобразования ре- 
гиона: сдвиг, поворот, зеркальное отражение, масштабирование. Так что 
функция Ех СгежеВерглоп может не только восстанавливать запомненный ре- 
гион, но и трансформировать его. Если задать 1рХ#огт равным МОШ,, то 
трансформация не будет проводиться. Параметры пСоипф и рВпОафёа опреде- 
ляют размер и указатель буфера, в котором хранятся данные региона. Функ- 
ция возвращает дескриптор результирующего региона. 

Примеры использования описанных функций см. в разд. 5.2.2.1 и5.2.2.3. 


Се ЗВомСт@ — метод интерфейса 1ЗВе лик 
См. функцию Се Агегитепф$. 


Се юскКОБес{ — возвращает дескриптор объекта 


Возвращает дескриптор предопределенного пера, кисти или шрифта для 
использования на контексте устройства 


Заголовочный файл штда1.А 


Синтаксис 


#10с1аае <и1паа1.6> 

ИТМСОТАРТ НСОТОВУ сес тоскорЗесе (тМ тп ЕПОрЗесе); 

Описание 

Функция возвращает дескриптор соответствующего пера, кисти, шрифта, 
палитры для контекста устройства (см. разд. 5.5.1). Параметр #1ОЦес{ может 
принимать одно из следующих значений: 


ВГАСК _ВКОЗН Черная кисть. 


КОКАУ_ВКОЗН | Темно-серая кисть. 

| СВАУ_ВВКО5$Н Серая кисть. 

| нотл.0\_ВвО$Н, МОМ, _ВВОЗН 
ГТСКАУ_ВКОЗН Светло-серая кисть. 

\УНТТЕ_ВКОЗН Белая кисть. 

ВГАСК_РЕМ Черное перо. | 

МОГ РЕМ Нулевое перо (не рисует линии). 

| УШТЕ_РЕМ Белое перо. 


АМЗТ_УАВ_РОМТ Системный шрифт с непостоянной шири- 


ной символов. 
| РЕУГСЕ_ ОЕРАОГТ_ЕРОМТ Только в У\У/114о\з МТ: шрифт, определяе- 


| мый устройством. 
| РЕЕАОГТ_ СОТ _ЕОМТ Только в У ш9домз 95: шрифт по умолча- 
| 


нию для меню, диалогов и других объек- 
тов пользовательского интерфейса. 


ОЕМ_ЕТХЕО_ЕРОМТ Зависящий от производителя (ОЕМ) 
| шрифт с постоянной шириной символов. 
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ЗУЗТЕМ_ЕОМТ Системный шрифт по умолчанию с изме- 
няющейся шириной символов. 


ЗУЗТЕМ _ЕХЕР_ЕОМТ Системный шрифт с постоянной шириной 


символов. Только для совместимости с вер- 
РЕРАОГТ_РАГЕТТЕ 


сиями \М//т4о\з более ранними, чем 3.0. 

Палитра по умолчанию, содержащая ста- 

тические цвета системной палитры. 
Например, оператор 


НВКО$Н НМОЪЬ = бее5оскОр)ес& (МОЪЬ ВВОЗН); 


занесет в переменную НМОТ! дескриптор пустой кисти. При использовании 
такой кисти фигуры, рисуемые различными функциями, не будут закрашива- 
ться внутри. 


Се Зи Мепи — позволяет получить дескриптор выпадающего меню 
См. функцию СеМепи. 


Се Зуз$етО1тесфогу — возвращает путь к системному каталогу 
\1190о\$ 


Возвращает путь к системному каталогу УМ ш4о\жз. 
Заголовочный файл штизег.й 
Синтаксис 


#10с10ае <и1пазег. В > 

ОТМТ ИТМАРТ сбефбузеет01гесвокуА (ОТ ГРЗТВ 1рВоЕЕек, 

ТМ ОТМТ 95127е); 

ОТМТ ИТМАРТ Себбузеетр1гескокуй (О0Т ТРИЗТВ 1рВаЕЕег, 
ТМ ОТМТ иб12е); 

+1ЕаеЕ ОМТСООЕ 

#АеЕ1пе СесбузЕетр1гесеогу Сеебузфетмр1гесеокуйм 

#е1зе 

#АаеЁ1пе Сеебузеетр1гесеоку Себбузеетр1гесвокуА 

#епатЕ 


Описание 

Функция Се ЗузетО1тгесвогу возвращает путь к системному каталогу 
\У!114омз. Это каталог, в котором размещены файлы библиотек, драйверов, 
шрифтов. 

Приложение не должно создавать какие-то файлы в системном каталоге. 
Создавать свои файлы можно в каталоге, возвращаемом другой функцией — 
Се\У том Пгесфогу. 

Параметр 1рВоЁег является указателем на строку с нулевым символом 
‚ в конце, в которую передается найденный путь. Этот путь записывается без за- 
ключительного обратного слэша, если только системный каталог не является 
корневым. 

Параметр и512е указывает максимальный размер буфера в символах. Его 
величина должна быть не менее значения МАХ_РАТН.: 

При успешном выполнении функция копирует путь в ВиЙЁег и возвращает 
число символов в строке, не считая последнего нулевого. Если длина строки 
больше, чем и512е, то возвращенное значение позволяет узнать требуемый 
размер буфера. 


себуеттТо — возвращает информацию о процессоре 631 


Если функция не смогла успешно завершиться, то она возвращает нулевое 
значение. В этом случае узнать причину отказа можно, вызвав Се Таз Еггог. 


Пример 


Если ваш системный каталог У\!11п4о\/$ назван \У1ПМОО\М/5\буз{ет32 и рас- 
положен на диске О, то операторы 


спаг А[МАХ РАТН]; 
Сее5узет0О1гес®огу (А, МАХ_РАТН); 


занесут в А путь: "О:\\УПМООМ/БЗ\ \бузет32\0”. Полученный путь можно, 
например, использовать для проверки, имеются ли на компьютере пользовате- 
ля нужные библиотеки, драйверы и шрифты. 


Се Зузет шо — возвращает информацию о процессоре 
Возвращает информацию о процессоре 
Заголовочный файл штфазе.й 
Синтаксис 


#Тпс]1аае <м1пьазе.|в> 
УОТО ИТМАРТ беебузкемТптпЕо (ОПТ БРЗУЗТЕМ ТМРО 1р5узеемТпЕо); 


Описание 

Функция Се Зузет шо заносит информацию процессоре в структуру 
типа ЗУЗТЕМ 1 МЕО (см. ее подробное описание в данной главе), на которую 
указывает параметр 1р5узфеп по. 


Се ЗузетМепи — дает доступ к объекту системного меню 
Дает доступ к объекту системного меню. 
Заголовочный файл штизег.й 


Синтаксис 


ИТМОЗЕВАРТ НМЕМО ИТМАРТ СебсбузеепМепа (ТМ НИМО Била, 
ТМ ВООЬ БВеуег®); 


Описание 

Функция Се ЗузетМепи обеспечивает приложению доступ к системному 
меню и возможность его модификации такими функциями, как СеМе- 
поет] п?о, 1пзегМепиЦет, Зе МепиЦеш шо. Параметр В \7п@ является де- 
скриптором того окна, системное меню которого вас интересует. Параметр 
ЪВетег{ определяет, что именно делает функция. При БВеуегё = #Ёа15е функ- 
ция возвращает копию меню, которую можно в дальнейшем модифицировать. 
При ББВеуег+ = фгие функция устанавливает в окне системное меню по умолча- 
нию. При этом ранее существовавшее в окне меню уничтожается. 

В случае БВеуег+ = фгие функция возвращает 0. 

См. применение функции в разд. 2.4.2, 5.2.1. 
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Се Т!1те7опе шогтайоп, ЗеТипейопеш{огтайоп — информация 
о дате и времени с учетом временного пояса 


Возвращают и задают информацию о дате и времени с учетом временного 
пояса 


Заголовочный файл Итаош3з.Прр 


Синтаксис 


суре4еЕ зеёгисЕ _ТТМЕ 2ОМЕ_ ТМЕОВМАТТОМ { 
ТОМС Взаз; 
ИСНАК 5ЗсапаагЯМате[ 32 |; 
СУСТЕМТТМЕ 5Еапаагара*е; 
ТОМС ЗкапаагаВ1аз; 
ИСНАВ Пау11ан&№ате[ 32 ]; 
ЗУЗТЕМТТМЕ Рау11ап&Ра*е; 
ТОМС ПБау119р%В1аз; 
} ТТМЕ 2ОМЕ_ ТМЕОВМАТТОМ, *РТТМЕ 2ОМЕ_ТМЕОБМАТТОМ, 
*ГРТТМЕ _2ОМЕ_ТМЕОВБМАТТОМ; 


суре4еЕ _ТТМЕ_ 2ОМЕ ТМЕОВМАТТОМ ТТ1мебопеТпЕогма&1оп; 


РИОВР бееТ1ме2опеТпЕогма® тол ( | 

ОЧТ ТРТТМЕ 2ОМЕ_ ТМЕОВМАТТОМ 1рТ1мебопеТпЕогма®1оп); 
вОоОЬ бееТ1тейопеТпЕогма тол ( 

СОМ5Т ТТМЕ 2ОМЕ_ТМРОВМАТТОМ *1рТ1мебопеТпЕогма®1оп); 


Описание 

Функция Се Типейопеш{огта оп дает доступ к информации о поясном 
времени, на которое настроена система. Эту информацию функция извлекает 
из настроек \У/!14о0\з и заносит в структуру типа ТТипейопеш{огта оп, ука- 
занную параметром 1рТипейопе{огтайоп. Функция Зе Гтейопе {огта- 
Поп заносит аналогичную информацию в систему. 

Информация определяет соотношение между стандартом согласованного 
универсального времени (Соог4тафеа Отуегза! Тппе — ОТС или время по 
Гринвичу) и локальным временем. Основное поле записи 1рТипейопе?ог- 
таНоп, которое определяет соответствие между этими временами, — Ва$. Это 
смещение в минутах локального времени по отношению к ОТС. Например, для 
Москвы Ваз = —180. Т.е. московское время опережает ОТС на 3 часа. В общем 
случае: 


ОТС = локальное время + смещение. 


Для зимнего времени смещение равно значению поля В1а$ + значение 
поля З$апдагаВ1аз, которое обычно равно нулю. Для летнего времени к значе- 
нию поля В1а$ добавляется значение поля Вауй В 1а$. Обычно это значение 
равно —60 (сдвиг на 1 час). 

Остальные поля структуры 1рТипейопей{огтаНоп уточняют особенности 
локального времени и даты переходов между летним и зимним временем 
(см. в описании ТТипейопеп{огтай оп). 

При успешном вызове Се Типейопе {огтайоп функция возвращает одно 
из следующих значений: 


се{\Мег$юп — позволяет получить информацию о версии М/Итдо\ми$ 633 


ЫМЕ_20ОМЕ_ТШ ОМКМОММ Операционная система не может определить. 
временной пояс. Это может быть, если перед 

этим при вызове функции Зе Типтейопе]т{ог- 
таНоп в рТипе?йопе {огтайоп было задано 
только поле смещения Ваз. 


'ТТМЕ_70МЕ_То_5ТАМРАЕО 


Операционная система работает в соответствии 
со значением поля З$апдагаОз{е записи 1рТ1- 
те2опе{огтайоп, т.е. по стандартному (зим- 


[я 
| 
ИИ 


нему) времени. 


'ТОМЕ_7ОМЕ_ТШ_ОАУШМСНТ |Операционная система работает в соответствии | 
со значением поля Вауй Оа{е записи 1рТипе:- | 


Гопе{огтайоп, т.е. по летнему времени. 


Если вызов аеТипейопе {огтай оп привел к ошибке, возвращается зна- 
чение ОхРЕКЕГЕЕЕЕ. 

Функция ЗеТипейопе{огтайоп возвращает в случае ошибки ненуле- 
вое значение. 

В случае ошибок при вызове функций расширенную информацию о них 
можно получить с помощью функции Се а${Еггог. 

Работа с локальным временем подробно рассмотрена в разд. 1.15.2. При- 
мер примененя приведен также в разд. 3.10. 


СетУег510п — позволяет получить информацию о версии У\Ут90о\$ 
Позволяет получить информацию о версии УЛ т9до\мз. 
Заголовочный файл илпбазе.В 
Синтаксис 


#1пс]1аае <м1празе.й> 
ОМОКО УТМАРТ СекУег$1топ (УОТр); 


Описание 

Функция Се Уегз1оп позволяет получить информацию о версии \У/114о\$. 
Она сейчас считается устаревшей, и в новых приложениях рекомендуется при- 
менять Се Уегз1опЕх. Но есть случаи, когда Се Уегзоп удобнее. Функция 
возвращает значение, содержащее в младшем слове номер версии \У/ш@4о\з, а 
в старшем — информацию о платформе операционной системы. 

Младший байт младшего слова содержит основной номер \У/1т4о\з в шест- 
надцатеричном виде, а его старший байт (в версиях, кроме У ш4о\мз 95) содер- 
жит дополнительный номер (модификацию) тоже в шестнадцатеричном виде. 
Таким образом, при распознавании версий можно руководствоваться следую- 
щей таблицей: 


Платформа | Старший бит Младший байт 

| | __ (основной номер версии). 
‚ МПтаомз$ МТ 0 

Ут4о\мз 95 1 

' УИ п25 УВ Утдо\мз 3.1 |1 
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Надо иметь в виду, что понятие версий У/ш4о\з, даваемое функцией 
СеГУегз10п, заметно отличается от обиходного. Под понятие У/114о\з МТ под- 
ходят и У!т9до\з 2000\МЕ\ХР. А под понятие У\У1т4о\з 95 подходят все вер- 
сии \У!пдо\з 9.х, например, \/1194о\з 98. 

Функция Се{Уегз1оп удобна, если не требуется информация о версиях, 
а надо только определить, относится ли УМт4о\мз к группе МТ, или к груп- 
пе 9.х. Для этого достаточно выполнить оператор: 


1Е (СебУегззоп() < 0х80000000) 
{...} 


Особенности применения фунцкии рассмотрены в разд. 2.1.1, а многочис- 
ленные примеры применения встречаются во многих разделах книги, когда 
требуется определить версию \/Мт4о\з. 


СегУегзопЕх — позволяет получить информацию о версии У т4о\5 
Позволяет получить развернутую информацию о версии \Ут94о\з 
Заголовочный файл итфазе.й 


Синтаксис 


#1пс1аае <м1пьазе. в > 

суреаеЕ зеёгисе _ОЗУЕВКЗТОМТМЕОА { 
РИОВО амо5Уегз1опТпЕоб17е; 
ОИОКО АмМа)огУег$1оп; 
ОМОВР амМ1погУег$1оп; 
РИОВО АмВа11АМоапрег; 
РМОВР амР1а+Еогита; 
СНАК $52С5)0Уегз1оп[ 128 ]; 

} ОЗУЕВЗТОМТМЕРОА, *РОЗУЕВКЗТОМТМЕРОА, *ГРОЗУЕВ$ТОМТМЕОА; 


фуре4еЕ ОЗУЕВЗТОМТМЕОА ОЗУЕВЗТОМТМЕО; 
суре4еЕ РОЗУЕВКЗТОМТМЕОА РОЗУЕВЗТОМТМЕО; 
фуре4еЕ .РОЗУЕВЗТОМТМРОА ГРОЗУЕВЗТОМТМЕО; 


ВООТ МТМАРТ Сефе\Уегз1опеЕх ( 
ТМ ОЧТ БРОЗУЕВЗТОМТМЕОА 1рУегз1опТпЕогта®1оп); 


Описание 

Функция Се УегзюопЕх позволяет получить информацию о версии 
У\М/Л1т194о\з. Она сейчас рекомендуется для применения в новых приложениях 
вместо считающейся устаревшей функции Се Уегзоп, хотя есть случаи, когда 
СегУегяюоп удобнее. 

Единственный параметр функции Се УегзюопЕх указывает структуру 
типа ОЗУЕВКЗОЩУЕО. Поля этой структуры содержат следующую инфор- 
мацию: 


[Поле [Описание 


ОУ\ОКО 4\05Уегз1ош1п 0517 | Размер структуры. Должен задаваться до вызо- 


ва СеУегзюовЕх. 


РУТОКО 4”МалогУегзюоп Основной номер версии. 


О\ОВО 4^МшогУегоп Дополнительный номер версии. 


се\Мошитеттогта оп — получает информацию о файловой системе 635 


РР 


| Поле Описание 
| ® . 
| ОУОВО дуВои|ПаМитЬег Для Утдомз МТ — номер модификации. Для 


Утао\з 9.х младшее слово — номер модифи- 
кации, старший байт старшего слова — основ- 
ной номер версии (то же, что 4мМа]огУегз1оп), 
младший байт старшего слова — дополнитель- 
ный номер версии (то же, что 4иМтогУегз1оп). 


О\ОКО 4“Р!аНМогш] 9 Платформа операционной системы:УЕВ_РГАТ- 
ЕОВМ_\М1М325 — Утдомз 3.1 с \/1132$, 
УЕК_РГАТЕОВМ_М\М1ТМЗ2_\ТМООМ$ — Уш- 
Чо\з 95 (точнее, \/1т4о\мз 9.х) с У\/1т 32, 
УЕК_РГАТЕОВМ_\1М32_МТ — Ут9домз МТ 


(2000\ХР) с У 132. 


| СНАЕ $2С50Уегз1он[ 128 ] Необязательная дополнительная информация. 


Надо иметь в виду, что понятие версий У! ш@4о\мз, даваемое функцией 
Се{Уег$10опЕх, заметно отличается от обиходного. Под понятие УИш@Чомз МТ 
подходят и У\У/шаомз 2000\МЕ\ХР. А под понятие У/!п4омз 95 подходят все 
версии \У/тао\з 9.х, например, У шао\мз 98. 

Примеры применения фунцкии рассмотрены в разд. 2.1.1. 


СергУоштеп\{огтайЙоп — получает информацию о файловой системе 
См. функцию Се Тог1са Оыуе Ят$. 


Се\Ут4ом — определяет дескриптор окна, находящегося с указанным 
в некотором отношении 


Определяет дескриптор окна, находящегося с указанным в указанном со- 
отношении (по Й-последовательности или по последовательности владельцев) 


Заголовочный файл шпизег.й 


Синтаксис 


#$1пс]аае <и1пазег. > 
НИМР СеЕ\М1паом (НИМРЬ Рипа, отмт аСпа); 


Описание 

Функция бе \т94о\м определяет дескриптор окна В\Уп@, находящегося 
с указанным в указанном родственном отношении иСт4. Эта функция позво- 
ляет найти при использовании различных значений аСт@ дескрипторы лю- 
бых открытых окон У\Ут9о\$. 

Параметр В\/’п@ — дескриптор окна, по отношению к которому определя- 
ются соотношения родства. Параметр иСт@ определяет соотношения родства 
и может принимать значения: 


С\’_СНПО Определяется дескриптор дочернего окна на вершине 

| 7-последовательности, если указано родительское окно. 
В противном случае возвращается дескриптор МОТГ.. 

| Проверяются только дочерние окна указанного окна, но 

| не его потомков. 


| (\У_Н\УМОЕТАЗТ Определяется дескриптор окна того же типа, находящего- 
| ся в верху /-последовательности. 
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С\_Н\УМОГА$ЗТ |Определяется дескриптор окна того же типа, находящего- 
ся в внизу Й-последовательности. 


С\_Н\УМОМЕХТ |Определяется дескриптор следующего окна в 2-последова- 
тельности. 


С\_НУ\УМОРВКЕУ |Определяется дескриптор предыдущего окна в 7-последо- 
вательности. 


С\’_О\ММЕБ Определяется дескриптор окна, являющегося владельцем 
| указанного. 


Если окно найдено, то возвращается его дескриптор. Если требуемого окна 
не существует, то возвращается 0. Развернутую информацию об ошибке мож- 
но получить вызовом функции Се Газ Еггог. 

Примеры применения функции вы найдете в разд. 5.1.2, 5.1.3. 


Сег\т4ом“)С — возвращает дескриптор контекста окна 


См. разд. «Се ОС, де \У/14ом ОС, ВееазерС — управление дескриптором 
контекста устройства» | 


Се\Ушт4домР1асетеп$, Зе А тдомР]асештеп{ — позволяют работать 
с характеристиками местоположение окна 


Позволяют получить и установить характеристики, определяющие место- 
положение окна формы 


Заголовочный файл Утизег.В 
Синтаксис 


#Тпс1аае <И1пазег. В > 
суреаеЕ эзегиас®е кад"ТМРОИРТАСЕМЕМТ { 
ОТМТ 1епаев; 
ОТМТ Е1адз; 
ОТМТ  эромСма; 
РОТМТ реМ1пРо$1е1оп; 
РОТМТ рЕМахРо$1%1оп; 
ВЕСТ гсМ№огта1Ро51%1о0п; 
#епа1Е 
} ИТМООИРЬАСЕМЕМТ; 


суреаеЕ ИТМРОИРТАСЕМЕМТ *РИТМРОМРТАСЕМЕМТ, *ГРИТМРОИРТЪАСЕМЕМТ; 


ВООГ Сее\И1паомР1асемепе (ТМ НИМО Вйпа, 
ОПТ ИТМРОИРТАСЕМЕМТ *1рмпар1); 
ВОО 5е\М1паомР1асетеп* (ТМ НИМО П\Мпа, 
ТМ СОМЗТ ИТМРОИРЬАСЕМЕМТ *]1рипар1); 


Описание 

Функции Се \тдомР]асетеп{ и Зе \Уш4омР1асетеп$, позволяют соот- 
ветственно получить и установить характеристики, определяющие местополо- 
жение окна, указанного его дескриптором В\/па. Параметр 1рми@др| является 
указателем на структуру типа УПМООМРГАСЕМЕМТ. Ее поле 1епрВ содер- 
жит размер структуры в байтах. Так что перед вызовом описываемых функ- 
ций значение этого поля надо задать равным $12ео (УТМРОМРГЕАСЕМЕМТ). 
Поле Яаг$ при вызове функции Се \Ут4омР]асетеп{ всегда равно нулю, 
а при вызове функции Зе \т4омР]1асетеп{ задает флаги, определяющие по- 


се\/ЛИптаомиР!асетеп" — работает с характеристиками местоположение окна 637 


ложение окна в свернутом виде и метод его последующего восстановления. 
Данное поле может содержать один или два следующих флага: 


\УРЕ_КЕЗТОВЕТОМАХ1- Флаг указывает, что после восстановления окно 
‚ МЕТРЕБ | 


должно быть развернуто, независимо от того, 

в каком состоянии оно было до свертывания. 
Установка этого флага влияет только в случае, 
если окно свернуто ($вВомСт@ = $5\_$ЗНО\/М1- 
МИМТРЕО), и только на одно очередное восстанов- 
ление. Флаг не изменяет поведение окна при по- 
следующих восстановлениях. 


Флаг указывает, что координаты свернутого окна 
могут быть заданы полем рЕМшРоз1оп. | 


Поле звомСт@ показывает или устанавливает состояние окна. Поле мо- 
жет иметь одно из следующих значений: 


ии. НИИ 


3! _НШЕ 'о — 


кно делается невидимым, и фокус передается 


другому окну. 
Развертывает (максимизирует) указанное окно. - 


$\М_МПИМТЕЕ 


окно верхнего уровня в списке системы. 


- 


тивизирует следующее в Х-последовательности - 


| 
| 
5\_ВЕЗТОКЕ Активизирует и отображает окно. Если это окно 
свернуто или развернуто, то оно восстанавливает- 
ся до своих первоначальных размеров и отобра- — 
жается в первоначальной позиции (почти то же 
самое, что $З\_$НО\М/МОВМАГ.. | 
| 
| 


$\_5НО\ Активизирует и отображает окно в его текущей 
позиции и с текущими размерами. 


| 

о оон 

\5\/_ ЗНОМ/ОЕЕАОТТ Устанавливает состояние в соответствии с флагом 

5\_ в структуре ЭТАВТОРТЕО (см. ее описа- 

ние в данной главе), передаваемой в функцию 

| СгеажвеРгосез$ программой, запускающей прило- 

| жение. Приложение должно вызывать ЭВом\Ут- | 

4о\ с этим флагом, чтобы задать начальное состо- | 

яние своего главного окна. - | 
| 
| 


5\/_5НОММАХТМТАЕО Активизирует и отображает окно в развернутом о 


| виде (максимизированном). 


НИ 
| $ \’_ЭНОМ/МГИМТМТАЕР Активизирует и отображает окно в свернутом — 
| 


виде (в виде пиктограммы). 


О к 
| 
1 


5\_5НОММПИММОАСТТУЕ Отображает окно в свернутом виде (в виде пик- 
| тограммы). Активным остается то окно, которое 
было активным до этого. 


| 
| 
ОНИ 
| .. 
5\’ 5НОММА Отображает окно в его текущей позиции и с теку- 
р щими размерами. Активным остается то окно, 


р которое было активным до этого. 


638 Глава 8. Справочные данные по функциям и структурам АР! М/Ипдо\му$ 


5\’_5НОММОАСТТУАТЕ | Отображает окно в его последней позиции и с по- 
следними размерами. Активным остается то 
окно, которое было активным до этого. 


3\М_5НОММОКМАГ Активизирует и отображает окно. Если это окно 


свернуто или развернуто, то оно восстанавливает- 
ся до своих первоначальных размеров и отобра- 
жается в первоначальной позиции (почти то же 
самое, что З3\_ВЕЗТОВЕ). - 


При вызове функции Се \УтдомР]асетеп{ поле зВо\Ст@ может прини- 
мать только значения 53\_ЗНО\ММАХТМТОЕО — развернутое состояние, 
5\М_5НО\/МИМТМТЛЕО — свернутое, 3З\_$НОММОВМАГ — нормальное. 

Поля р МшРоз Шоп, рЕМахРо5 101 и гсМогта1Роз1 оп определяют коор- 
динаты левого верхнего окна соответственно в свернутом, развернутом и нор- 
мальном состоянии. 

При успешном завершении функции Сбег\Утао\Р1асетет и Зе Уш- 
домР]1асетеп{ возвращают ненулевое значение, в случае ошибки — 0. 

См. примеры применения функций в разд. 5.5.1. 

Получать и изменять местоположение окна можно также функциями 
Сег\”тд4дом\Вес+, Се СПещ{Вес{, Моуе\т9до\м. 


Сег\ тдомКВес{ — определение размеров клиентской области окна 
См. функцию де СЦеп{ Вес 


Се\Ут4о\Вгп — возвращает копию региона окна 
Возвращает копию региона окна 
Заголовочный файл ИЛпизег.В 
Синтаксис 


#Тпс10ае <И1пизег. [> 
1пЕ ИТМАРТ Сеё\1паомВап (ТМ НИМР БМпа, ТМ НВЕСМ ЮВап); 


Описание 

Функция Се \УтдомВсп возвращает копию региона окна, указанного 
своим дескриптором В\Уп@. Координаты региона отсчитываются от левого 
верхнего угла окна (а не его клиентской области). Параметр ВВ еп — дескрип- 
тор копии региона. Он в дальнейшем может использоваться для задания ре- 
гиона другого окна функцией Зе \Ут4омКреп. 

Возвращаемое функцией Се \Утдо\Вет значение определяет тип региона: 


МОБЕКВЕСТОМ Пустой регион 
ЭМРГЕКЕСТОМ Регион в виде простого прямоугольника 


СОМРГЕХКВЕСТОМ |Более сложный регион, заданный ранее окну функцией 
Зе“ тао“Веп 


ЕВКВОЕВ Ошибка (ошибочный регион) 


се\/Лпао\м/Тех{ — копирует текст окна в указанный буфер | 639 


Се \УЛт4омТех{ — копирует текст окна в указанный буфер 


Функция АР \У/!19о\з, копирует текст, связанный с указанным окном, 
в указанный буфер | 


Заголовочный файл И’лизег.й 


Синтаксис 


#1пс1аАе <м1разег. [> 

106 Сеес\1паомТехе ( 

НИМО В\Ипа, /И/ дескриптор окна, содержащего текст 
ЬРТЗТВ 1р5&г1па, // буфер | 

1пЕ пМахСойпе // максимальное число символов 
); 

Описание 

Функция АР] У1пдомз Се \УтдомТех{ё копирует текст, связанный с ука- 
занным окном или оконным элементом в указанный буфер указанного разме- 
ра. Параметр В\У/п4 — дескриптор окна. Параметр 1рЭи` те указывает на бу- 
фер, в который копируется текст. Параметр пМахСоипё определяет макси- 
мальное число копируемых символов. Если число символов в тексте превыша- 
ет эту величину, текст усекается. 

При успешном завершении функция заносит в буфер текст и возвращает 
число занесенных символов, не учитывая завершающего нулевого символа. 
Под текстом окна подразумевается или текст заголовка для окон форм, или 
текст окна редактирования, или имя панели ит.п. Если окно не имеет текста, 
или текст пустой, или указан ошибочный дескриптор, функция возвращает 
нуль. 

Перед использованием функции де У шт4омТехё можно вызвать функцию 
Сег\т4омТех ТГепй И, которая в случае успешного выполнения возвращает 
число символов текста. Это число можно использовать для выделения буфера 
достаточного размера перед вызовом функции де \У/т@4омТехё. 

Функция Се \У/т9домТех& иногда не дает ожидаемого вами результата, по- 
скольку для некоторых окон редактирования (например, для Мето, а иногда 
и для ЕЦ) понятия текст окна и действительное содержимое окна могут раз- 
личаться. Поэтому, если вам требуется получить именно содержимое окна, то 
лучше использовать сообщение У/тдомз \УМ_СЕТТЕХТ 

Если функция выполнилась успешно, она возвращает число скопирован- 
ных символов, исключая завершающий нулевой символ. Если окно не имеет 
полосы заголовка или текст заголовка отсутствует, или при неверном дескрип- 
торе возвращается нуль. Развернутую информацию об ошибке можно полу- 
чить вызовом функции Се Га$Еггог 

Примеры применения функции вы найдете в разд. 5.1.1, 5.1.2, 5.1.3, 5.1.4 


Се \Ут4омТех{Геп2{В — возвращает длину текста окна 
Возвращает длину текста, связанного с указанным окном 
Заголовочный файл И’пизег.й 


Синтаксис 
#1пс1оае <илпозег. В > 
11 ИМТМАРТ Себ\м1паомТехеЬепаев (ТМ НИМО Бира); 


Описание 
Функция АРТ УИшаомз Се \Мт9домТех епо& В возвращает в случае ус- - 
пешного выполнения число символов текста, которое можно использовать для 
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выделения буфера достаточного размера перед вызовом функции @еёУт- 
Чо\Тех{. Впрочем, иногда при смешении в тексте символов АМ! и Опсо4е 
возвращаемое значение может быть завышено. Более точно определить длину 
текста можно сообщениями \ММ_СЕТТЕХТ, Г.В_СЕТТЕХТ, СВ_СЕТТЕВТЕХТ, 
или функцией Се \т4о\мТех&. 

Примеры применения функции вы найдете в разд. 5.1.1. 


Се \УогкшеО1тгесогу — метод интерфейса ГЭЗвеТлюК 
См. функцию бе Аггитеп{$. 


Соб АЧ4А ют — добавляет в глобальную таблицу строку с именем атома 
См. функцию АдаАфюот. 


СТоБъаХеае{еАфот — удаляет из глобальной таблицы атом 
См. функцию АЧаАфот. " 


СТоБа! ЕЯ Афот — осуществляет поиск атома в глобальной таблице 
См. функцию АдЧАющ. | 


Софа Се АфотМаще — заносит в буфер строку, связанную с атомом 
из глобальной таблицы 


См. функцию АдаАюощ. 


С1оба1 Метогу$ {а 1$ — получение сведений о ресурсах памяти и ее те- 
кущем состоянии 


Получение сведений о ресурсах памяти и ее текущем состоянии. 
Заголовочный файл И/тфазе.й 


Синтаксис 


суре4еЕ зегисЕ _МЕМОВУЗТАТОЗ { 
РИОКО амЪепа®В; 
РИОВР АмМепогуГоаа; 
512Е_Т амТофа1Рпуз; 
ЗТ2Е_Т амАуа11РПуз; 
512Е Т амТова1РадеЕ11е; 
512Е_Т АмАуа11РадеЕ11е; 
512Е Т ачТофа1\У1гЕца1; 
51Т2Е_Т амАуа11\У1г&иа1; 

} МЕМОВУЗТАТО$, *ЬРМЕМОВУЗТАТОЗ; 


УОТР С1оБа1Метогуб$абаз (ТМ ООТ 1РМЕМОВУЗТАТО$ 1рВаЕЕег); 


Описание 

Сведения о ресурсах памяти и ее текущем состоянии можно получить с по- 
мощью функции С1оба1Метогу{фафиз. Единственный параметр функции яв- 
ляется указателем на структуру типа МЕМОВУЗТАТО$ (ТМетогу$аби5). 

Поля этой структуры обозначают следующее: 


Размер структуры. Это поле должно быть заполнено до вы- 


зова функции Софа] Метогу {фафи$. 
Процент занятой в данный момент памяти (от 0 до 100). 


4мГепо& В 


4\МетогуГ.оа@ 


На$Рогта{ — определяет зарегистрирован ли если формат 641 


|а*’Тофа1Рвуз Объем физической памяти в байтах. 
4\АутаПРВу$ Свободный в настоящее время объем физической памяти 
в байтах. 


`а\ТоРавегНе Объем в байтах файла подкачки. | 


4\АуаПРагеЕЦе |Свободный в настоящее время объем файла подкачки. 


4\ТофаГУ1{аа1 —|Объем в байтах текущего адресного пространства. 


4\АуаПУ1г(иа1! |Свобоный объем в байтах текущего адресного пространства. 


Пример применения функции приведен в разд. 2.1.3. 


НазРогтаф — определяет зарегистрирован ли если формат 
См. функцию СИрЬоаг@4. 


НазОуеарре д ТоСотр] ее — производит опрос завершения 
асинхронной операции чтения или записи 


Макрос, осуществляющий опрос завершения асинхронной операции чте- 
ния или записи 
Заголовочный файл штфазе.й 


Синтаксис 


#Тпс1аае <м1пБазе.в> 
ВОО НазОуег1арреЧЯТоСопр1екеа (.РОУЕКГАРРЕР 1рОуег1]арреа); 


Описание 

Макрос НазОуеарредТоСотр! ее осуществляющий быстрый опрос за- 
вершения асинхронной операции чтения или записи, начатой функциями 
Веа4ЕПе или УтгцеЕПе (см. разд. 6.7.1). Проверяется операция, использую- 
щая структуру ТОуеарред, на которую указывает параметр 1рОуеарре4. 
Макрос возвращает фгие, если операция завершена. 

Реализован этот макрос следующим образом: 


#АеЕ1лпе НазО\уег1арредТоСотр1е+еа (1рОуег1арреа) 
((1рОуег1арреа) ->Тпеегпа1 != ЭТАТО$ РЕМОТМС) 


Более детальную информацию о ходе выполнения асинхронной перации 
можно поучить функцией Се Оуеарре4Вези{. 


ТЕМ ит 0156 — интерфейс 
См. функцию 5НСе ЮОезКюрЕо1@ег. 


п АютТаМ]е — задает размер локальной таблицы атомов 
См. функцию А94Афот. 


т5егМепиЦет — вставляет раздел в указанную позицию меню 
Вставляет раздел в указанную позицию меню 
Заголовочный файл Утпизег.В 
Синтаксис 


+АеЕ1пе ТрпзегЕМепоТееш ТрзегЕМепоТвепА 
#АЧеЁЕ1зтпе Тпзег&МепоаТеем Тпзег&МепаТ$кепй 
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ИТМОЗЕВАРТ ВООТ ИТМАРТ Тпзег&МепиТеемА (ТМ НМЕМО БМепа, 
ТМ ОТМТ отЕем, ТМ ВОО ЕВуРо$1Етоп, 
ТМ ГРСМЕМОТТЕМТМЕОА 1рм11); 


ИТМОЗЕВАРТ ВООГШ ИТМАРТ ТпзегЕМепоТеепйи (ТМ НМЕМО ЮМепыц, 
ТМ ОТМТ оГеЕем, ТМ ВООБГ ЕВуРоз1Етоп, 
ТМ .РСМЕМОТТЕМТМЕРОМ 1рш11); 


Описание 

Функция шзег{МепиЦет вставляет раздел в указанную позицию любого 
меню, в том числе системного. Параметр ВМепи является дескриптором меню. 
Параметр иЦет определяет раздел меню. Его смысл зависит от значения пара- 
метра {ВуРоз1оп. Если ЁВуРо$1оп = фгие, то иЦет — это индекс раздела 
(индекс первого раздела — 0). Если же {ВуРоз11оп = #а!5е, то аЦет — это 
идентификатор раздела, т.е. идентификатор связанного с ним сообщения. На- 
пример, если первый раздел меню (индекс 0) связан с введенным вами сообще- 
нием 5С МуЦет, то при вызове функции можно задать иЦет = 0 
и {ВуРо$11оп = фгие, или иЦет = 5С_МуЦет и {ВуРоз1 оп = Ёа[5е. 

Параметр 1рши является структурой типа ТМепаЦешип?о (см. ее описа- 
ние в данной главе), задающей набор характеристик раздела. 

Функция возвращает ненулевое значение при успешном выполнении и 0 
в случае ошибки. В этом случае подробную информацию об ошибке можно по- 
лучить с помощью функции Се Га$Еггог. 


шпуег( Вес — осуществляет операцию НЕ с пикселами 
См. функцию ЕШВес%. 


КеуБ4_еуеп{ — эмуляция нажатия клавиши 
Создает эффект нажатия клавиши 
Заголовочный файл И’тпизег.й 


Синтаксис 


УОТр кеуьЧ е\хепь (тм ВУТЕ БУК, ТМ ВУТЕ Бб5сап, 
ТМ РИОВО амЕ1ач$, ТМ ЧЪОМС_РТВ амЕхегаТптЕо); 


Описание 

Эмуляция нажатия клавиши может быть выполнена функцией 
Кеуб4_еуепф. Ее первый аргумент БУЕ задает виртуальный код клавипти. Вто- 
рой аргумент определяет так называемый зсап-код, которы обычно не имеет 
смысла использовать в приложениях. Третий аргумент 9мЕ1ая$ определяет 
действие: если он 0 — эмулируется нажатие клавиши, если его значение равно 
КЕУЕУЕМТЕ_ КЕХОР (в \У/!п4о\мз этой константе задается значение 2) — эму- 
лируется отпускание. Четвертый аргумент содержит развернутую информа- 
цию о клавише.Для эмуляции работы с клавишами второй и четвертый аргу- 
менты можно всегда задавать равными 0. 

Особенностью функции Кеуб4_еуеп{ является то, что она эмулирует опе- 
рации с клавишами для окна любого приложения, которое в данный момент 
активно, т.е. воспринимает сигналы клавиатуры. Это открывает возможности 
для управления из вашего приложения другим приложением. Вы можете, 
эмулируя операции с клавишами, выполнять любые доступные в этом прило- 
жении команды, а результаты выполнения этих команд можете переносить че- 
рез буфер обмена в свое приложение. 

Примеры применения функции вы найдете в разд. 2.3.1, 2.3.3. 


ИпеТо, МоуеТоЕх — рисуют на контексте прямую линию 643 


ТлпеТо, МоуеТоЕх — рисуют на контексте прямую линию 
Рисуют на контексте устройства прямую линию и перемещают перо 
Заголовочные файлы и1п541.й, илтаоиз.й 


Синтаксис 


#10с1аае <и1паом$.В> 
ИТМСРТАРТ ВООТ ИТМАРТ МоуеТоЕх (ТМ НОС Вас, ТМ 1106 Х, 
ТМ 1пЕ У, ОЧТ ТГРРОТМТ 1рРо1п®); 


ИТМСОТАРТ ВООЁ МТМАРТ ГлпеТо (ТМ НОС Вас, ТМ 116 Х, ТМ 106 У); 


Описание 

Функции используются при рисовании на контексте устройства (см. 
разд. 5.5.1). Параметр В4е — дескриптор контекста. Функция МоуеТоЕх пере- 
мещает перо, без рисования линии из текущей позиции в точку, указанную 
параметрами Х и У. Параметр рРо1шё может быть заданным равным МОГ, 
или может указывать на структуру типа РОТМ\Т. В этом случае в структуру за- 
носится точка, в которой находилось перо до вызова этой функции. 

Функция ШпеТо проводит прямую линию из текущей позиции пера в точ- 
ку, указанную параметрами Х и У. Линия рисуется текущим пером. Перо пе- 
ремещается в конечную точку линии. 

Функции возвращают ненулевое значение в случае успешного выполнения 
и 0 вслучае ошибки. Тогда информацию об ошибке можно получить функцией 
Се Га$(Еггог. 

См. примеры в разд. 5.5.1, 5.5.3, а также в описании функции Агс. 


Гоа9ЧСигзог — загружает курсор из ресурса - 
Загружает курсор из ресурса исполняемого файла 
Заголовочный файл ишпизег.й 


Синтаксис 
НСОВ$ОВ ГоаЧСиагзог (НТМ5ТАМСЕ ПТпзвкапсе, ГРСТЗТВ ]рСоагзогМаме); 


Описание 

Функция загружает курсор, имеющийся в ресурсе файла .ехе, и возвраща- 
ет его дескриптор. Параметр Вш$апсе указывает дескриптор того приложе- 
‘ния, из ресурсов которого извлекается курсор. Если это то приложение, из ко- 
торого вызывается функция, значение этого параметра следует задать равным 
_НШ$апее. Параметр 1рСигзогМаше указывает имя курсора в ресурсе. Оно пи- 
шется обязательно заглавными буквами. 

Функция Гоа9Согзог загружает курсор, если он не был ранее загружен. 
Если же курсор уже загружен, функция просто возвращает его дескриптор. 
Загружаемый курсор может быть цветным или черно-белым изображением 
типа ВГТМАР. Если объект с указанным именем в ресурсах не найден, функ- 
ция возвращает МОТ... Если объект найден, но он не является курсором, то ре- 
зультат не равен МОТГ, но его невозможно использовать как дескриптор кур- 
сора. 

Параметр 1рСигзогМате может задаваться не именем курсора в ресурсе, 
а состоять из идентификатора ресурса, заносимого в младшее слово парамет- 
ра. В этом случае старитее слово должно быть равно нулю. Формирование па- 


раметра в такой форме может осуществляться макросом МАКЕЫЛМТВЕ- 
ЗОЧКВСЕ. 
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Функция Гоа4Сигзог может также извлекать системные курсоры. Для 
этого аргумент Шпзфапее надо задать равным МОШ,, а в качестве аргумента 
1рСигзогМаше указать одну из предопределенных в файле ифпизег.В строко- 
вых констант: 


О = ООО ОИ —_ 
ОС {СОМ (устарело), | К 

ЮС АВОМ о 

2С_СВО$$ о 
сви 
10С_1ВЕАМ | 
И ИИ 
| 12С_ЯМЕМЕ$М/ | 
10С_$РЕМ$. ООО 5 и 
ИИ 
| 2С_УМЕММ/$Е > 
о ——ИБыыы—ы——к—м—юымыы— 
1ОС_ЭРЕМУЕ В | 
Е и ум 
[2С_УРАВВОМ/ & 
Грезит и 
я —ШЩ 
| 2С_МО 


12С_АРРУТАЕПМС 


СЕ овен — 


Включение в ресурс курсора рассмотрено в разд. 4.1.2, а использование 
курсора из ресурса в приложении показано в разд. 4.1.4 и 5.2.2.3. 

Возвращенный функцией Гоа@Согзог дескриптор курсора можно исполь- 
зовать для занесения в свойство Сигзог$[ Т ] объекта Эесгееп. Пусть, например, 
вы создали свой курсор и включили его в ресурс приложения под именем 
МЕ\СОКЪЗОВК. Тогда в своем приложении вы можете ввести глобальную кон- 
станту, обозначающую ваш курсор. Например: 


соп5Е суМуСигзог = 1; 
Тогда следующий оператор зарегистрирует ваш курсор в свойстве Сигзогз: 
б$сгееп->Сигзог$ [сгМуСигзог] = ГоаАСигзохг (НТпзфапсе, "МЕЙСОВ$ОВ"); 


А следующий оператор задает в качестве курсора, зарегистрированного 
вами с индексом сгМуСигзог, курсор “песочные часы”. 


5сгеел->Сигзог$ [сгМуСигзок] = БоааСагзог (МОЪГ, ТОС МАТТ); 


ГоааСигзогЕготЕРЙе — загружает курсор из файла 645 


В нужный момент вы можете установить курсор, зарегистрированный о 
вами с индексом сгМуСигзог, в качестве глобального оператором 


осгееп->Сигзог = сгМуСаг$ог; 


В качестве примеров использования макроса МАКЕГМТВЕЗОСВСЕ мож- 
но привести объявления в файле штизег.й описанных выше констант. Напри- 
мер: 

#$АеЕ1пе ТРОС $Т2ЕМЗ МАКЕТМТВЕЗОЧВСЕ (32645) 


Гоа9СигзогЕготЕПе — загружает курсор из файла 
Загружает курсор из указанного файла 
Заголовочный файл И/пизег.й 


Синтаксис 
НСОВ$ЗОК ГоаЯСагзогЕгомЕР11е (.РСТЗТВ 1рЕ11еМапе); 


Описание 

Функция ГоааСогзогЕготЕПе позволяет загрузить курсор из указанного 
файла. Аргумент 1рЕЦеМате определяет имя файла. Это может быть файл 
‚сиг, содержащий данные статического курсора, или файл ‚ат, содержащий 
анимированный курсор. 

Параметр 1рЕ|1еМате может задавать не имя файла, а идентификатор сис- 
темного курсора. Этот идентификатор должен лежать в младшем слове 
1рЕПеМате, а старшее слово в этом случае должно быть нулевым. Формирова- 
ние параметра в такой форме может осуществляться макросом МАКЕТМТВЕ- 
ЗОПБВСЕ. В АРТ \У/114о\з объявлен ряд таких системных идентификаторов, 
начинающихся с символов «ОСВ_». Например, ОСВ,_ МОВМАГ.. Но в С++Ви!- 
4ег эти идентификаторы объвлены не для всех видов приложений. Так что не 
будем на них останавливаться. Для системных курсоров проще использовать 
переменные, рассмотренные в разд. 2.4.5, или фунцкию Гоа@Сиогзог. 

Функция Гоа@Сиг5огЕгот Ее возвращает дескриптор загруженного кур- 
сора, или МОШ,, если указанный файл не найден. Возвращенный функцией 
дескриптор курсора можно использовать для занесения в свойство Сигзог$[ Т ] 
объекта Эсгееп. 

Файлы курсоров, поставляемые с \У/шдо\мз, рзмещаются обычно в подка- 
талоге Сигзог$ каталога \ш4о\з. Так что следующий код позволяет посмот- 
реть любой выбранный пользователем файл курсора, статического или аними- 
рованного: 


соп5Е сЕМуСигзог = 100; 


сраг АРсраг [МАХ РАТН]; 
Сее\1п4ом$01гес®огу (АРспаг, МАХ _РАТН); 
Орепр1а1о91->1п1%1а101г = (Апз15Ег1па)АРсВак + "\\Сагзогз"; 
Ореп01а1о31->ЁЕ11$ег = "Анимированные курсоры|“.ап1|Все файлы|*.*"; 
1Е (Ореп)1а1о0о91->Ехесоафе ()) 

{ 

Зсгееп->Сигзог$ [схМуСагзог] = 

ТоааСагзогЕгомЕ11е (Ореп01а1031->Е11еМаме.с_зЕг()); 

Зсгееп->Сигзог = (ТСиагзог) схМуСаг$ог; 


} 
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Гоа4Тсоп — загружает пиктограмму 
Загружает пиктограмму из ресурса файла 
Заголовочный файл И’/пизег.й 


Синтаксис 
НТСОМ ГоааТсоп (ТМ НТМУТАМСЕ ЮТпзфапсе, ТМ ПГРСЗТК 1рТсопМапме); 


Описание 

Получить стандартные системные пиктограммы, используемые в различ- 
ных окнах сообщений, можно функцией ГоаШсоп. Функция может загру- 
жать пикограмму из ресурса файла, дескриптор которого указан параметром 
п$фапсе. Но таких функций немало. Функция Гоа [соп интересна тем, что 
позволяет также получать дескрипторы системных пиктограмм. Для этого 
параметр №п$фапсе надо задать равным 0, а параметр ШМеопМаше сформиро- 
вать из идентификатора системной пиктограммы. Формируется параметр 
]рТеопМаше с помощью макроса МАК.ЕТМТВКЕЗООВСЕ, в который передается 
одна из следующих констант: ШФТ_АРРЫСАТОМ, ШТ_АЗТЕВЗК, ШГ 
ЕХСГАМАТТОМ, ШТ НАМ, ГОТ ООЕЗТТОМ, ШТ МТМГООО. 

Если вам надо получить одну из этих пиктограмм, достаточно выполнить 
код вида: | 

НТСОМ Тсоп ; 


Тсоп = ГоааТсоп (0, МАКЕТМТВЕ$ОЧВСЕ (ТРТ_АРРЬТСАТТОМ)); 


ГоаЧКеуБоагЧТауоц{ — задает раскладку клавиатуры 
Производит установку языка ввода символов 
`Заголовочный файл И’тизег.й 


Синтаксис 
НКТ ГоаЯКеуроагЯГауоц* (ТМ .РСЗТВ риз2КЬтТр, ТМ ОТМТ`Е1аа$); 


Описание 

Для установки языка ввода символов (русский, английский и т.п.) служит 
функция Гоа9КеуБоагаГ.ауоц{. Параметр р\уз72КТЛО указывает раскладку 
клавиатуры, соответствующую тому или иному языку. А параметр Е1а5$ со- 
держит флаги, определяющие, как именно должна загружаться указанная 
раскладка. Для нашей задачи представляет интерес флаг КГЕ_АСТТУАТЕ, 
активизирующий указанную раскладку. Остальные флаги относятся к дета- 
лям организации смены раскладки в У/1т4о\5$, и вы можете их посмотреть во 
встроенной справке. 

Раскладка в параметре рм\$7КТ.О задается в виде строки, содержащей код 
языка и код диалекта этого языка. Английский язык соответствует коду 
"00000409", русский — коду «00000419». 

Таким образом, оператор 


ТоаЯКеуроакгаТауоч® ("00000419",КЪЕ_АСТТУАТЕ); 


устанавливает русский язык, а оператор 


ТоаЯКеуроагаТауоц® ("00000409", КЕ АСТТУАТЕ); 


устанавливает английский язык. 
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ГоаЧТаЬгагу — загружает указанный модуль 


Загружает указанный исполняемый модуль в адресное пространство вы- 
звавшего процесса 


Заголовочный файл итфазе.й 


Синтаксис 


#Тпс]1пае <и1пБазе.й> 
НМОРОЪЕ МТМАРТ Гоаар1Ьгагу (ТМ ГРСЗТВ 1рЬ1рЕ1т1еМапе); 


Описание | 
Функция ГоааГ6гагу загружает файл или исполняемый модуль, на имя 
которого ссылается параметр 1рГЛЬЕПеМаште, в адресное пространство вызвав- 
шего процесса. Если имя указано без пути, то соответствующий файл ищется 
в каталоге, из которого запущено приложение, в текущем каталоге, в систем- 
ных каталогах У/п4о\з, в каталогах, указанных в переменной окружения 
РАТН. Если файл не найден, функция возвращает нуль. Если файл найден, то 
` проверяется, не загружен ли он ранее. При проверке имен загруженных моду- 
лей регистр символов не учитывается. Если модуль с указанным именем не за- 
гружен, то производится его загрузка. Если он уже загружен, то увеличивает- 
ся на 1 число ссылок на него. В обоих случаях функция ГоаАГгагу возвра- 
щает дескриптор загруженного модуля. Возвращенный дескриптор может да- 
лее использоваться в вызове функции СеРгосА@44ге$$ при динамическом свя- 
зывании ОШ,. Он может также использоваться в вызовах функций 
ЕтВезоцигсе и ГоааВезоигсе. 
По окончании работы с РЫ, ее надо выгрузить из адресного пространства 
процесса функцией ЕгееТ.гагу. 
Примеры применения фунцкии см. в разд. 1.4, 4.2.4, 4.2.5, 4.2.6, 4.4.1. 


ГоокирРиуПереУаше — получение ГОТ) привилегии 
См. функцию ЕхЦ\У/шдомзЕх. 


МАКЕПУТВЕЗООВСЕ — формирует ссылку на ресурс 
Макрос, формирующий ссылку на ресурс 
Заголовочный файл И’п4ошз.Йрр, илтизег.й 


Синтаксис 


ЪРТЗТВ МАКЕТМТВЕЗООВСЕ (МОКР мТпфедет); 
+аеЁ1пе МАКЕТМТВЕЗОЧВСЕМ (1) (ТРИЗТВ) ((ОЪОМС_Р7В) ((МОВЬ) (1))) 


Описание 

Макрос МАКЫМТКЕЗООВСЕ преобразует целое значение мП\щебег 
в ссылку на ресурс, который может использоваться в \/1132 функциями, рабо- 
тающими с ресурсами, например, функцией Гоа4Сигзог. Эта ссылка содержит 
в младшем слове значение \“Пцедег, а старитее слово равно нулю. 
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МАХ_РАТН — максимальная длина пути 
Максимальная длина пути 
Заголовочный файл штае].й, ззаАпПЬ.й, таршлт.В 


Синтаксис 


#фаеЁЕ1пе МАХ РАТН 260 
#$аеЕ1пе _МАХ_ РАТН 260 // для функций М$С 


Описание 

Константа МАХ_РАТН (_МАХ_РАТН) характеризует максимальное чис- 
ло символов в описании пути к файлу или папке. Ее имеет смысл использовать 
при задании буфера, который должен воспринимать имя файла или папки. 
Например: 

ГРЗТВ 1рВаЕ = пем спаг [МАХ РАТН]; 

сраг РаЕ[_МАХ РАТН]; 


МЕМОКУЗТАТОЬ — структура для получения сведений о ресурсах 
памяти 


См. Функцию С1оБа Метогу $афи$. 


МЕМОТТЕМИМЕО, ТМепоЦет по — тип структур, используемый для 
информации о разделах меню 


Тицы структур (записей), используемые в АР! \У/1п14о0\з для информации 
о разделах меню 


Заголовочные файлы штизег.й, илт4ошз.йрр 


Синтаксис 


суреаеЕ садМЕМОТТЕМТМРОА ТМепоТ®еепТпЕо; 
суреаеЕ МЕМОТТЕМТМРГОА МЕМОТТЕМТМЕО; 
суредеЕ ТРМЕМОТТЕМТМЕОА ГРМЕМОТТЕМТМЕО; 
суреаеЕ МЕМОТТЕМТМЕРОЙ МЕМОТТЕМТМЕО; 
фуреаеЕ ГРМЕМОТТЕМТМЕОЙ ТГРМЕМОТТЕМТМЕО; 


фуре4еЕ зегосЕ кадМЕМОТТЕМТМЕОА 
{ 


ОТМТ сЬ517е; 
ОТМТ ЕМазк; 
ОТМТ ЕТуре; 
ОТМТ ЕЗсафе; 
ОТМТ \ТО; 


НМЕМО В5абМепи; 
НВТТМАР ВБпрСтескеа; 
НВТТМАР ПпБтрОпсрескеа; 
ОЪОМС_ РТВ амТфепрафа; 
ТРОТК. АмТурерака; 
ОТМТ . ссь; 
НВТТМАР ПЮпрТфеп; 
} МЕМОТТЕМТМЕГОА, РАВ *ЬРМЕМОТТЕМТМЕОА; 


суредеЕ зегасеЕ садМЕМОТТЕМТМЕОЙ 
{ 


ОТМТ сЬ517е; 
ОТМТ ЕМазк; 
ОТМТ ЕТуре; 
ОТМТ ЕЗбафе; 


ОТМТ ТО; 
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НМЕМО р5а6Мепи; 
НВТТМАР |БЬпрСВескеа; 
НВТТМАР ЮопрОпсрВескеа; 
ОТОМС_РТВ амТ{етрафа; 
.РИЗТКВ ЧмТурерафа; 
ОТМТ ССВ; | 
НВТТМАР ПрпрГфеп; 
} МЕМОТТЕМТМРОЙ, РАК *ГРМЕМОТТЕМТМЕОЙ; 


Описание 

Данные структуры используются в таких функциях АРТ \У/т94о\з, как 
Се МепиЦет Шо, шзег(МепоЦет, Зе МепаЦет шо для описания разделов 
меню. 


Поля записей обозначают следующее: 


с Размер записи в байтах. Может задаваться функцией $12еоР, 


но ее следует применять после того, как заполнены все поля 


записи. 
ГГуре Флаги, определяющие тип раздела меню. Используется, если 


в ЕМа$Е задан флаг МИМ_ ТУРЕ. 


| Текущее состояние раздела меню. Используется, если 
в МазК задан флаг МИМ_$ЗТАТЕ. 


“Ш Индекс раздела меню. Используется, если в {МазК задан 


| 
Маз Флаги, указывающие, какие поля записи используются. 
| 


флаг МИПМ_ №. 

В5и6Мепи Дескриптор выпадающего меню (подменю), связанного с дан- 
ным разделом. Если подменю нет — 0. Используется, если 
в МазК задан флаг МИМ_$ЗОВМЕМО. 

ВБпрСВесКеа Дескриптор изображения индикатора, отображаемого, если 


раздел выбран. Если значение = 0, используется изображе- 
ние по умолчанию — галочка или, если в поле РГуре задан 
флаг МЕТ КАРЮОСНЕСК, — радиокнопка. Поле использует- 
ся, если в ЁМазК задан флаг МИМ_СНЕСКМАВК$. 


ВБ трОпевесКед | Дескриптор изображения индикатора, отображаемого, если 
раздел не выбран. Если значение = 0, изображения нет. Поле 
используется, если в ЁМазК задан флаг МИМ_СНЕСК- 
МАВК$. 


Ч\ЦетОафа Определяемое приложением значение, связанное с данным 
разделом. Используется, если в ЁМа$К задан флаг МИМ_ЭА- 
ТА. 


4\Туредафа Отображаемое обозначение раздела, зависящее от типа разде- 

ла: МЕТ ЫТМАР, МЕТ _5ЕРАКАТОВ или МЕТ_ЭТЕМС. 

При флаге МЕТ_ЭТЕ1МС — строка. Используется, если 
в МазК задан флаг МИМ_ТУРЕ. 


Длина текста раздела меню, если тип раздела МЕТ_ЗТЕВМОС, 
и 0 для других типов. Используется, если в ЁМа$К задан 
флаг МИМ_ ТУРЕ. Игнорируется при задании контекста раз- 
дела. 


ВБ трЦет Дескриптор изображения при заданном флаге МИМ_ВТТМАР. 
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Как видно из приведенной таблицы, использование болыпинства полей за- 
писи определяется флагами, задаваемыми в поле #{Ма$К. Эти флаги могут объ- 
единяться операцией ИЛИ. Предусмотрены следующие флаги: 


спользовать поля я ВыпрСвеске4 и и ВышрОпевескед, 


| миИм _СНЕСКМАВК$ 
т.е. раздел меню может изображаться выделенным 


| 


| 
| 
| 
О лес о 


'МИм РАТ, РАТА ОЙ _| Использовать. ‘поле @ дуЦешрайа. ОНИ 
МПМ ПИ Использовать. поле м0. 
'МИМ_5ТАТЕ Использовать поле #$14е. _ 

‚ МИМ 1М_ЗОВМЕМО — _ Использовать поле В5и6Мепи. о 
МИМ ТУРЕ — Использовать поля ЁТуре и 4иТуребаа._ 


Отображение меню определяется значением поля ЁТуре. Это значение мо- 
жет включать следующие флаги типов: 


МЕТ _ ВТТМАР В разделе меню отображается изображение, на кото- 
‚рый указывает дескриптор, заданный в поле дмТу- 
| редафа. Поле ссВ игнорируется. 


‚ полосы меню или на новый столбец для подменю. 


МЕТ _МЕМОВАВВВЕАК.  Размещает в разделе переход на новую строку для 
| В последнем случае новый столбец отделяется разде- 


[__ о И | лителем в виде. вертикальной четы. 
МЕТ _МЕМОВВЕАК _ ' То же, что МЕТ_МЕМОВАВВВЕАК, но без раздели- 
о . __ теля. в виде вертикальной четы. ____ 
МЕТ _О\УМЕВОВАМ Заказное рисование раздела меню. Для этого может 


использоваться сообщение \ММ_МЕАЗОВШТЕМ, 

| ° поступающее перед первой прорисовкой, и сообще- 
| 

| 


ние \М_ ОВАУТТЕМ, поступающее при каждом об- 
новлении изображения. Если задан данный флаг, 

используется определяемое пользователем значение 
| __ | ЧуТуредаа. _ 


МЕТ КАО,ОТОСНЕСК Элемент меню будет выделяться изображением ра- 
| диокнопки, а не галочки, если в поле ВЪшрСВесКе4 
задан. 0. 


| 
| —_ ОНИ 


| МЕТ _ вент. ОЗТТЕУ Выравнивание : вправо. Этот флаг может применять- 
ся только к элементам, расположенным в полосе 
| меню. 


| 

т СЕРАВАТОВ_ `Разделитель в в виде горизонтальной черты. Поля 
‚ Чу’Туредаёа и есВ игнорируются. 
| 
| 


МЕТ_ ЗТЕМб ’ | Текстовое отображение раздела. Поле дмТурерава 
указывает на строку текста, а поле сев содержит 


Флаги МЕТ ЫТМАР, МРТ ЗЕРАВАТОВ и МЕТ_5ТЕМС не могут ком- 
бинироваться друг с другом. 


Ме55адеВеер — воспроизводит звуковой сигнал 651 


Текущее состояние раздела меню определяется значением поля #5фафе, ко- 
торое может включать следующие флаги: 


= 


МЕ _СНЕСКЕР Раздел выделен изображением, установленным по- | 
| лем ВьшрСВеске4. | 
| ода ООО 
МЕ$_ОЕРАОТТ Раздел является разделом по умолчанию, выделен- 
ным полужирным шрифтом. | И 1 
МЕ _ОТЗАВГЕР Раздел недоступен, но не отображается серым. __ - 
`МЕЗ_ЕМАВГЕО Раздел доступен (это значение принято по умолча- 
| нию). о __ В _ В 
| МЕ _СКАУЕО Раздел недоступен и отображается серым. _ 
_МЕЗ_НИМТЕ __Разцел выделен цветом. 
| МЕ _ОМСНЕСКЕР Раздел изображается невыделенным, для чего мо- . 
жет использоваться изображение, заданное полем | 
| о | №трОпевеекеа. о — 
МЕЗ_ОМНИЛТЕ Раздел не выделен цветом г (ото з значение принято 
о [по умолчанию). ООО ия | 


МеззахеВеер — воспроизводит звуковой сигнал 
Воспроизводит звуковой сигнал указанного типа 


Синтаксис 
ВОО МТМАРТ МеззадеВеер (ТМ ОТМТ оТуре); 


Описание 

Функция АРТ У ш9до\мз МеззасеВеер воспроизводит заданный звуковой 
сигнал. Звуки, соответствующие различным типам сигналов, хранятся в рее- 
стре в разделе [50упа$]| и устанавливаются пользователем с помощью програм- 
мы «Панель управления» щелчком на пиктограмме Звук. 

Целый без знака параметр иТуре функции Мез5асеВеер определяет вос- 
производимый звук. Для него предопределены следующие константы: 


Значение 
"МВ ЛСОМАЗТЕВЗК Звездочка 
МВ ТСОМЕХСГАМАТТОМ Восклицание ОИ 
МВ_ 1СОМНАМО Критическая ошибка | 
МВ ТСОМОЧЕЗТЮМ Вопрос ООО 
МВ _ок Стандартный звук _ ПИ | _| | 


При успешном завершении функция возвращает ненулевое значение 
(гие). Если функция вернула нулевое значение, то получить информацию об 
ошибке можно с помощью вызова Се Га$&Еггог. 

После инициализации воспроизведения звука функция Мез$захеВеер воз- 
вращает управление в точку вызова, и воспроизведение звука производится 
асинхронно. 
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Если функция МеззагеВеер не нашла указанный тип звука, она пытается 
воспроизвести стандартный звук. Если и он не установлен или если компьютер 
не снабжен звуковой картой, то звук воспроизводится через динамик компью- 
тера. 


МоуеЕ Пе, МоуеЕПеЕх, МоуеЕПе\/ ЦИ Ргосгез$ — перемещают файлы 
и каталоги | 


Перемещают или переименовывают файлы и каталоги 
Заголовочный файл У/’мфазе. В 
Синтаксис 


#1пс1аАе <М1пЬазе. > 
ИТМВАЗЕАРТ ВООГ МТМАРТ МоуеЕ11еА (ТМ ПРСЗТВ 1рЕх15Е1паЕ11еМапе, 
ТМ ЬРСЗТВ 1рМ№емЕ11]еМаме); 
ИТМВАСЕАРТ ВООГ ИТМАРТ МохеЕ11ей ( | 
ТМ ГРСИЗТВ 1рЕх15$61п9Е11еМапе, 
ТМ ГРСИЗТВ 1рМ№емЕ11еМапе); 
#$1ЕаеЕ ЧОМТСОРЕ 
#АеЕ1пе МоуеЕ11е МоуеЕ11ей 
#$е1зе 
#АеЕ1пе МоуеЁг1]1е МоуеЕ11еА 
#епа1Е // !ОМТСОРЕ 


ИТМВАЗЕАРТ ВООТ МТМАРТ МоуеЕ11еЕХА ( 
ТМ ЬРСЗТВ 1рЕх1561паЕ11еМаме, 
ТМ БРСЗТВК ]1рМ№емЕ11еМапте, 
ТМ ОМОВКР АмЕ1ааз$); 

ИТМВАЗЕАРТ ВОО МТМАРТ МоуеЕ11еЕхи ( 
ТМ ГРСИЗТВ 1рЕх15&1п9Е11еМаще, 
ТМ ГРСИЗТВ 1рМ№емЕ11еМапе, 
ТМ ОМОВКО АмЕ1ад$); 

#1ЕАаеЕ ОМТСОПРЕ 

#$АеЁЕ1пе Моуег11еЕх МоуеГг11еЕхи 

#$е1зе 

#АеЁ1пе МоуеЕ11еЕх МоуеЕ11еЕхА 

фепа1Е // !ИМГСОБЕ 


ИТМВАЗЕАРТ ВООЬГ МТМАРТ МоуеЕ1 1е\1+ПРгодгеззА ( 
ТМ .РСЗТВ 1рЕх1$561паЕ11еМапе, 
ТМ ГРСЗТВ 1рМ№емЕ11еМапе, 
ТМ ГРРВОСВЕ$$ КООТТМЕ 1рРгодгеззВоче1пе ОРТТОМАЦ, 
ТМ ГРУОТР 1ррафа ОРТТОМАГ, ТМ ПОМОКБО аАмЕ1ад$); 
ИТМВАЗЕАРТ ВООТ МТМАРТ МоуеЕ11е\1ЕПРгодгеззи1 ( 
ТМ ЪРСИЗТВ 1рЕх15&1паР11еМапе, 
ТМ ГРСИЗТВ 1р№емЕ11еМапте, 
ТМ ГРРКОСВЕ$$ КООТТМЕ 1рРгодгеззВопЕ1пе ОРТТОМАЦ, 
ТМ ГРУОТО 1ррафа ОРТТОМАГ, ТМ РМОВО ЧмЕ1ачз); 
#1ЕаеЕ ОМТСООЕ 
$аеЁ1пе МоуеЕ11е\м1ЕРРгодгез$ МоуеЕ11е\1еВРгодгез И 
#е1зе 
$АеЕ1пе МоуеЕг11е\1ЕПРгодгезз МоуеЕ11ей1ЕПРгоагеззА 
ф$епа1Е // !ОМТСОрОЕ 


Описание 

Функции перемещают или переименовывают файл или каталог, указан- 
ный параметром 1рЕх15ИпеЕЦеМаше, в файл или каталог, указанный пара- 
метром 1рМем“ЕПШеМате. Файл или каталог, указанный параметром 
рМ№е\ЕПеМате, не должен существовать в момент вызова функции. Файл мо- 
жет быть перемещен на другой диск и в другую файловую систему. Каталог 
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может быть перемещен только в пределах того же диска. При перемещении 
каталога перемещаются и все его вложенные подкаталоги. 

При нормальном завершении функции возвращают ненулевое значение. 
Если функция вернула 0 (#а1$е), информацию об ошибке можно получить с по- 
мощью функции Се Таз Еггог. 

Рассмотрим примеры. Следующий оператор переименовывает каталог 
сЛТ в каталог СсАТТ: 

1Е(! МоуеЕ11е( "с:\\Т", "с:\\ТТ")) 

ЗПпомМе$засде (ЗузЕггогМеззаае (СееТаз®Еггог ()))}; 

Функция выполнится успешно, если каталог с:/\Т существует, а каталога 

слЛТТ нет. 


В функции МоуеЕПеЕх имеется дополнительный параметр 4м Е 1а 5$, кото- 
рый может быть комбинацией следующих флагов: 


Если файл должен быть перемещен на другой 
диск, то функция организует перемещение после- 
довательным вызовом функций СоруЕШе и Ваее- 
ЕПе. Это флаг не может комбинироваться с фла- 

гом МОУЕЕП.Е ОЕГАУ_ОМТП, ВЕВООТ. 


Только в \У!ш4омз МТ. Перемещение или пере- 
именование файлов произойдет только после пере- 
загрузки системы. 


МОУЕЕП.Е_ КЕРГАСЕ_ Если файл 1рМемЕПеМаше существует, он будет 

ЕХТЬТИМ а °® | Перезаписан. Таким образом, функция разрешает 
перезаписывать существующие файлы — возмож- 
ность, отсутствующая в функции МоуеЕ Пе. 


| 
р 


| 


`МОУЕРШЕ РЕГАХ_ 
ОМТИ. ВЕВООТ 


| 
| 
| 


Только в \т4омз МТ. Функция не возвращается 
до тех пор, пока перемещение не завершится. 
Флаг игнорируется, если задан флаг МОУЕЕ1- 
ГЕ ОЕГАУХ _ОМТП. ВЕВООТ. 


| МОУЕЕШЕ_ 
| УВГТЕ_ТНЕООСН 


В У шдо%жз МТ, если задан флаг МОУЕЕП.Е ОЕГАУ_ОМТП, ВЕВООТ, 
функция сохраняет данные о файлах, которые должны быть перемещены по- 
сле перезагрузки, в реестре в ключе НКЕУ ГОСАГ МАСНТ1МЕ\ 5УЗТЕМ\ 
СиггепСоптто[5е!\ Соп1тоГ\ Зеззюп Мапазег\ РепатЕ&ЕРИеВепатеОреганНопз. 
Задание этого флага позволяет указать в вызове функции МоуеЕПеЕх пара- 
метр 1рМемЕПеМате равным МОТ. В этом случае после перезагрузки систе- 
мы файл 1рЕх1зИпоЕЦеМате удалится. Эта возможность может использовать- 
ся в различных программах установки приложений. 


Функция МоуеЕ|!е\ Ц Ргоргез$ в дополнение к возможностям, заложен- 
ным в функции МоуеЕ\ЦеЕх, позволяет организовать обработку и отображение 
процесса перемещения. Параметр рРгоргеззВои пе может указывать адрес 
функции РВОСВЕ$З5 _ВКОЧ"И\Е, которая обрабатывает процесс копирования 
и может выдавать пользователю соответствующую информацию. Параметр 
1р)аёа — указатель на произвольные данные, которые могут быть переданы 
в функцию обработки. Эта пользовательская функция и ее использование под- 
робно рассмотрены в описании функции СоруЕПеЕх в разд. «СоруЕШе, 
СоруЕЦеЕх — копируют файл». 
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МоуеЕПеЕх — перемещает или переименовывает файл или каталог 


См. разд. «МоуеЕПе, МоуеЕПеЕх, МоуеЕПе\/иИ®Ргосгезз — перемещают 
файлы и каталоги». 


МоуеЕЦе\ ЦВ Ргорггез$ — перемещает или переименовывает файл 
или каталог 


См. разд. «МоуеЕПе, МоуеЕПеЕх, МоуеЕ!е\\ Ц Ргогезз — перемещают 
файлы и каталоги». 


МоуеТоЕх — перемещает курсор на контексте устройства 
См. функцию СтеТо. 


Моуе\ 11 4о\ — изменяет положение и размер окна 
Изменяет положение и размер окна 
Заголовочный файл И’пизег.й 


Синтаксис 


#11с1аае<И1пизег. | > 

ВООЪ МоуеМ1паом (ТМ НИМО ВБ\па, ТМ 116 Х, ТМ 1106 У, 
ТМ 106 питаЕр, ТМ 10е оНезорвеЕ, 
ТМ ВООЪ ЮВера1п®); 


Описание 

Функция Моуе\М1т4о\ изменяет положение и размер окна, заданного сво- 
им дескриптором В\’п@. Параметры Х, У, п\1Е, п\У1ЧЕЬ определяют соот- 
ветственно координаты левого верхнего угла, длину и ширину окна. Для окна 
верхнего уровня координаты являются координатами экрана. Для дочернего 
окна они измеряются относительно левого верхнего угла родительского окна. 
Параметр БВера1т определяет, перерисовывается ли окно во время перемеще- 
ния: при значении фгие перерисовывается. — 

_ При успешном выполнении функция возвращает ненулевое значение. 

Текущее положение и размер окна`можно получить функцией Се \Ут- 
домВесф. 

См. пример применения функции в разд. 5.1.1. 


МОТТЕУТСОМОАТА — структура 
См. функцию ЭВе|_МойЁУГсоп. 


Обе ВтагуТоТех{, ОетТоСвагВиЁ — переводят информацию 
об объекте | 


Функции переводят информацию об объекте 
Заголовочный файл С1[аз5ез.йрр 


Синтаксис 


+1пс1аае <С1аз5е$.Врр> | 
епом ТбегеамОг191па1ЕГогта® {зоЕО0пКпомп, $оЕВ1пагу, зоЕТехЁ}; 


ехфегп РАСКАСЕ у01а _ Еаз®са11 Об)]ес&В1пагуТоТехе ( 
Тсегеащ* Тпру©, Тэзегеам* Опфра®); 

ехЕегп РАСКАСЕ уо1а __Еаз®са11 Об)ес&В1пагуТоТехе ( 
Т5&геам* ТприЕ, Т5егеам* Ойерае, 
Т5ЕгеамОг1а1па]Гогма®е &Ог1а1па1РГогма*); 
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ехсегп РАСКАСЕ \у01аА __ЕазЕса11 Обю)ес&ТехЕеТоВ1пахку ( 
Т5егеам* Тпрас, Тбегеам* ОпероЕ); 
ехфегп РАСКАСЕ \014А __ЁЕаз®са11 ОБ)]есеТехеЕТоВ1паху ( 
Т5©геам* Тприе, Тбегеам* Опфраое, 
Т5геамОг191па1Гогма® &Ог1а1па1ЕГогма®); 


Описание 

Функция Оее ВтагуТоТех& переводит двоичную информацию об объек- 
те, содержащуюся в потоке Штриф, в текстовой представление, которое зано- 
сится в поток Ошёриф. Функция ОБесТех{ТоВтагу осуществляет обратное 
преобразование текстовой информации в двоичную. Параметр Омета!Рог- 
та, имеющийся во вторых формах обеих функций, указывает, формат ин- 
формации. 

Исходная информация для фунцкии ОБдес ВтагуТоТех{ должна быть за- 
писана в поток риф методом УгцеСотропеп (см. его в данной главе в опи- 
саниях классов ТМетогуэйгеат, ТКезопгсе {геат, ТЕПеф{геат). Функция 
ОБес{ВтагуТоТех позволяет преобразовать эту информацию в текстовое 
описание объекта для записи его в файл или для последующего редактирова- 
ния. А фунцкия ОЩес%& Тех ТоВтагу позволяет перевести текстовое описание 
в двоичное представление, которое может быть использовано при создании на 
этой основе объекта методом Веа4Сотропепф, имеющимся у всех упомянутых 
выше классов потоков. 

См. примеры применения функций в разд. 6.13. 


Оет'.ТоСваг, ОетТоСвагВиЁ — переводят текст М5-0О5 в строку 
Функции переводят текст МБ-РОБ в строку 
Заголовочный файл И’пизег.В 


Синтаксис 


#1пс1иае <зузфем.Врр> 

ВОО ОетТосСВах ( 

.РСТЗТВ 1р$25гс, // исходная строка 

ТРСТВ 1р$20$% // результат перевода 
оо ОемТоСВахВаЕЕ ( 

.РСТЗУТВ 1рз2бгс, // исходная строка 

ТРСТВ 1р$205$%, // результат перевода 

РМОВОР ссПрз&ЪепаЮ // число символов 

); 

Описание 

Функции применяются для перевода строки в формат МБ-ООВ. Это требу- 
ется, в частности, если возникает задача сохранить в файле в формате РОБ 
текст из окна редактирования. Подобный файл далее может читаться прило- 
жениями ООБ. 

Параметр 1р$25ге — указатель на строку, которую надо перекодировать. 
Параметр 1р$205$% — указатель на строку, в которую заносится перекодирован- 
ный текст. Параметр сев 0$ Геп2. в функции ОешТоСвагВоЁ определяет 
число перекодированных символов, которые заносятся в результирующую 
строку. Если это число меньше числа символов в исходной строке, то осталь- 
ные символы не заносятся в результирующую строку. 

Имеются два варианта функций, работающие с кодами АМФ]! и с много- 
байтными кодами Ох. В случае, если работа идет с кодами АМЫТ, адреса ис- 
ходной и результирующей строк могут совпадать, т.е. параметры 1р$25ге 
и 1р$7205$6 могут указывать на одну строку. 
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Функции всегда возвращают ненулевое значение. 

Имеется также функция СвВагТоОеш, которая осуществляет обратное пре- 
образование. 

В следующем примере, текст, загруженный из файла в формате ООВ 
в окно редактирования В1е ЕЗИ1, переводится функцией ОетТоСВаг в фор- 
мат АЗСИ. 


сраг *5 = (сваг *) па11ос ($517еоЕ (К1сЬЕа11->Тех*)); 
ОешТоСраг ( (В1сВЕа1%1->Тех®) .с_56г(), 5); 
В1срЕа1+1->Техе = 5; 

Егее (5); 


Первый оператор отводит память под строку $, необходимую для хране- 
ния в ней текста окна Вас В ЕЯ1. Второй оператор заносит в нее перекодиро- 
ванный текст. Третий оператор возвращает этот текст в окно Вл1евЕЗИ1. По- 
следний оператор освобождает память. 


ОешТоСВагВи!! — переводит текст М5-0О$ в строку 
См. функцию ОешТоСВаг. 


ОрепЕуеп{ — открывает существующий объект события 
Открывает существующий объект события 
Заголовочный файл ИУтизег.й 


Синтаксис 


НАМОТЕ ОрепЕуеп* (ОИОКР амрез1геаяАссез$, ВООЬ БТпВег1®Напа]1е, 
ЪРСТСТВ 1]рМапе); 


Описание 

Открывает существующий объект события (см. разд. 3.5) с именем 1рМате 
и возвращает его дескриптор. Параметр 4мОезге4Ассез$ может принимать 
значение ЕУЕМТ АТ, АССЕЗЗ — полный доступ к объекту, ЕУЕМТ_ МО- 
ОТРУ_ЗТАТЕ — возможность использования объекта в функциях Зе Еуепф 
и ВезеЕуепе, ЗУМСНКОМТ2Е — использование объекта в функциях ожида- 
ния. Параметр пвег{НапШМе определяет, будет ли наследоваться возвращен- 
ный дескриптор дочерними процессами. При значении фгае будет наследоваться. 

Функция ОрепЕуеп{ возвращает дескриптор только в случае, если объект 
события уже был создан каким-то процессом. В противном случае возвращает- 
ся МОШ.. 

Примеры применения функции см. в разд. 3.5. 


ОрепРгосеззТоКеп — получение доступа к привилегиям приложения 
См. функцию Ех Ц У штдомзЕх. 


ОрепЗетарвоге — осуществляет доступ к существующему семафору 
Осуществляет доступ к существующему семафору. 


Синтаксис 


НАМОЪЬЕ Орепбемарпокге (ТМ ПИОВКО амрез1гедАссез$$, 
ТМ ВОО ЬТпрег1Напа1е, 1М ГРСЗТВ 1рМапе); 


Описание 
Функция возвращает дескриптор существующего семафора (см. разд. 3.4) 
с именем Маше. Параметр 4\мОезге4Ассез$ может принимать значение 


Ореп\/айаеТ!те — осуществляет. доступ к существующему таймеру 657 


ЗЕМАРНОКЕ_ АПТ, АССЕЗ5 — полный доступ к объекту, ЗЕМАРНОВЕ _МО- 
ОТРУ ЭТАТЕ — возможность использования объекта в функции 
ВееазеЗетарвВоге, ЗУМСНВОМТЛЕ — использование объекта в функциях 
ожидания. Параметр Бшпег{ Нап Ше определяет, будет ли наследоваться воз- 
вращенный дескриптор дочерними процессами. При значении фгиае будет на- 
следоваться. 

Функция Ореп5етарВоге возвращает дескриптор только в случае, если 
семафор уже был создан каким-то процессом. В противном случае возвращает- 
ся МОГ. 

Примеры применения функции см. в разд. 3.4. 


Ореп\\аЦаМеТипе — осуществляет доступ к существующему таймеру 
Осуществляет доступ к существующему таймеру ожидания 
Заголовочный файл И’/тпизег.й 


Синтаксис 


НАМОТЕ ОрепМа1фар1еТ1те (ТМ РИОВКР амрез1геЯдАссез$, 
ТМ ВООТ БТррег1&Напате, 
ТМ ГРСЗТВ 1рТлмегМаме); 


Описание | 

Функция Ореп\/аЦаШеТ!те возвращает дескриптор существующего тай- 
мера ожидания (см. разд. 3.6) с именем 1рТипегМаше. Параметр ам,ез- 
гедАссез$ может принимать значение ТТМЕВ_АТГ_ АССЕЗЬ — полный дос- 
туп к объекту, ТТМЕК_МОШТЕУ_5ТАТЕ — возможность использования объ- 
екта в функции ВееазеЗетарпоге, ЗУМСНКОМТАЕ — использование объекта 
в функциях ожидания. Параметр ЫМпвегНап Ме определяет, будет ли насле- 
доваться возвращенный дескриптор дочерними процессами. При значении 
фгие будет наследоваться. 

Функция Ореп\аЦаеТипе возвращает дескриптор только в случае, 
если таймер уже был создан каким-то процессом. В противном случае возвра- 
щается МОТ... | 

Примеры применения функции см. в разд. 3.6. 


ОУЕВГАРРЕО, ТОуег1арред — структура, используется при 
асинхронном режиме чтения из устройства и записи в устройство 


Используется при асинхронном режиме чтения из устройства и записи 
в устройство. 


Заголовочный файл ифпфазе.й 


Синтаксис 


#1пс1о.ае<м1пЬразе.Нв> 
суреаеЕ зегисЕ _ОУЕВЬАРРЕР { 
ОТОМС РТВ Тпёегпа1; 
ОТОМС РТВ Тпбегпа1Н191; 
ап1топ { 
ЗЕгасе { 
РИОВО ОЕЕзее; 
РИОВО ОЕЕзефН1ай; 
}; 
РУОТР Ро1пеекг; 
}; 
НАМОТЕ МЕуепЕ; 
} ОУЕВБЪАРРЕО, *ГРОУЕВГАРРЕО; 


658 Глава 8. Справочные данные по функциям и структурам АР! \МММптдо\ми$ 


суре4еЕ _ОУЕВТАРРЕР ТОуег1арреа; 
суре4еЕ _ОУЕВЬАРРЕР *РОуег]арреа; 


Описание 

Структура типа ОУЕВГАРРЕО или ТОуеарре4 используется обычно при 
асинхронном чтении или записи. 

Поля Пцегпа и Пфегпа 18 зарезервированы под использование опера- 
ционной системой. Поле ОЁ5е{ё указывает позицию файла (точнее, ее младшее 
слово), начиная с которой должно происходить чтение или запись. Поле 
ОЁЙзе 1 указывает старшее слово позиции. Позиция задает число байтов от 
начала файла. Поля ОЁ$е и ОЙЁзе Н1еВ (может равняться нулю) должны быть 
заданы до вызова функций чтения и записи ВеадЕЙе и УгцеЕПе. При чтении 
из конвейера или порта поля ОЁ#5е и ОЁ5е Н 11 игнорируются. 

Поле ВЕуеп{ задает дескриптор`объекта события, который будет установ- 
лен в сигнальное состояние при завершении операции чтения или записи. Это 
поле должно быть задано до вызова функций чтения или записи. 

Впрочем, информацию о завершении операции чтения или записи можно 
получить и не через событие, а периодическим опросом макросом 
НазОуег1арредТоСотр! ед. Прервать выполнение операции можно функцией 
СапсеПО. 


Р1е — рисует сектор 
См. функцию СВог4. 


Р1]ауЗопип — воспроизводит звук 


Воспроизводит звук указанного волнового файла, или звук системного со- 
бытия, или звук из ресурс 


Заголовочный файл ттзузет.йрр 


Синтаксис 


#10с10ае <пизузеем.Врр> 


ВООЬ МТМАРТ Р1аубоппа (.РСЗТВ рз25оипа, НМОРОЬЕ Бтоа, 
| РИОВКР Еамбоцпа); 


Описание 

Параметр р$7Зоип4 представляет собой строку с нулевым символом в кон- 
це и определяет воспроизводимый звук. В зависимости от значений флага 
{Аубоипа (5МО_ЕПЕМАМЕ, 5МО_АТГЛА$ или $5МО_КЕЗООВСЕ) параметр 
р525$0ип4 может определять имя ‘волнового файла, псевдоним системного со- 
бытия, или ‘идентификатор ресурса. Если ни один из этих флагов не указан, 
функция ищет в реестре У/т4о\з или в файле Ит.йи указанное имя звука. 
Если звук найден, то он воспроизводится. Если звук не найден, то параметр 
р525о0п@4 интерпретируется как имя файла. 

Если параметр р$7250ип@ задан равным 0, то воспроизведение любого вол- 
нового файла прерывается. Для прерывания воспроизведения звука, не свя- 
занного с волновым файлом, надо указывать ЭМО _РОВСЕ в параметре 
{АуЭЗоипа. 

Параметр Вто используется только при параметре Г{4м3Зоип@ равном 
5Мр_КЕЗООВСЕ. В этом случае В то4 является дескриптором выполняемого 
файла, содержащего ресурс, который должен загружаться. В противном слу- 
чае значение №104 задается равным 0. 


Р1ау$оипа — воспроизводит звук 659 


Параметр #4мЗоип@ задает флаги воспроизведения звука. Флаги могут 
комбинироваться друг с другом операцией ИЛИ (|). Возможны следующие зна- 
чения параметра: 


УБР =” И ```=_—=—°—=—=—=—°—°—_—_———[8 А] 
5МО_АРРЫСАТТОМ Звук воспроизводится с использованием установок при- | 
ложения. | 


и 


о и | 


'5МО_АША$ Параметр р$7$о0ип4 определяет псевдоним системного | 
‚события в реестре У/1т94о\з или в файле Ут.т:. Нельзя 
‹ использовать совместно с 5МО_ЕПЕМАМЕ и 5МО_ВЕ- 


_ЗО0ВСЕ. | 


5МО_ АЦМА$_Т Параметр $72$о0ип4 является предопределенным иденти- 
фикатором звука. 


т и 
5МО_АЗУМС Звук воспроизводится асинхронно и функция Р]ауЗопп@а 
' возвращается немедленно после начала воспроизведения. 
| Чтобы прекратить асинхронное воспроизведение волно- 
‘вого файла, надо вызвать Р1ау5оип@ с параметром 


| ‘рз25оип@, равным 0. 
мы ПД 
5 МО_ЕП.ЕМАМЕ 


а зо Ди 


| $ МО_ТООР Воспроизведение звука постоянно повторяется, пока не 
‚Одновременно надо указать флаг ЗМО_АЗУМС асинх- 

‚ ронного воспроизведения звука. | 

ИИ | )ЪррЪ м 


| $МО_МЕМОКУ Файл звука события загружен в память. В этом случае 
‚ ‚Параметр р523оип@4 должен указывать на образ звука 
‘в памяти. 


| 
5Мр_ МОБЕЕАОТТ ‚Звук события, кроме звука по умолчанию. Если указан- 
‚ный звук не найден, Р]ауЗоип@ вернется, не воспроизво- | 


| 

| 

| 

| 

| 

‘вызовется Р]ауЗоип4 с параметром р$25оип4, равным 0. 
| 

| 

| 

| | ‘дя звук по умолчанию. 


| МО _МОЗТОР Если заданный звук не может быть воспроизведен, по- 


‚скольку ресурсы, необходимые для воспроизведения, за- 
| 
| 
| 


`няты воспроизведением другого звука, функция Р]ауЗо- 
 ип4 немедленно вернет #а1$е, не воспроизводя заданного 
‘звука. Если данный флаг не указан, функция Р1]ауЗоип@а 
‘пытается остановить воспроизведение другого звука, 

‘чтобы устройство могло быть использовано для воспро- 
изведения нового звука. | 


МО _МОМАТ Если драйвер занят, функция сразу вернется без воспро- 
изведения заданного звука. | 
ыы ный 


—_ 


—Ш—— 


‚ Останавливается воспроизведение любых звуков, вы- 
` званных в данной задаче. Если р52боип4 не 0, останав- 
 ливаются все экземпляры указанного звука. Если р$7250- 


$М№МО_РОВСЕ 
| 
‚ ип@ равен 0, то останавливаются все звуки, связанные 
| 
1 


. 


с данной задачей. Отдельно надо указать дескриптор для | 
‚ остановки событий ЗМО_ВЕЗООКВСЕ. 
Я СО ме О 


Параметр р57боип@ является идентификатором ресурса. 
Параметр Вто должен указывать на источник ресурса. 
АИ, ИИ 


'$Мр_КЕЗООВСЕ 


$ МО_5УМС 


`Р1ауЗоип@ возвращается только после окончания вос- 


Синхронное воспроизведение звука события. Функция | 
произведения. | 
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При успешном выполнении функция возвращает ненулевое значение 
((гие). Если указанный звук не находится, функция Р1ауЗоцп@ воспроизводит 
системный звук по умолчанию. Если функция не может найти и его, то вос- 
произведения не будет, а вернется значение 0 (Ёа]зе). 

Звук, указанный параметром р52Зоип@а, должен помещаться в доступную 
память и должен подходить для установленного драйвера устройства воспро- 
изведения волновых файлов. Функция Р1ауЗоип@ ищет файл звука в следую- 
щих каталогах: текущем, каталоге У/шЧо\з, системном каталоге У/1т@4о\з, 
каталогах, перечисленных в переменной среды РАТН, в списке каталогов, пре- 
доставляемых сетью. 


Примеры 
Не забудьте, что для использования функции Р]ауЗоппа в файл должна 
быть включена директива 


#Т0с1аае <питзузеем.Врр> 
Оператор 
Р]1аубоппа ("С ; \\И1паомз\ \Меа1а\\Звук М1сгозоЕ®.мау", 0, 5МО_АЗУМС); 


воспроизводит асинхронно и однократно стандартный звук М1сгозоЁ, который 
вы обычно можете слышать при открытии \У/1т4о\з. В процессе воспроизведе- 
ния продолжается выполнение приложения. 

Оператор 


Р1аубочпа ("С : \\И1паомз\ \Меа1а\\Звук М1сгозоЕе.мау", 0, 
МР _АЗУМС | 5МР_ТГООР); 


многократно асинхронно воспроизводит стандартный звук М1!сгозоЁ, начиная 
его снова и снова, как только он заканчивается. Если вы ввели в свое приложе- 
ние подобный оператор (пусть даже и с очень приятной музыкой), вам надо 
предусмотреть еще и какую-нибудь кнопку, по которой воспроизведение пре- 
рывается заданием нового звука или выполнением оператора 


Р]1ау5оппа (0,0, 5УМР РОВСЕ); 


Чтобы опробовать функцию Р1ауЗопп@, введите в свое приложение диалог 
ОрепП1а]1ох и кнопку со следующим обработчиком щелчка на ней: 


1Е (Орепр1а1оч1->Ехесаее ()) 
Р]1аубоцпа (Орепр1а1091->Е11еМаме.с_5%г(),0,5МР АЗУМС); 


Запустите приложение, выберите файл какой-нибудь приятной музыки 
и работайте со своим приложением, наслаждаясь попутно выбранной мелодией. 
Оператор 


Р]аубоппа ("С :\\ИМ1паомз\ \МеЯ1а\\Звук М1сгозоЕ*.мау", 0, $МР_$5УМС); 


будет воспроизводить звук синхронно. т.е. функция Р1ауЗоипа@ не вернется, 
пока воспроизведение не завершится. На это время ваше приложение будет 
блокировано. Впрочем, ваши действия во время этого вынужденного простоя 
запомнятся системой. И если вы, слушая музыку, щелкнули на той же кнопке 
повторно, то после окончания звука он будет повторен, так как ваш щелчок 
встал в очередь событий. | 

Все рассмотренные ранее операторы прерывали при своем выполнении 
звук, который асинхронно воспроизводился в момент вызова Р]1ауЗоппа. Если 
же вы выполните оператор с флагом $5МО_МОЗТОР, например: 


РОМТ- структура, характеризует координаты точки 661 


Р1аубочпа ("С : \ \М1п9омз \ \Меа1а\\Звук М1сгозоЕ®.мау",0, 
$Мр_5УМС | $МО _МОЗТОР) 


то в случае, если в этот момент драйвер занят воспроизведением другого звука, это 
воспроизведение не будет прерываться, а функция Р1аузЗоип9 сразу вернет фа5е. 
Заказанного этим оператором звука вы не услышите, т.к. в очередь он не встанет. 


РОГМТ- структура, характеризует координаты точки 
Характеризуют координаты точки 
Заголовочный файл шпае].А 


Синтаксис 


суреаеЕ зегиас® ФаздРОТМТ 


{ 
ОМС х; 
ОМС у; 
} РОТМТ, *РРОТМТ, МЕАВ *МРРОТМТ, РАВ *ГРРОТМТ; 


суреаеЕ зегисЕ _РОТМТЬ 


{ 
ТтОМС х; 
тОМС У; 
} РОТМТЬ, *РРОТМТЬ; 


Описание 

Идентичные для многих применений структуры РОМТ и РОТМТГЕ харак- 
теризуют точку — ее координаты Х и У. Прямоугольную область: 1е#4, фор, 
120 и БоНош задают соответственно координаты левой, верхней, правой 
и нижней сторон прямоугольника. 

Используемый во многих функциях С++ВиАаег тип ТРо1шё наследует 
типу РОМТ. 


Ро]уВе21ег — сглаживают на контексте устройства множество точек 
Соединяют множество точек, заданных массивом 
Заголовочный файл и171541.А 


Синтаксис 


ИТМСОТАРТ ВООТ МТМАРТ Ро1уВе71ет (ТМ НОС Вас, 1М сом$т РОТМТ. * 1ррё, 
ТМ ОМОВО сРо1пе$); 
ИТМСОТАРТ ВООТ МТМАРТ Ро1уВеглегТо (ТМ НОС Пас, 
ТМ СОМЗТ РОТМТ * 1рреё, 
| ТМ ОМОВО сРо1пе$); 

ИТМСОТАРТ ВООЬ ИМТМАРТ Ро1ургам (ТМ НОС Бас, ТМ СОМ$Т РОТМТ * 1рре, 
ТМ СОМ$ЗТ ВУТЕ * 1рЬТурез, 
ТМ 106 сРо1пе$); 


Описание 

Функции используются при рисовании на контексте устройства (см. 
разд. 5.5.1). Функции РойуВезжег и Ро!уВезегТо сглаживают множество то- 
чек, содержащихся в массиве 1ррё, кусочной кривой третьего порядка. Каж- 
дый отрезок кривой строится по четырем точкам. Первая кривая проходит че- 
рез первую и четвертую точку, обеспечивая минимальное отклонение во вто- 
рой и третьей точках. Каждый следующий отрезок кривой использует послед- 
нюю точку предыдущего отрезка в качестве начальной точки и использует сле- 
дующие три, проводя кривую через последнюю из них и минимизируя откло- 
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нение от двух предыдущих. Отрезки кривых стыкуются не гладко — в местах 
стыков наблюдаются изломы. 

Параметр функций В4с является дескриптором контекста устройства. Па- 
раметр 1ррё указывает на массив, содержащий исходные точки, а параметр 
сРо1 {$ — число используемых точек массива. Значение сРоп{$ может быть 
меньше действительного числа точек массива, так что не обязательно исполь- 
зовать все точки массива. 

Функция Ро[уВелегТо отличается от РоуВежег тем, что в качестве началь- 
ной точки использует текущую позицию пера. Так что возможны 2 варианта: 


и в массив заносятся все точки, кроме первой, а в качестве первой фигури- 
рует текущая позиция пера. 


и в массив заносятся все точки, перед вызовом функции текущая позиция 
пера устанавливается функцией МоуеТоЕх в точку, определяемую первым 
элементом массива, а в вызов функции Ро[уВежегТо в качестве параметра 

‚ ррё передается адрес второго элемента массива. 


Значение параметра сРо1шё$, указываемое для каждого метода, должно 
быть строго определенным: для РойуВезмег — оно должно быть на единицу 
больше числа, кратного 3 (т.е. 1*3-+1), а для РойуВеллегТо — кратно 3 (т.е. 1*3). 
Если число точек не равно требуемому, то функции просто ничего не рисуют. 
| Исходя из этого при произвольном числе точек М имеет смысл автоматиче- 
ски приводить значение еРошф$ к требуемому, например, такими операторами: 


Ро1уВехлег (Пас, ро1пез, (М№/3)*3+1); 


Ро1уВег1егТо (Пас, ро1пЕз, (№/3)*3); 


В этих операторах значение параметра сРо1т{ф$ за счет округления при це: 
лочисленном делении автоматически приводится к допустимому, обеспечивая 
приближение кривой к максимальному числу первых точек массива. Правда, 
1-2 последние точки могут оказаться «лишними» и не будут отражены кривой 

Другой способ получения нужного количества точек — добавить в массив 
недостающие точки на основе линейной, квадратичной или кубической ап- 
проксимации. Но это более сложный вариант. 


Функция Ро!у)Огам является более универсальной и может использоваться 
вместо РоуВежлег, Ро!уВежегТо, Ро]уНпе или Ро!уПпеТо. Функция имеет до- 
полнительный параметр 1рЬ'Турез — указатель на массив, размер которого сов- 
падает с размером массива 1рр*. Каждый элемент массива 1рЬТуре$ определяет 
тип процедуры, которая должна выполняться при переходе к соответствующей 
точке массива 1рр%. Элементы массива 1рЬТурез могут принимать значения: 


7 = НИИ 


ТоЕх в эту точку. Если подобное значение указано для проме- 
‚ жуточной точки массива, график будет иметь разрыв на ин- 


| | < & } 
‚тервале между этои и предыдущеи точками. | 


пера в эту точку. Текущая позиция перемещается в эту точку. _ 


| Т_ ЫМЕТО ‚ Обеспечивает рисование прямой линии из текущей позиции 


‚ РТ_ВЕЙТЕВТО Обеспечивает сглаживание, подобное рассмотренным ранее | 


функциям. Это значение должно быть задано, по крайней 
' мере, трем последовательным точкам, и общее число таких по- | 
| ` " | 
‚ следовательных точек должно быть кратно 3, т.е. 1%3. 

РНЕ и и НИИ 


Ро|уВе2!ег — сглаживают множество точек, заданных массивом 663 


Со значениями РТ_ШМЕТО и РТ_ВЕЙТЕКТО можно объединять операци- 
ей ИЛИ значение РТ_СГОЗЕЕТСОВКЕ. В этом случае данная точка будет соеди- 
нена прямой линией с ближайшей точкой, имеющей значение РТ_МОУЕТО, 
или точкой, в которую осуществлялось перемещение функцией МоуеТоЕх. 

Таким образом, если для всех точек задать тип РТ_ЫМЕТО, то результат 
будет эквивалентен применению функции Ро!уПпеТо — кусочно-линейной 
кривой, начинающейся с текущей позиции пера. Если при этом для первой 
точки массива задать тип РТ МОУЕТО, то результат будет эквивалентен при- 
менению функции Ро|!уНпе — кусочно-линейной кривой, аппроксимирующей 
все точки массива. Если для какой-то промежуточной точки массива задать 
значение типа РТ_МОУЕТО, то на интервале между данной и предыдущей 
точкой график рисоваться не будет. Таким образом, с помощью функции 
Ро!у)гам можно рисовать графики, состоящие из отдельных, не связанных 
друг с другом частей (аналогичный результат можно получить функцией 
Ро!уРо1уПте). Если для первой точки массива задать тип РТ _МОУЕТО, а для 
последней — РТ ТАМЕТО | РТ_СГОЗЕЕТСОВЕ, то будет проведена прямая из 
последней точки в первую, так что нарисуется замкнутая фигура. Ее площадь 
не будет заполняться кистью. 

Если для всех точек задать РТ_ВЕЙТЕВТО, то результат будет эквивален- 
тен применению функции РойуВежегТо. При этом число точек, передаваемое 
параметром сРо1шф$, должно быть кратно 3. Если для первой точки` массива за- 
дать РТ МОУЕТО, а для остальных РойуВежлегТо, то результат будет эквива- 
лентен применению функции Ро]уВезжегТо. При этом число точек, передавае- 
мое параметром Рош 5$, должно быть на 1 больше числа, кратного трем. Если 
для какой-то промежуточной точки массива задать значение РТ МОУЕТО, то 
на интервале между данной и предыдущей точкой график рисоваться не будет. 
Таким образом, с помощью функции Ро|у)гам можно рисовать графики, со- 
стоящие из отдельных, не связанных друг с другом частей. Но при этом надо 
следить за тем, чтобы в каждой части число точек со значением 
РТ_ВЕЙТЕКТО было кратно 3. Если для первой точки массива задать тип 
РТ_МОУЕТО, а для последней — РТ_ВЕ7ЙТЕВТО | РТ_СГОЗЕЕСОВЕ, то бу- 
дет проведена прямая из последней точки в первую, так что нарисуется замк- 
нутая фигура. Ее площадь не будет заполняться кистью. 

Функция возвращает ненулевое значение в случае успешного выполнения 
и 0 вслучае ошибки. Тогда информацию об ошибке можно получить функцией 
Се Газ {Еггог. 

См. также функции РауПпе, Ро1уНпеТо, РуРо уе. 

Примеры 

Ниже приведен пример построения графиков аппроксимаций функции 
—511(х) функциями Ро]уВежег, Ро]уВезжегТо и РойуПпе. 


#1пс1аае <паёВ.Н> 


соп$Е 1пе М = 11, // число точек 

Тх = Гшаде1->С11еп Мар, Ту = 100, Т = 10; 
РОТМТ ро1пЕ$ [М1]; 
НОС НО = Тмаде1->Сапуа$->Напа1е; 


// заполнение массива 
Рог (106 1 = О; 1 < М; 1++) 
ро1п&$[1] = Ро1п® ( (1108) (1 * 1х / (№-1)), 
(106) ($1п ((4опр1е)1 * Т / (№-1))*Ъу) + 
Тпадче1->С11епеНезаве / 2); 
// Создание красного, зеленого и черного перьев: 
НРЕМ КеЯРеп = Сгеа®еРеп (РЗ_ЗОЬТО, 1, с1Веа); 
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НРЕМ СгеепРеп = СгеафеРеп (РЗ_ЗОТТО, 1, с1Сгееп); 
НРЕМ В1аскКРеп Сее5оскОю)ес® (ВЪАСК_РЕМ); 


// рисование 
5е1есеоОБ]есе (НО, В1асКРеп); 
Ро1у11пе (НО, ро1пЕ$, №); 


бе1есеОБ]ес+ (НО, ВКеаРеп); 
Ро1уВе21ег (НО, ро1п®з, (М№/3)*3+1); 


бе1есеОБ]еск (НО, СгеепРеп); 
МохеТоЕх (НР, ро1пе$[0].х, ро1пе$[0].у, МОЪЬ); 
Ро1уВе21егТо (НО, ро1пез, (М№/3)*3); 


// освобождение дескрипторов перьев 
Ре1ефъеоЬ-]еск (ВеаРеп); 

Ре1етеоБ]ес® (СгеепРеп); 
Ре1ефсео5]ес+ (В]1аскКРеп); 


Значения последнего параметра в вызовах функций округляется до допус- 
тимой величины в соответствии с формулами, приведенными в описаниях 
функций. 

На рис. 8.3 показаны результаты расчета. Поскольку черно-белое изобра- 
жение в книге не передает цвета, на рисунок нанесены надписи, поясняющие, 
какая кривая к какой функции относится. Можно разглядеть, что в данном 
случае при М = 11 функция РоуВежег не отображает последнюю точку, 
а функция Ро|уВежегТо не отображает две последние точки. 


Рис. 8.3 | ‚т Функции АРТ Роуцте, роуве 2 
Пример построения графиков . 
функциями РоуВегег, РоуВезегТо | Рофйие „7“ 
и Роуте | и 


“ "т а 
Робазе То 


В этом примере использование функции РойуВезегТо не совсем коррект- 
но, так как первая точка массива учитывается дважды: в качестве начальной 
позиции пера и в качестве следующей точки аппроксимации. Более правильно 
заменить оператор вызова Ро!уВежегТо следующим оператором: 


Ро1уВег1егТо (НО, ро1п&$+1, ((М№-1)/3)*3); 


Тогда графики ‘функций Ро!уВежег и Ро[йуВезлегТо будут идентичны, 
и на рисунке наложатся друг на друга. 


Ниже приведен пример построения графиков аппроксимаций той же 
функции э11(х) функцией РойуОгам. 


#1пс1аАе <пабь.В> 


соп$Е 1пЕ М = 11, // число точек 
.х = Тмаде1->С11епЕМ1аер, Шу = 100, Т = 10; 


Ро!уВе71ег — сглаживают множество точек, заданных массивом 665 


РОТМТ ро1пЕ3 [№]; 
ВУТЕ 1рЬТуре$ [№]; 
НОС НР = Тмаде1->Сапуаз->Напа1е; 


// Создание красного и черного перьев: 
НРЕМ ВеаРеп = СгеабеРеп (Р$_5ОТТО, 1, с1Веа); 
НРЕМ В1асКкРеп = Сее5оскОр)ес® (ВЪАСК РЕМ); 


// заполнение массива 
Рог (1108 1 = 0; 1 < №; 1++) 
{ 
ро1п*$[1] = Ро1п® ( (10%) (1 * 1х / (№-1)), 
(106) (311 ( (4ойЬ1е)1 * Т/ (№-1))*1у) + 
Тмаде1->С11епЕНелаве / 2); 
// вариант, эквивалентный Ро1у11пе или Ро1у11пеТо 
1рЬТурез[1] = РТ БТМЕТО; 
} 
// вариант, эквивалентный Ро]1у11пе 
1рЬТурез[0] = РТ МОУЕТО; 
// закомментирован вариант рисования замкнутой кривой 
//1рЬТурез [№-1] |= РТ СГО$ЗЕЕТСОВЕ; 


// рисование 
5е1есеоОБ]есе (НО, В1асКРеп); 
Ро1ургам (НР, ро1п®5, 1рЬТурез, №); 


// вариант, эквивалентный Ро]уВег1ег или Ро]1уВегтегТо 
Бок (ПЕ 1 = 0; 1 < №; 1++) 


1рЬТурез[1] = РТ ВЕРТЕВТО; 
// вариант, эквивалентный Ро1уВег1ег 
1рЬТурез[0] = РТ МОУЕТО; 
// закомментирован вариант рисования замкнутой кривой 
//1рЬТуре$ [№-1] |= РТ СТОЗЕЕТСОКЕ; 
Зе1есеОБ]есЕ (НО, ВеаРеп); 
Ро1ургам (НО, ро1пе5$, 1рЬТурез, (М№/3)*3+1); 


// освобождение дескрипторов перьев 
Ре1есеор)ес+ (КеаРеп); 
Ре1екеоь]еск (В1аскКРеп); 


Значения последнего параметра в вызове функции Ро!у)0гам в варианте, 
эквивалентном Ро!уВежег, округляется до допустимой величины в соответст- 
вии с формулами, приведенными в описании функции Ро]!у0Огам. 

На рис. 8.4 показаны результаты расчета. Можно разглядеть, что в данном 
случае при М = 11 аналог функции РойуВеллег не отображает последнюю точку. 


Рис. 8.4 ``: Функция РоуОга 
Пример построения графиков 
функцией РоуОга\ми 


Аналог Роуте 
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Перед прорисовкой линии, эквивалентной РойуЙпе, можно было бы задать 
в одной из промежуточных точек тип РТ_МОУЕТО. Это привело бы к разрыву 
графика при переходе к этой точке (поведение, аналогичное функции 
Ро]!уРо1уПпе). 


Ро!уВезлегТо — сглаживает множество точек на контексте устройства 
См. функцию РоуВежег. 


Ро|!у)га\ — сглаживает множество точек на контексте устройства 
См.. функцию РойуВелег. 


Роугоп, Ро!уРоугоп — рисуют многоугольники на контексте устройства 
°— Рисуют многоугольники 
Заголовочный файл И’/пизег.й 


Синтаксис 


#10с1аае <м1пизег.вВ> 
ИТМСОТАРТ ВООГ 'ИТМАРТ Ро1удоп (ТМ НОС Зас, 
ТМ СОМЗТ РОТМТ * 1рРо1пЕ$, 
ТМ 1пЕ пСоппё); 

ИТМСОТАРТ ВООГ МТМАРТ Ро1уРо1удоп (ТМ НОС Вас, 

ТМ СОМ5Т РОТМТ * 1рРо1пЕ$з, 

ТМ СОМЗТ ТМТ * 1рРо1уСоппе$, . 

ТМ 1пЕ пСойп®); 


Описание 

Функции используются для рисования на контексте устройства (см. 
разд. 5.5.1) многоугольников. Параметр В№4е — дескриптор контекста. Пара- 
метр 1рРой{$ указывает массив точек типа РОМТ. Параметр сСошп{ задает 
число используемых точек массива. Значение сСоци{ может быть меньше дей- 
ствительного числа точек массива, так что не обязательно использовать все его 
точки. Многоугольник автоматически замыкается проведением линии между 
последней и первой вершинами. Контур многоугольника рисуется текущим 
пером, а площадь многоугольника заполняется текущей кистью. 

Например, следующие операторы рисуют на контексте канвы компонента 
Гпарсе1 ромб: 

НОС НР = Тмаде1->Сапуа$->Напа1е; 

116 И = Тмаде1->\тафй; 


11$ Н = Тмаде1->Неларе; РОТМТ ро1п65$[4]; 
ро1пЕ$[0] = Ро1пе(0, Н/ 2); 

ро1пе$[1] = Ролп® (И / д, 0); 

ро1пё$[2] = Ро1пё (и, Н / 2); 

ро1пЕз [3] = Ро1пе (М / 2, Н); 

Ро1удоп ( ро1пЕз, 4); 


Если в последнем оператре уменьшить число используемых точек: 
Ро1уаоп (НО, ро1пез$, 3); 


то по тем же данным будет нарисован только верхний треугольник ромба. 
Функция Ро|1уРо]угоп осуществляет те же операции, что и функция 
Ро]!угоп, но позволяет рисовать несколько отдельных, не связанных друг 
с другом многоугольников. Параметр 1рРош $ указывает на массив, в который 
занесены точки всех рисуемых многоугольников. А параметр рРо!уСоип $ 
указывает массив, в который заносится число точек в каждом многоугольни- 


Ро|у|те, Ро!утеТо, Ро[уРо|у!те — проводят кусочно-линейные кривые 667 


ке. Параметр пСоппф задает число рисуемых многоугольников, т.е. число ис- 
пользуемых элементов массива рРо]!уСоит{5. Например, если в массив рот 
занести вершины двух многоугольников, из которых первый имеет три верши- 
ны, а второй 5, то нарисовать эти два многоугольника можно следующими 
операторами: 

РИОВР Ро1уРо1пе$ [2]; 

Ро1уРо1пЕ$ [0] = 3; 

Ро1уРо1пе$ [1] = 5; 

Ро1уРо1у11пе (НО, ро1пе$, Ро1уРо1пЕ$, 2); 

Рассмотренные функции возвращают ненулевое значение в случае успеш- 
ного выполнения и 0 в случае ошибки. Тогда информацию об ошибке можно 
получить функцией Се Таз Еггог. 


Ро!у[пе, Ро]уПпеТо, Ро!уРо]у|йпе — проводят кусочно-линейные 
кривые на контексте устройства 


Соединяют кусочно-линейной кривой множество точек, заданных массивом 
Заголовочный файл итд 41.Й 


Синтаксис 


ИТМСОТАРТ ВООГ ИТМАРТ Ро1у11пе (ТМ НОС Бас, 
ТМ СОМ$ЗТ РОТМТ * 1рре, 
ТМ 1пЕ сСоип®); 


ИТМСОТАРТ ВООГ ИТМАРТ Ро1у1]1пеТо (ТМ НОС Бас, 
ТМ СОМ$Т РОТМТ * 1рреё, 
ТМ ОРМОКО сСоцпЁ); 


ИТМСОТАРТ ВООТ МТМАРТ Ро1уРо1у11пе (ТМ НОС Вас, 
ТМ СОМ$5Т РОТМТ * 1рре, 
ТМ СОМЗТ РИОКР * ]1рамРо1уРо1пЕ$, 
ТМ ОМОВКО сСочпЕ); 


Описание 

Функции используются для рисования на контексте устройства (см. 
разд. 5.5.1) кусочно-линейной кривой множества точек, заданных массивом. Па- 
раметр В9с — дескриптор контекста. Параметр 1ррё указывает массив точек типа 
РОТМТ. Параметр сСоцп в функциях Ро|уНпе и Ро!у1пеТо задает число исполь- 
зуемых точек массива. Значение сСоипф может быть меньше действительного 
числа точек массива, так что не обязательно использовать все его точки. 

Например, рисование на контексте канвы компонента может быть органи- 
зовано следующим образом: 

сопзе 110% М = ...; // число точек 


РОТМТ ро1пе$ [№]; 
НОС НО = Тмаде1->Сапуа$->Напа1е; 


// заполнение массива 


// рисование 
Ро1у11пе (НО, ро1пё$, №); 


Обе функции рисуют линию с помощью текущего пера. Если функции ри- 
суют замкнутую фигуру, то площадь этой фигуры не заполняется кистью. 
Функция Ро]уПпе не изменяет текущую позицию пера. А функция 


Ро1!уппеТо перемещает позицию пера в конец последнего нарисованного сег- 
мента линии. 
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Функция Ро!уЙпеТо отличается от Ро!уНпе прежде всего тем, что в каче- 
стве начальной точки использует текущую позицию пера. Так что возможны 2 
варианта: 


и в массив заносятся все точки, кроме первой, а в качестве первой фигури- 
рует текущая позиция пера. 


и в массив. заносятся все точки, перед вызовом функции текущая позиция 
пера устанавливается функцией МоуеТоЕх в точку, определяемую первым 
элементом массива, а в вызов функции Ро|уПпеТо в качестве параметра 
]ррё передается адрес второго элемента массива. Например: 


Ро1у11пеТо (НР, ро1пе$+1, М№-1); 


Функция Ро1уРо]уПпе осуществляет те же операции, что и функция Рау- 
Ппе, но позволяет рисовать несколько фрагментов кусочно-линейных кривых, 
не связанных друг с другом. Параметр [рр указывает на массив, в который за- 
несены точки всех рисуемых кривых. А параметр 1р4мРо]!уРо{$ указывает 
массив, в который заносится число точек в каждом фрагменте. Параметр 
сСоипф задает число фрагментов, т.е. число используемых элементов массива 
]рдм\Ро!уРо1т $. 

Например, в приведенном ранее коде можно заменить вызов функции 
Ро!уПпе следующим кодом: 

РИОВО Ро1уРо1п*$[2]; 

Ро1уРо1пе$ [0] = 5; 

Ро1уРо1пЕз [1] = 6; 

Ро1уРо1у11пе (НО, ро1пё$, Ро1уРо1пе$, 2); 

Тогда будут нарисованы два фрагмента: один по первым пяти точкам мас- 
сива ротф$$5, а второй — по следующим шести точкам этого массива. Линия, со- 
единяющая пятую и шестую точки массива, рисоваться не будет 

Функции возвращают ненулевое значение в случае успешного выполнения 
и 0 вслучае ошибки. Тогда информацию об ошибке можно получить функцией 
Се Газ Еггог. 

См. примеры в описании функций РойуВежег, Ро]уВежегТо, Ро!уОгам. 


Ро!уНпеТо — соединяет кусочно-линейной кривой множество точек 
на контексте устройства 


См. функцию РойуПпе. 


Ро!уРо|!ухоп — рисует многоугольники на контексте устройства 
См. функцию Ро]уйоп 


Ро!уРо!у|пе — соединяет кусочно-линейной кривой множество точек 
на контексте устройства 


См. функцию Ро]йуПпе. 


Ро${Меззасе — помещает в очередь указанное сообщение 


Функция помещает указанное в ней сообщение окну или множеству окон 
в очередь сообщений потока, создавшего эти окна, и возвращается, не дожида- 
ясь окончания обработки этого сообщения 
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Заголовочный файл И7пизег.й 


Синтаксис 

ВОО Ро5%Меззасще ( 

НИМО ВМпа, // дескриптор окна - приемника 
ОТМТ Мза, // сообщение 


ИРАВАМ мРагам, // первый параметр сообщения 
ТРАВАМ 1Рагам // второй параметр сообщения 

); 

Описание | 

Функция Ро Меззайе ставит указанное в ней сообщение окну или множе- 
ству окон в очередь сообщений потока, создавшего эти окна, и возвращается, 
не дожидаясь окончания обработки этого сообщения. Этим функция 
Роз{Меззаге отличается от функции ЗепдаМе$5асе, которая ждет окончания 
обработки сообщения и на это время блокирует приложение, которое послало 
сообщение. Сообщения в дальнейшем изымаются из очереди функциями 
Се Мез5асе и РееКМеззаге. 

Параметр В\У’пЯ — дескриптор окна, которому передается сообщение. 
Если этот параметр равен Н\УМО_ ВКОАОСАЗТ, то сообщение передается 
всем окнам верхнего уровня в системе, включая недоступные, невидимые, пе- 
рекрытые другими и всплывающие, за исключением дочерних окон. Если этот 
параметр МОГ, то сообщение ставится в очередь сообщений (если она есть) 
текущего процесса. 

Параметр М$е определяет передаваемое сообщение. Параметры мРагат 
и 1Рагат могут содержать дополнительную информацию. | 

Функция возвращает ненулевое значение при успешном завершении 
и нуль при аварийном завершении. В этом случае причину ошибки можно ус- 
тановить вызовом функции Се Газ Еггог. 

Если вы посылаете сообщение в диапазоне ниже \УМ_ОЗЕК асинхронны- 
ми функциями Роз Меззахе, ЗепаМоНРуМеззаге или Зеп@МеззагеСаПБасК, 
надо быть уверенным, что параметры сообщения не включают указателей. 
В противном случае из-за немедленного возврата функции может оказаться, 
что к моменту, когда поток начнет обрабатывать сообщение, приложение, ко- 
торое его послало, окажется уже удаленным из памяти. 

См. также функцию Зеп4Мезбзаде. 


Примеры 
Оператор 
РозЕМеззаде (Гоги2->Напа1е, ММ СТО5Е, 0,0); 


посылает форме Еогт2 сообщение \УМ_СГОЪЗЕ, закрывающее окно этой фор- 
мы. Первый параметр функции Роз{Мез5асе содержит дескриптор окна фор- 
мы Рогт2, полученный с помощью ее свойства НапШЩе. Сообщение 
\УМ_СГОЗЕ не имеет параметров; поэтому параметры мРагат и 1Рагаш зада- 
ны равными нулю. 

Оператор 

РозЕМез5асе (Е1пА\1паом ("5с1Са1с","Калькулятор"), 

ИМ _СТО$Е, 0,0); 

использует функцию Ета\1т9о\ для получения дескриптора окна приложе- 
ния, которому надо послать сообщение \М_СГОЗЕ. В качестве параметров 
в ЕтА\М”1т9о\ передаются класс формы Зе1Са[е и ее заголовок «Калькуля- 
тор». Это стандартное приложение \/1п4о\з «Калькулятор». 

См. также примеры в разд. 5.1.3. 
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Ри15еЕуепё — изменяет состояние события 
См. функцию Зе Еуепф. 


РиггеСотт — и другие функции работы с портом в синхронном режиме 
Функции работы с портом в синхронном режиме 
Заголовочные файлы и11541.Й, илпаои?з.В 


Синтаксис 


ВОО РогаеСотм (ТМ НАМОЬЕ ВЕ11е,1М ОМОВКО амЕ1аа$); 
ВОО Е1а5НЕ11еВоЕЁЕетз (ТМ НАМОГЕ БЕ11е); 

ВОО бееСопиВгеак (ТМ НАМОЬЕ ВЕ1]1е); 

ВООШ С1еахСопмВгеак (ТМ НАМОТЕ ВЕ11е); 


Описание 

Обычно перед началом операций записи и чтения в синхронном режиме 
работы порта (см. разд. 2.5.2) необходимо очистить буфер порта от мусора, 
а иногда и отменить выполняющуюся в данный момент предыдущую опера- 
цию записи или чтения. Это может осуществляться функцией РигоеСотит. 

Параметр ВЕШе является дескриптором порта, а параметр 4мЕ1а5$ указы- 
вает выполняемые операции. Он может комбинироваться операцией ИЛИ из 
следующих флагов: 


_РОВОЕ_ ТХАВОВТ. ‚ Немедленно завершить _все операции записи 


РОВбЕ_ТХСГЕАЕ 
 РОВСЕ_ ВХСЬЕАВ |Очистить в драйвере очередь приема 


щи тии 


| « 
_ Очистить в драйвере очередь передачи 


Функция РигоеСот позволяет очистить буфер от мусора, который мо- 
жет быть следствием работы какой-то предыдущей программы, и позволяет 
прервать операции чтения и записи в случае ошибки. Полезно также вызвать 
эту функцию перед завершением вашего приложения, чтобы не оставлять му- 
сор другим программам. Но надо учитывать, что очистка буфера не означает 
передачу находящихся в нем данных. Эти данные просто стираются. Если же 
надо завершить передачу данных, содержащихся в буфере, то вместо 
РиггеСотт надо вызывать функцию Е1!а$ВЕПеВийЁег$. 

Функция Е! В ЕПеВиЁег$ обеспечивает передачу данных из выходного 
буфера, и только после этого очищает его. Дело в том, что запись данных 
в файл, если только в вызове функции Сгеа%&еЕ Це не установлены флаги ЕП.Е__ 
ЕГАС_ \УЮТЕ ТНВКООСН и ЕПЕ_ЕТАС_МО_ВОРЕЕММОС, не идет напря- 
мую. Если бы результат каждого вызова функции УгЦеЕЦе немедленно зано- 
сился в файл, это увеличивало бы затраты времени. Запись идет в некие внут- 
ренние буферы системы, расположенные в оперативной памяти. Данные из 
них переносятся в файл при заполнении буфера, т.е. крупными пакетами. Они 
переносятся также из буфера в файл при вызове функций чтения или функции 
СозеНап Ме. Использование буферов обеспечивает относительно редкое обра- 
щение к файлу на диске, за счет чего экономится время выполнения. Вызов 
функции ЕВ ЕПеВоиЁег$ принудительно синхронизирует содержимое, хра- 
нящееся в буфере, с содержимым файла на диске. При успешном выполнении 
функция возвращает ненулевое значение. | 
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Порт можно перевести в состояние разрыва связи с помощью функции 
Зе СоттвВгеаКк. При вызове этой функции передача данных прекращается, 
выходная линия переводится в состояние "0", после чего и приемник фикси- 
рует состояние разрыва. Возобновить прерванную передачу данных можно 
функцией ЧеагСоттВгеак. 

См. примеры применения функций в разд. 2.5.2, 2.5.3, 6.7.3. 


Веа4ЕЙе, УгцеЕПе — чтение и запись в устройство, открытое 
функцией СгежеЕ!е 


Производят чтение и запись в устройство, открытое функцией СгежеЕ!е 
Заголовочный файл И’тфазе.П 


Синтаксис 


#10с]1пае<м1пьазе. [> 

ВООГ Кеааг11е (НАМОЬЕ ВЕ11е, ГРУОТОР 1]рВаЕЕек, 
РИОВОР пМмитрегОЕВу®езТоБеаа, 
ТРРИОКР 1рМипбегОЕВу®езВеаа, 
ТРОУЕВГАРРЕР 1рОуег1арред); 


ВОО Мг1ЕеЕ11е (НАМОЪЕ ВЕ1]е, ГРСУОТО 1рВоаЕЕег, 
РИОВР пМитрекоЕВуезТойЙхг1ее, 
БРРИОВР 1рМ№ипрекоЕВу<езМг1е еп, 
ТРОУЕВТАРРЕР 1рОуег1арреа); 


Описание 

Функция ВеааЕ1е читает из файла (устройства), а УгцеЕЦе — записыва- 
ет в файл (устройство), открытый ранее функцией СгезжеЕ Це. Чтение и запись 
начинаются с текущей позиции файла. После операции чтения: или записи те- 
кущая позиция файл сдвигается на число записанных или прочитанных бай- 
тов. Правда, это произойдет, только если файл был открыт без флага ЕТ- 
ГЕ ЕГАС ОУЕВГАРРЕЮ, т.е. был открыт в синхронном режиме. При асин- 
хронном режиме изменение позиции файла надо производить программно. 

Параметр ВЕПе — это дескриптор файла, полученный функцией СгеафеР!1- 
1е. При этом файл должен открываться функцией СгеазфеЕ Пе, по крайней мере, 
с параметром 4мОезге4Ассе$$ равным СЕМЕВ1ТС_КВЕАУ или СЕМЕВ1С_МЕ]- 
ТЕ соответственно при чтении и записи. 

Параметр 1рВийЙЁег является указателем на буфер, в который будет читать- 
ся информация из файла или из которого она будет записываться в файл. 

Параметр пМишегО{ВуеТоВеа4 указывает число байтов, которые тре- 
буется прочитать из файла. Это число не должно превышать размер буфера. 
Параметр пМитБегО{Вуез То\тгце указывает, какое число байтов требуется 
записать в файл. 

Параметры 1рМишЪегО?Ву‘езКеаа | и рМоашбЬегОЁВуфе У/г!1Веп являются 
указателями на переменные, в которые вернется число действительно прочи- 
танных или записанных байтов. Если 1рОуе ]арре4 равен МОТТ,, то парамет- 
ры 1рМитБегО{ВуёеВеа4 и 1рМишбегО{Вубез Уг1Щеп не могут равняться 
МОГГ. Но если 1рОуеарре4 задан, то 1рМитбегО{ВуёезВеаЯ4 и рМит- 
Бего{Вуе УгЩеп могут равняться МОШ.. 

Параметр 1рОуег1арре — является указателем на структуру ОУЕВГАР- 
РЕО (см. ее описание в данной главе). Эта структура используется, если ВЕПе 
был создан функцией СгежеЕПе с параметром ОмЕ1а$Ап4АЙгше$ равным 
ЕРП.Е_ЕТГАС _ОУЕВТАРРЕЮ. Этот флаг означает асинхронный режим чтения 
или записи. В этом случае возможно только асинхронное чтение и запись, так 
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что параметр 1рОуеарред не может быть равным МОТ... Если это условия не 
выполнено, то функция будет работать неправильно. 

Подробное описание синхронного и асинхронного режимов обмена инфор- 
мацией с устройством и соответствующие примеры см. в разд. 2.5.2, 2.5.3, 
6.7.1, 6.71.2, 6.1.3. | 


ВеадЕПеЕх, УгцеЕПеЕх — асинхронное чтение и запись 


Производят асинхронное чтение и запись файла, открытого функцией 
Сгеж{еЕ!е. 


Заголовочный файл ш1пбазе.й 


Синтаксис 


#11с1иае<и1пЬазе. > | 

суреаеЕ УОотТр (ИТМАРТ *ГРОУЕКТАРРЕР СОМРЪЕТТОМ КОЧТТМЕ) 

(РИОВР АмЕггкогСоае, РИОВОР аАмМатрегоЕВу*еТгап$Еегеа, 
ТРОУЕВТАРРЕОР 1рОуег1арред); 


ВООГ МТМАРТ КеааЕ11еЕх (ТМ НАМОЬЕ ВЕ11е, ОЧТ ГРУОТР 1рВаЕЕег, 
ТМ РМОВКР пМмМапбегоОЕВусезТовВеаа, 
ТМ ГРОУЕВЬАРРЕО 1рОуег]арреа, 
М ГРОУЕВКЪАРРЕОР СОМРЪЕТТОМ _КОЧТТМЕ 
1рСопр1ее1опКоице1пе); 


ВООЪ ИТМАРТ Мг1ееЕ11еЕх (ТМ НАМОЬЕ РЕ1]е, ТМ ТРСУОТРО 1рВаЕЕег, 
ТМ ОМОВКР пМапбегоЕВуеезТойг1ее, 
ТМ ГРОУЕВБГАРРЕО 1рОуег1арреа, 
ТМ ТРОУЕВЬАРРЕОР СОМРЪЕТТОМ _КОЧТТМЕ 
1рСоптр1е Е 1опВой®1пе); 


Описание 

Функция ВеадЕПеЕх асинхронно читает из файла или устройства, 
а \УгцеЕЦеЕх — асинхронно записывает в файл или устройство, открытое ра- 
нее функцией СгежфеЕ\е. Функции возвращаются, не ожидая окончания опе- 
рации чтения или записи. Таким образом, приложение может выполняться 
в то время, пока параллельно идут операции чтения и записи. Отличие этих 
функций от Веа4ЕШе и УгцЦеЕПе в том, что рассматриваемые функции специ- 
ально предназначены для асинхронных операций, в то время как Веа4ЕЙе 
и \УгцеЕПе могут работать как в синхронном, так и в асинхронном режимах. 
Кроме того, как будет показано далее, информация об окончании асинхронной 
операции в данном случае реализуется иначе. | 

Параметр ВЕЦе — это дескриптор файла или устройства, полученный 
функцией Сгеж4е Е Пе. Этот файл должен быть открыт функцией СгезжеЕ Пе, по 
крайней мере, с параметром 4мО)ез1тге4Ассез$ равным СЕМЕВДС_КЕАЪ или 
СЕМЕЕТС_\/ВТЕ соответственно при чтении и записи, и обязательно с пара- 
метром ЮмЕ1а55АпдАНг.иве$ равным ЕП.Е_ЕГАС_ОУЕКГАРРЕО. 

Параметр 1рВийЙЁег является указателем на буфер, в который будет читать- 
ся информация из файла или из которого она будет записываться в файл. 

Параметр пМипфегО{ВуёезТоВеа4 указывает число байтов, которые тре- 
буется прочитать из файла. Это число не должно превышать размер буфера. 
Параметр пМиифегО{ВуеТо\/гЦе указывает, какое число байтов требуется 
записать в файл. 

Параметр 1рОуеарре# — является указателем на структуру 
ОУЕВГАРРЕО (см. ее описание в данной главе). Если файл, указанный деск- 
риптором ВЕШе, поддерживает концепцию позиционирования, например, яв- 
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ляется действительно файлом, то поля ОЁ5е и ОЁ$е Н1еВ структуры 1рОуег- 
]арред должны быть заполнены до вызова функции и указывать текущую по- 
зицию файла, начиная с которой ведется чтение или запись. Если же устройст- 
во не поддерживает позиционирования, например, является портом, то значе- 
ния полей ОЁ5её и ОЁ5е Ней должны быть равны 0. 

Функции ВеадЕПеЕх и УгцеЕЦеЕх игнорируют поле ВЕуеп& структуры 
1рОуег!арред, которое используется функциями Веад Ее и УгцеЕПе для за- 
дания события, определяющего окончание процедуры чтения или записи. Так 
что это поле приложение может использовать для своих целей. А информация 
об окончании процедуры чтения или записи осуществляется вызовом пользо- 
вательской функции, на которую указывает параметр рСотшрейопВоцИпе 
в вызовах ВеадЕ\еЕх и УтгЦеЕПеЕх. 

Эта функция, которая пишется пользователем, принимает 3 параметра. 
Параметр а9мЕггогСо4де указывает состояние операции: 0 — операция успешно 
завершена, ЕВВОВ НАМОГЕ ЕОЕ — попытка чтения после конца файла. 
Параметр 4мМишегО!{ВуУе$ТгапзЁегед указывает число переданных байтов. 
В случае ошибки значение этого параметра равно 0. Параметр 1рОуеарре4 
указывает на структуру ОУЕВГАРРЕО, которая использовалась при вызове 
ВеааЕПЦеЕх или УгЦцеЕЦеЕх. Поскольку поле ВЕуепф этой структуры не ис- 
пользуется системой, то в этом поле можно прочитать информацию, которая 
была в него занесена перед вызовом ВеадЕПеЕх или УгцеЕ!ПеЕх. 

Вызов пользовательской функции происходит при завершении операции 
чтения или записи, но только в том случае, если поток находится в ожидании 
с помощью функций ЗЧеерЕх, УацЕогЭт1еОБес Ех или УацЕогМиШ- 
р1еОБесё Ех с параметром Мена Ше равным %фгие. 


ВЕСТ — характеризует прямоугольную область 
Характеризуют прямоугольную область 
Заголовочные файлы штае].й, ифпсоп.В 


Синтаксис 


суре4еЕ зЕгасе тадвВЕСТ 
{ 


ОМС 1еЕС; 
БОМС Сор; 
ОМС г1аре; 
БОМС Боевом; 


} ВЕСТ, *РВЕСТ, МЕАБ *МРВЕСТ, ЕАВ *ГРВЕСТ; 
фуредеЕ сопзЕ ВЕСТ ЕАВ* ГРСВЕСТ; 


суре4еЕ зЕгосЕ _ВЕСТЬ 
{ 


БОМС 1еЕс; 
ОМС Сор; 
ОМС г1аве; 
ЬОМС Босфом; 


} ВЕСТЬ, *РВЕСТЬ, *ЬРВЕСТЦ; 
суреаеЕ сопз® ВЕСТЬ РГАВ* ТРСВЕСТЬ; 


суреаеЕ зегасЕ _5МАЬЬ ВЕСТ // в и1псоп.В 
{ 

ЗНОВТ ФеЕф; 

ЭНОВТ Тор; 
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ЗНОВТ В1аБе; 
ЗНОКТ ВоЕфоп; 
} ЗМАГТ ВЕСТ, *РУМАГТЬ ВЕСТ; 


Описание 

Идентичные для многих применений структуры ВЕСТ и ВЕСТЕ. характе- 
ризуют прямоугольную область: 1еЁ4, фор, г1е В и БоНот задают соответствен- 
но координаты левой, верхней, правой и нижней сторон прямоугольника. 
Структура ЗМАТТ, ВЕСТ отличается только типом полей и используется 
в функциях консольных приложений. 

Используемый во многих функциях С+-+Ви!аег тип ТВес& наследует типу 
ВЕСТ, но предоставляет немало дополнительных возможностей. 


Весап?]е — рисует прямоугольник 
См. функцию ЕгатевВесф. 


Вел егНо{Кеу, Опгез1${егНо{Кеу — регистрация горячих клавиш 
Управляют регистрацией горячих клавиш 
Заголовочный файл Итизег.В 


Синтаксис 


ВООЪ Вед1з$егНо*Кеу (ТМ НММР Ю\Мпа, ТМ 11 та, 
ТМ ОТМТ Е$Моа1Е1етз, ТМ ОТ\Т УК); 


ВООЬ МТМАРТ ЧУпгед1$$ехкНо&Кеу (ТМ НИМОР ВМра, ТМ 11% 19а); 


Описание 

Для того чтобы некая комбинация горячих клавиш была доступна из лю- 
бого приложения, ее надо зарегистрировать в системе. Это делается функцией 
Кез егНо*Кеу. Параметр В\У/п4 является дескриптором того окна приложе- 
ния, в котором описана реакция на данную комбинацию горячих клавиш. Па- 
раметр 14 — идентификатор данного сочетания горячих клавиш. Подобные 
идентификаторы фиксируются в глобальной или локальной таблицах атомов. 
Они должен лежать в пределах от 0 до $ВЕЕЕ. При этом надо обеспечить уни- 
кальность этого идентификатора, чтобы избежать конфликтов с другими при- 
ложениями. В частности, многие ОЛ, регистрируют свои идентификаторы. Их 
идентификаторы лежат в более узких пределах: от $С000 до $ЕЕЕЕ. Так что 
если вы зададите идентификатор вне этих пределов, то конфликта с какими-то 
работающими ПШ, не будет. Но надежнее вызывать для задания уникального 
идентификатора функцию С1оБа1 Аа4Афот. 

Параметр #5МоЙегз функции Кер1${егНо{Кеу указывает комбинацию 
вспомогательных клавиш. Он может включать флаги: 


МОР_АТЛ 


МОР СОМТВОГ, клавиша СН! 


Мор_ЗНТЕТ 


Если в некоторый момент вы хотите снять с регистрации ваше сочетание го- 
рячих клавиш, надо вызвать функцию Опгер1$ егНоКеу. В функцию передается 
дескриптор окна В\У/п4 и идентификатор 14, использованные при регистрации. 

Примеры применения описанных функций приведены в разд. 2.3.5. 


Вед!$4егМ/ИтдомуМе$аде — регистрирует сообщение \М/тдо\ми$ 675 


Вег1${ег \шпдомМеззаге — регистрирует сообщение \1т9до\5 


Функция определяет новое сообщение УМ т9до\з с гарантированной уникаль- 
ностью его в системе, которое может использоваться в функциях БепаМеззахе 
и РозМеззаге. 


Заголовочный файл шупизег.Й 


Синтаксис 
ОТМТ Вед1зегИ1паомМеззаае (.РСТЗТВ 1р5ег1па ); 


Описание 

Функция Ве {ег \т4до\/Меззасе используется для регистрации сообще- 
ний, предназначенных для связи между различными совместно работающими 
приложениями. Если два приложения регистрируют одну и ту же строку сооб- 
щения, то им возвращается одинаковый номер этого сообщения. Регистрация 
действительна до конца сеанса работы \У/1шп4о\е. 

Параметр СрэЭ®тя — указатель на строку с нулевым символом, содержа- 
щую регистрируемое сообщение. 

Если регистрация прошла успешно, то возвращается идентификатор сооб- 
щения в диапазоне от 0хС000 до ОхЕЕЕЕРЕ. Если регистрация завершилась ава- 
рийно, то возвращается нулевое значение. 

Функцию Ке51$ ег \ том Меззазе следует использовать только в случа- 
ях, когда несколько приложений должны обрабатывать одно и то же сообще- 
ние. Для посылки собственных сообщений внутри данного класса оконных 


компонентов следует использовать любое целое в диапазоне от \ММ_ОЗЕВ до 
ОхтЕЕЕ. 


ВееазеСариге и другие функции, управляющие захватом курсора 
мыши 


Управляют захватом курсора мыши 
Заголовочный файл илпизег.й 


Синтаксис 


ВООЪ ИТМАРТ ВКе1еазеСар®оге (УОТр); 
НУМР ИТМАРТ 5ееСареаге (ТМ НИМО Вирта); 
НИУМО МТМАРТ СеёСареаге (УОТр); 


Описание 

Функция ЭеёСарёиге обеспечивает захват курсора мыши окном с дескрип- 
тором В\/па. Захватить курсор может только одно окно верхнего уровня (см. 
разд. 5.1). Окно, захватившее курсор мыши, получает все сообщения мыши. 
Обеспечив захват курсора каким-то окном, например, окном редактирования, 
вы уже не сможете переключиться мышью в другое окно формы и даже в поло- 
су заголовка, пока не освободите курсор вызовом функции ВщеазеСареге. 

Функция Се Сараге возвращает дескриптор окна, которое в данный мо- 
мент захватило курсор мыши. 

В разд. 5.2.2.2, 5.2.3, 5.2.4, 5.3.1.1, 5.3.2 вы найдете примеры использова- 
ния функции КееазеСараге для организации буксировки окон компонентов 
и форм. 


Вееазе)С — освобождение дескриптора контекста 


См. разд. «Се ОС, Че М ш4до\м)С, Вееазе)С — управление дескриптором 
контекста устройства» 
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ВееазеЗетарвоге — увеличивает счетчик семафора 
Увеличивает счетчик семафора 
Заголовочный файл и1пбазе.й 


Синтаксис 


ВОО. Ке1еазебетарпоге (ТМ НАМОЬЕ П5бепарпоге, 
ТМ ОМС 1Ве1еазеСочпе, 
ОПТ ГРЬОМС 1рРгеу1оч$Соцп®); 


Описание 

Параметр 1ВееазеСоии{ указывает, на сколько должен увеличиться счет- 
чик семафора ИЗетарВоге (см. разд. 3.4). Это значение должно быть больше 0. 
Если при указанном значении 1ВееазеСоип& счетчик должен превысить мак- 
симальное значение, заданное при создании семафора, то функция вернет 
Г{а]5е, и значение счетчика останется прежним. Параметр 1рРгеу1ои$Соппё яв- 
ляется указателем на 32-разрядную переменную, в которую возвращается зна- 
чение счетчика до вызова данной функции. В качестве 1рРгеу1ои$Соип{ можно 
задать МОТГ, если предыдущее значение счетчика не требуется. 

Поскольку в вызове функции ШВ@ёеазеСоип{ нельзя указать ВаеазеСоии& = 0, 
эту функцию нельзя использовать напрямую для того, чтобы узнать текущее 
значение счетчика. Но с ее помощью все-таки можно определить это текущее 
значение, применив следующий код: 

1опа М = 1Мах1иамСоцпе; // 1Мах1мамСочпЕ - максимальное число 

1Е (Ве1еазебетарпоге (5, 1, &№)) // $ - дескриптор семафора 

Иа1ЕГог51п91е0р]ес® ($, 1); 

Если текущее значение счетчика меньше максимально возможного, то вы- 
зов функции К@аеазеЗетарвоге заносит в переменную М текущее значение 
счетчика, увеличивает счетчик на 1 и возвращает фгие. Тогда последующий 
вызов функции У\УаЦЕРог5ше1еОБес{ уменьшает счетчик на 1, т.е. возвращает 
его к исходному состоянию. Если текущее значение счетчика уже равно мак- 
симально возможному, то функция В@еазеЗетарвоге возвращает #а]$е, так 
что в переменной М сохраняется значение, заданное при ее объявлении. 


ВБетоуеГоКВез5оигсе — снимает с регистрации шрифт 
Снимает шрифт с регистрации в системе 
Заголовочный файл Итда1.Й 
Объявление 


106 ВемоухеРГоп®Везочгсе (ЦРСТЗТВ 1р52Е1]епапше }; 


Описание 

Функция ВетоуеЕ оп Везоигсе снимает указанный шрифт с регистрации 
в системе. Параметр 1р$2ЕПепате — это полное имя файла шрифта с путем 
к нему. Файлы шрифтов — это файлы .[оп, „рп, .НР, „1оЕ. 

При успешном выполнении функция возвращает ненулевое значение. 

Результаты удаления шрифта почувствуют только те приложения, кото- 
рые будут запущены после выполнения соответствующей операции. Также 
надо имеет в виду, что сколько раз подряд вы выполните регистрацию функ- 
цией АдаРГоп(Везоигсе, столько же раз надо выполнить удаление шрифта, 
чтобы он действительно удалился. 

См. примеры применения функции в разд. 1.14 и 4.1.4. 


Кепате[Ие — переименовывает файл 677 


ВепашеЕЦе — переименовывает файл 
См. функцию БеаееЕ Пе. 


Безе Еуеп{ — устанавливает событие в несигнальное состояние 
См. функцию Зе Еуепеё. 


Везо]уе — метод интерфейса ГЗвВеШлпкК 
См. функцию Се Аггитет{$. 


ВезитеТЬгеаЯ — разрешает продолжения работы потока после 
приостановки 


См. функцию Ех 'ТВгеа4. 


ВСВ — формирует цвет из красного, зеленого, синего 
Формирует цвет как комбинацию красного, зеленого, синего 


Заголовочный файл и11541.й 


Синтаксис 

#аеЕ1пе ВСВ(к,а,ь) ((СОТОВВЕЕ) ( ((ВУТЕ) (г) | ((ИОВЬ) ((ВУТЕ) (9))<<8) ) | 
(((РМОВО) (ВУТЕ) (5) ) <<16))) 

Описание 


Макрос ВСВ формирует цвет как комбинацию трех чистых цветов: г — 
красного, # — зеленого, Ъ — синего. Каждый из параметров г, # и Ь задает ин- 
тенсивность соответствующего цвета, которая может задаваться в диапазоне 
от 0 (отсутствие цвета), до 255. 

Ниже приведены примеры цветов, возвращаемых макросом ВОВ: 


ВСВ(О55, 0, 0) красный | 
ВСВ(О, 255, 0) зеленый 

ВСВСО, 0, 255) синий О 
ВСВ(О, 0, 0) _ черный 
ВСВ(255, 255, 255) ‘белый 


ВаВ(255, 255, 0) 


‘желтый 


ВоипВес& — рисует прямоугольник 
См. функцию ЕгатеВесф. 


ЗЕСОКТУ_АТТЕАВОТЕ$ — структура, задающая дескриптор защиты 


Определяет, будет ли наследоваться возвращенный функциями АР 
\У/Лтао%з дескриптор дочерними процессами, и задает дескриптор защиты 


Заголовочный файл И/таои3з.В 


Синтаксис 


#Тпс]1аае <М1паом$. [> 
суреаеЕ зегосЕ _ЗЕСОВТТУ АТТВТВОТЕ$ 
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РИОВР пЬепаеВ; 
.РУОТО 1р5есиг1® урезсг1реог; 
ВОО БТпВег1ЕНапа]1е; 
} ЗЕСОВТТУ АТТВТВОТЕ$, *РУЕСОКТТУ АТТВТВОТЕ$, *.РЪЗЕСОКТТУ АТТВТВОТЕЗ; 


фуреаеЕ _ЗЕСОВТТУ АТТВТВОТЕ$ Т5есаг1еуАсег1риеез; 
фуреаеЕ _ЗЕСОВТТУ АТТВАТВОТЕ$ *Р5есиг1 уАсЕг1рифез; 


Описание 

Структура типа ЗЕСОВ ТТУ _АТТЕВТВОТЕЗ$ или ТЗесогцуА г Ьше$ опре- 
деляет, будет ли наследоваться возвращенный функциями АР] \У/шдо\з (на- 
пример, функцией Сгеж{еЕ\1е) дескриптор дочерними процессами, и задает де- 
скриптор защиты. 

Поле пГеп2В определяет размер структуры в байтах. Это значение можно 
задавать выражением з17еой (ТЗесигцуАЙг ше) или $12е0(_ЗЕСОВТТУ _ 
АТТАВОТЕЗ). Поле рЭесигцу)езег1рюг указывает дескриптор защиты. 
Обычно его можно указывать равным МОТ, что эквивалентно использованию 
дескриптора защиты процесса, заданного по умолчанию. Поле Мппег {Нап Ме 
определяет, наследуется ли дескриптор дочерними процессами. 

В вызовах функций, предусматривающих параметр типа ЕРЗЕСОВ]- 
ТУ_АТТЕВОТЕЬ — указателя на структуру, обычно значение этого парамет- 
ра можно задавать равным МО... Это будет означать, что дескриптор не на- 
следуется, и используется дескриптор защиты по умолчанию. 


эеес{Плгес$огу — диалог выбора каталога 


Предоставляет пользователю возможность выбрать Каталог с помощью 
стандартного диалога 


Заголовочный файл РИеСИт1.Прр 


Синтаксис 


#1пс1аае <Е11еСег]1.Прр> 

ехфегп РАСКАСЕ Роо1 __Газ®са11 5е1есе01гесхохку ( 
соп5® Ап$15Ег1па Сар®1оп, 
соп5Е М1лаебег1па Кооф, 
Ап$156г1па &01гесфоку); 


епим Т5бе1есЕер1гОрф% {$аА]11омСгеафе, зАРегЕогиСгеа®е, заРгопр*}; 
суре4еЕ 5ее <Т5е1есер1гОре, $аА11омСгеаее, зАРгомр®> Т5е1ес®р1гОрез; 
ехсегп РАСКАСЕ Рроо1 __ЁЕаз®са]1]1 5е1ес&ПО1гесфоху ( 
Ап515Ег1па &О1гесфоку, 
Тбе1ес®01кОре$ ОрЕ1оп$, 
10Е Не1рсех); 


Описание 

Функция З@ес ПО1гесвюгу предоставляет пользователю возможность вы- 
звать стандартный диалог \!т4о\з и, работая с ним, выбрать каталог. Функ- 
ция имеет показанные выше две перегруженных формы. Вторая из них обес- 
печивает более гибкий диалог, но имеет существенный недостаток: окна, кото- 
рые она отображает, содержат английские тексты. 

Функция подробно описана в разд. 6.5. Там же даются примеры ее приме- 
нения. 


з@есОЫес! — назначает созданный дескриптор контексту устройства 679 


ЗеесОЦес& — назначает созданный дескриптор контексту устройства 
Назначает созданный дескриптор контексту устройства 
Заголовочный файл итд а1.Й 


Синтаксис 


#1п0с1а4е <м1паа1.8> 
ИТМСОТАРТ НСРТОВУ МТМАРТ 5е1есеОБ)ес® (ТМ НОС Бас, 
ТМ НСОТОВО ва91057); 


Описание 

Функции Че фюсКОЦес+, Сгеа{еРеп, СгеафеВгиз п 1тгес& и многие дру- 
гие создают дескрипторы кисти, пера, прифта для рисования на контексте 
устройства (см. разд. 5.5.1). Эти дескрипторы могут использоваться в функци- 
ях вывода на контекст изображений и текстов. Чтобы использовать созданный 
дескриптор, его надо назначить контексту данного устройства. Это осуществ- 
ляется функцией З@ес{ОЦес+. Параметр В4е — дескриптор контекста, а пара- 
метр №4106} — дескриптор кисти, пера или шрифта. 


ЗепаМез5асе — посылает указанное в ней сообщение окну 
или множеству окон 


Посылает указанное в ней сообщение окну или множеству окон и не воз- 
вращается, пока это сообщение обрабатывается 


Заголовочный файл И’/тизег.й 


Синтаксис 

ТВЕЗОГТ бепаМеззаае (НММО ВМпа, // дескриптор окна - приемника 
ОТМТ Мза, // сообщение 
ИРАВАМ мРагам, // первый параметр сообщения 
ТРАКАМ 1Рагап // второй параметр сообщения 

); 

Описание 


Функция Зеп4Меззаее посылает указанное в ней сообщение окну или 
всем окнам верхнего уровня в системе, включая недоступные и невидимые, 
кроме дочерних. Функция не возвращается, пока это сообщение обрабатывает- 
ся. Таким образом, приложение, пославшее сообщение, блокируется на время 
его обработки. Этим функция ЗепаМез$заее отличается от функции Ро$&Мез- 
заге, которая возвращается сразу после передачи сообщения. 

Параметр В\У’’п — дескриптор окна, которому передается сообщение. 
Если этот параметр равен Н\УМО_ ВВОАРСАЗТ, то сообщение передается 
всем окнам верхнего уровня в системе, включая недоступные, невидимые, пе- 
рекрытые другими и всплывающие, за исключением дочерних окон. 

Параметр М$й определяет передаваемое сообщение. Параметры мРагат 
и 1Рагат могут содержать дополнительную информацию. 

Значение, возвращаемое функцией, зависит от вида сообщения. 

Приложения, использующие В\У/п4 = Н\"МО_ВКОАОСА$ЗТ для связи ме- 
жду окнами разных приложений, должны предварительно зарегистрировать 
уникальность своих сообщений функцией Вер1$ {ег \т4ом\Меззаее. 

Примеры использования функции вы найдете в разд. 1.4, 1.7, 3.11, 4.3, 
5.1.1, 5.1.2, 5.1.4, 5.2.1, 5.2.2.3. 


зе АгеП1гесНйоп — устанавливает направление рисования окружности 
См. функцию Аге. 
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эеёАггитеп{5 — метод интерфейса 15веТлиК 
См. функцию Се Аггитепф$. 


эеСарёиге — захват курсора мыши 


См. разд. «ВееазеСар$иге и другие функции, управляющие захватом кур- 
сора мыши». 


зе СИрБоага\У1емег — включает свое окно в цепочку СИрБоага 
См. функцию СИрБоаг4. 


зе {СоштВгеаК — перевод порта в состояние разрыва связи 
См. функцию РаггеСотт. 


эеСотшМаз$К и другие функции, управляющие отслеживанием 
событий порта 


Управляют отслеживанием событий порта 


Синтаксис 
ВООГ 5ееСоппМаз К (ТМ НАМОЬЕ РЕ11е, ТМ ОМОКО АмЕхЕМазК); 


ВООГ СееСомиМазкК (ТМ НАМОЪЕ ВЕ11е,ООТ ЬБРЬМОКОР 1рЕуЕМазКк); 


ВООТ Ма1®СоттЕхеп® (ТМ НАМОТЕ ВЕ1]е,ООТ ГРЬОМОВР 1рЕу%Мазк, 
ТМ ГРОУЕВБТАРРЕР 1рОуег]арреа); 


ВОО СееОо0уег]арреЯВези1* (ВЕ11е, ТОуег1арреа Оуег1арреч, 
РИОВР 1рМатрегОЕВусезТгап$Еегкгеа, 
ВООГ ЮМа1®); 


Описание 

В асинхронный режиме работы с портом вы можете указать системе, ка- 
кие события ей надо отслеживать. Это делается с помощью функции 
Зе СоштМазК. Параметр ВЕПе является дескриптором порта, а параметр 
4\Еу Ма$зК является маской, в которой можно указывать комбинацию сле- 
дующих событий: 


ЕУ ВВЕАК Разрыв приемной линии. 


| 
_—_щ— НО о а а о ан а ще. ана - 
— | 


Изменение состояния линии г СТЗ. 


Изменение состояния линии Во 


| _ 
ЕУ_ЕВВ ООО 


ЕУ_В1И\МС Входящий звонок на модем — ОИ И 
ВУ ВХСНА ВГ5)О Изменение состояния линии вт.50 о о ОВ 
| 


Ошибка 


ЕУ_ ВХСНАВ, Принят символ и помещен в приемный и буфер. ООО 


ТРСВ, использованной при настройке порта _ 


| 
БУ. ВХЕГАС Принят символ, заданный полем ЕУ&СВаг структуры типа 
| 


| ЕУ_1 ТХЕМРТУ | _Передан пс последний символ буфера передачи_ 


Если параметр 4мЕ\Маз$К в функции Зе СоттМа$К равен нулю, ника- 
кие события не отслеживаются. 


5е{Сотт5{а{е — устанавливает параметры порта 681 


Функция @беСотт Ма$К позволяет получить текущую маску событий. 
Она заносит маску в переменную, заданную параметром 1рЕ\&МазЁК. 

Если вы задали маску отслеживаемых событий, то можете приостановить 
выполнение приложения до наступления события. Это делается функцией 
УМа{СотштЕуеп{. В параметр 1рЕ\у&Маз$ЕЁ будут заноситься флаги, соответст- 
вующие произошедшим событиям. Параметр 1рОуе ]арред является указате- 
лем на структуру типа ТОуе[арреч (см. ее описание в данной главе). Если вы 
хотите просто приостановить выполнение до появления соответствующего со- 
бытия, параметр 1рОуеарре можно задать равным МО. 

Можно отказаться от использования функций ожидания событий. Тогда 
в процессе выполнения приложения следует периодически опрашивать систе- 
му, чтобы получить информацию о завершении записи или чтения. Опрос про- 
изводится функцией Се Оуе арредВези 4. Параметр ВЕПе — дескриптор пор- 
та, параметр 1рОуеарре — адрес записи типа ТОуе]арред. Параметр 
]рМишегО{ВуёеТгап$Ёеггед указывает переменную, в которой отображается 
число записанных или прочитанных байтов. Параметр 6\Уай указывает, 
должна ли функция ждать окончания операции чтения или записи. Если за- 
дать значение этого параметра равным фгие, то функция будет ждать оконча- 
ния соответствующей операции, и, следовательно, будет реализован практиче- 
ски синхронный режим. А если задать 6 \а\ц = #а15е, функция немедленно 
вернет управление. Если возвращенное функцией значение равно фгие, значит 
соответствующая операция записи или чтения завершилась. В этом случае 
1рМишЬегО{ВуёеТгап$Ёегге4 укажет число переданных байтов. Если возвра- 
щенное значение равно #а]$е, значит операция не завершена или получилась 
ошибка в вызове функции Се Оуеарред Везий. Различить эти два варианта 
можно функцией СеП.а$4Еггог. Если она вернет ЕВКОВ_ТО_ПМСОМРГЕТЕ, 
значит все нормально, но операция не завершилась. В противном случае — 
ошибка в вызове функции Се ОуегарреЯВези 4. 

Примеры применения всех рассмотренных функций даны в разд. 2.5.3. 


Зе Сотш(афе — устанавливает параметры порта 
См. функцию деСотшт{афе. 


зеСотт’.Типеоц{$ — устанавливает временые параметры порта 
См. функцию вбеСошштфафе. 


эеСигзогРоз — устанавливает курсор мыши в заданные координаты 
См. функцию @е{СигзогРоз. 


Зе Дезсг1рИоп — метод интерфейса ТЗвеТ лик 
См. функцию ве Агхитеп&$. 


Зе ЕпугоптетУаг1а ]е — задает значение переменной 
См. функцию Се Епугоптепт{ $ 1т5$. 
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зе Еуеп{ и другие функции управления событиями 


Управляют состоянием события 
Синтаксис 
ВОО бесЕуеп® (НАМОЬЕ ПЕуеп®); 


ВОО Ш ВезеЕЕуепт® (НАМРЬЕ БЕуеп®); 
ВОО Ра1зеЕуепЕ (НАМОГЕ НЕуепе); 


Описание 

Функции Зе Еуеп и Везе Еуеп устанавливают объект события (см. 
разд. 3.5) в сигнальное и несигнальное состояние соответственно. Функция 
Ри15еЕуеп{ эквивалентна последовательному выполнению функций Зе Еуеп% 
и Везе{ Еуепф. В случае события с ручным сбросом это позволяет всем потокам, 
которые ждут событие и могут немедленно завершить ожидание (например, 
ждут только это событие), выйти из ожидания. Затем функция Ри[$еЕуеп$ пе- 
реводит событие в несигнальное состояние и возвращается. Для событий с ав- 
томатическим сбросом функция позволяет одному из ожидающих потоков 
выйти из ожидания (если это возможно), после чего переведет событие в несиг- 
нальное состояние и вернется. 

См. примеры применения функций в разд. 3.5. 


Зе ЕПеРойцег — изменяет текущую позицию файла 
Изменяет текущую позицию файла, открытого функцией Сгеа4еЕ Пе 
Заголовочный файл илтбазе.й 


Синтаксис 


#Тп0с1аае <и1пБазе.в> 

ОМОКО ЗееЕ11еРо1зпеег (НАМОЪЕ ВЕ11е, ТОМС 10156апсеТоМоуе, 
РЪОМС 1рр15$апсеТоМоуеН1оап, 
РИОКО АмМохеМеероа); 


Описание 

При синхронном чтении и записи в файл нередко требуется выполнять 
операции позиционирования, т.е. перемещения курсора на заданную текущую 
позицию в файле. Эта операция выполняется с помощью функции 
зе гПеРоп\ег. 

Параметр ВЕПе — дескриптор файла, в котором требуется проводить пози- 
ционирование. Параметр НПУ$&апсеТоМоуе — число байт, на которое требуется 
переместить курсор. Положительная величина соответствует перемещению 
вперед, к концу файла. Отрицательная величина означает перемещение к на- 
чалу файла. 

Максимальное 32-разрядное значение, которому может равняться 
1П1$ $ апсеТоМоуте, соответствует размеру файла примерно в 4 гигабайта. Если 
ваш файл укладывается в этот размер, то параметр 1р01$фапсеГоМоуе НВ 
следует задать равным МО1Т.. Если же вы имеете дело с файлом большего раз- 
мера, то можете задать параметр 1рП1$$апсеТоМоуеН1В. Он указывает на 
старшее слово 64-разрядного числа, определяющего общее смещение. Таким 
образом, суммарный сдвиг будет определяться совокупностью значений П\5- 
фапсеТоМоуе и 1рО1$$апсеТоМоуеН1еВ. Тогда максимально возможный сдвиг 
составит 2 в 64-ой степени. 

Параметр 4 МоуеМе{По4 — указывает, относительно какой точки отсчета 
будет произведен сдвиг. Возможны следующие значения этого параметра: 


$е{Сгар<5Мо4е — задает графический режим для преобразования координат 683 


ЕТЕ_ВЕСИМ 
ЕП.Е_ СОВКЕМТ |сдвиг относительно текущей позиции в файле 
ЕЕ _ЕМО 


Функция возвращает младшее слово новой позиции в файле. Если вы за- 
давали параметр 101$ апсеТоМоуеНИ$ В, то в переменную, на которую указы- 
вает этот параметр, заносится старшее слово новой позиции. Если при выпол- 
нении функции произошла ошибка, то возвращается значение ОхЕЕКЕЕЕЕР. 
Тогда причину ошибки можно определить вызовом функции Се Таз Еггог. 

См. пример в разд. 6.1.2, 6.7.3. 


Зе{Сгарс$Мо4е — задает графический режим для преобразования 
координат контекста 


Задает графический режим, необходимый для преобразования координат 
контекста 


Заголовочный файл : штоа1.А 


Синтаксис 


#1пс1аае <и1паат.6> 
ИТМСОТАРТ 1пе ЗеЕеСгарН1с$Моае (ТМ НОС Вас, ТМ 116 1Моае); 


Описание 

Функция Зе Сгар1с$Моде устанвливает графический режим, необходи- 
мый для преобразования координат контекста устройства (см. разд. 5.5.1). Па- 
раметр №4е — дескриптор контекста устройства, а параметр 1Моде может при- 
нимать одно из двух значений: СМ СОМРАЛИВГЕЕ — режим, совместимый 
с У1т94о\мз 3.1, или @М_АБУАМСЕО — режим более современных версий 
У\Уштао\з. По умолчанию в УшШ94о\мз устанавливается режим СМ_СОМРА- 
ТТВГЕ, в котором функция Зеё \УогАТгап$Ёогт не работает. Так что перед вы- 
зовом функции Зе\Уог9АТгап$Рогт надо установить функцией ЭеСга- 
рые5Мо4е режим @СМ_АШУАМСЕРБ. 

См. примеры применения функции в разд. 5.3.1.3, 5.5.2, 5.5.3. 


Зе{Но{Кеу — метод интерфейса ГЗВеШликК 
См. функцию де Агбитепт{$. 


Зе ЙсопГосаНоп — метод интерфейса ТЗвВе!И тк 
См. функцию Се Аггитеп$. 


Зе а Еггог — устанавливает код ошибки 
См. функцию Се Таз$Еггог. 


Зе МепиЦеп по — задает свойства раздела меню 
Задает свойства раздела меню 
Заголовочный файл И’тизег.й 


Синтаксис 


#$аеЁ1пе ЗееМепоаТеепТпЕо бе МепоаТеепТплЕоА 
#АаеЁЕ1пте ЗееМепаТеещТптЕо ЗбееМепоаТфепТптЕой 
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ИТМОЗЕКАРТ ВООГ ИМТМАРТ бе МепоаТфетТпЕоА (ТМ НМЕМО ЮМепча, 

ТМ ОТ\МТ аЦК еп, 

ТМ ВОО ЕВуРо$1Етоп, 

ТМ ГРСМЕМОТТЕМТМЕОА 1рп11); 
ИТМОЗЕКАРТ ВООПШ ИТМАРТ 5еЕМепаТеепТпЕой (ТМ НМЕМО ЮМепла, 

ТМ ОМТ «ацеп, 

ТМ ВООБЬ ЕВуРоз11оп, 

ТМ ГРСМЕМОТТЕМТМЕОМ 1рт11); 


Описание 

Функция Зе МепиЦен по задает свойства существующего раздела меню. 
Параметр ВМепи является дескриптором меню. Параметр иЦет определяет 
раздел меню. Его смысл зависит от значения параметра #ВуРо$ 1оп. Если 
ВуРо510оп = фгае, то иЦет — это индекс раздела (индекс первого разде- 
ла — 0). Если же #{ВуРо$110оп = Ёа5е, то иЦет — это идентификатор раздела, 
т.е. идентификатор связанного с ним сообщения. Например, если первый раз- 
дел меню (индекс 0) связан с введенным вами сообщением ЭС_МуЦет, то при 
вызове функции можно задать и Цет = 0 и {ВуРо$1оп = фгое, или иЦет = 
5С_МуЦет и #{ВуРоз11оп = Ёа[5е. 

Параметр 1рши является структурой типа ТМепиЦет 0 (см. ее подроб- 
ное описание в данной главе), задающей набор характеристик раздела. 

Функция возвращает ненулевое значение при успешном выполнении и 0 
в случае ошибки. В этом случае подробную информацию об ошибке можно по- 
лучить с помощью функции Се Газ Еггог. 


зе Ра — метод интерфейса 1ЗВеШпкК 
См. функцию Се Аггитепф$. 


зе РногЦу(С1а;5 — позволяет установить приоритет выполнения 
процесса 


См. функцию Се РиногцуС1а 5$. 


ЗезвомСт@4 — метод интерфейса Г5веТлокК 
См. функцию Се Аггитеп$. 


ЗеТипейопе огта Йоп — задает информацию о дате и времени 
с учетом временного пояса 


См. функцию де Типейопе {огтай оп. 


Зег\ацЦаШеТипег — активирует таймер 
Активирует таймер 
Заголовочный файл И’мизег.й 


Синтаксис 


ВООГ Зе МазЕаБ]1еТ1тег (ТМ НАМОЬЕ ВТ1мек, 
Т№ сопзЕ ТАВСЕ ТМТЕСЕВ *1ррчеТл1те, 
ТМ ГОМС 1Регзтоа, 
ТМ РТТМЕВАРСВООТТМЕ 
рЕпСопр1ее1опВоче1пе, 
ТМ ГРУОТО 1рАгдТоСотр1ее1опКоце1пе, 
ТМ ВООТ ЕВезоме); 


5е{ М/аМаЫеТ!тег — активирует таймер 685 


Описание 

Функция Зе \УаЦаеТ!тег активирует таймер ожидания (см. разд. 3.6), 
заданный своим дескриптором ВТипег. Параметр 1рОиеТ!те является указа- 
телем на структуру типа _ГАКСЕ ТМТЕСЕВ: 


суреаеЕ ип1оп _ТАВСЕ ТМТЕСЕВ { 
ЕКаСе { 
РИОКР ЪомРаге; 
ТОМс НлапРаг®; 
}; 
ТОМСЬОМС ОчааРаг®; 
} ТАВСЕ ТМТЕСЕВ; 


Эта структура, хранящая время в сотнях наносекунд, является объедине- 
нием, которое хранит данные или в 64-разрядном поле @цааРагф, или, если 
компилятор не поддерживает 64 бита, то в полях ГомРаг и Нав Раг 

Если при вызове Зеё \УаЦаеТ1тег в структуре заданы положительные 
значения, это указывает на момент времени, в который таймер должен пе- 
рейти в сигнальное состояние. Отрицательные значения задают относитель- 
ное время — через какой отрезок времени таймер перейдет в сигнальное со- 
стояние. 

Параметр 1Рег1о4 определяет период срабатывания таймера. Если 1Ре- 
1104 = 0, таймер сработает (перейдет в сигнальное состояние) только один раз. 
Если задано положительное значение 1Рег1о, то таймер будет срабатывать 
многократно, вплоть до его сброса функцией Сапс@\УаЦаШеТ1тег или до его 
переустановки новым вызовом функции её \УаЦаШеТ!1тег. Периодически ра- 
ботающий таймер переключается в сигнальное состояние в конце каждого пе- 
риода, а затем переходит в несигнальное состояние и ждет наступления сле- 
дующего периода. При отрицательном значении параметра ПРег1о4 функция 
Зеё\УаЦаеТ!тег возвращает #а15е. 

Параметр рЁ2пСошрейопКоцИпе указывает функцию завершения, кото- 
рая вызывается при переходе таймера в сигнальное состояние. Если указать 
параметр р‚7пСотрейопВоц# ше равным МОШЩШ,, никакая завершающая функ- 
ции не задается. Но можно в качестве параметра р#пСотрейопВои# те ука- 
зать функцию завершения, тип которой объявлен так: 

ЕуредеЕ Уотр (АРТЕМТВУ *РТТМЕБАРСВООТТМЕ) ( 

ТРУОТР 1рАгчТоСопр1е1опВочезпе, 


РИОВКО амТ1мех’гГомУа1ае, 
РИОВрР АмТ1тегН1авУа1ае); 


Ее параметр 1рАг=ТоСотр]ейопВоцИпе указывает произвольную структу- 
ру или иной тип данных. Этот указатель передается параметром 1рАгеТоСотр- 
1енопВКопИпе функции её \УаЦаеТитег в момент активизации таймера. Че- 
рез этот параметр можно передать в функцию завершения какую-то информа- 
цию. Например, текст, сообщающий о событии, связанном с таймером. Пара- 
метры 4\мТипегГомУаше и 4\ТпегН1о В УаШе соответствуют полям структу- 
ры типа ЕЕИМЕ, содержащим информацию о времени, когда таймер пере- 
птел в сигнальное состояние. 

Параметр {Везите имеет смысл при работе на компьютерах, поддержи- 
вающих спящий режим. Если этот параметр равен фгие, то при срабатывании 
таймера компьютер выйдет из спящего режима, и ожидавшие его потоки нач- 
нут выполняться. Таким образом, компьютер, даже находящийся в спящем 
режиме, напомнит вам о какой-то важной встрече или о телефонном звонке, 
который вы обязательно должны сделать. Если вы задали Везате = фгоие, 
а компьютер не поддерживает спящий режим, вызов функции Зе \УаЦаБ- 
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1еТипег завершится нормально, но последующий вызов функции Се аз Ег- 
гог вернет значение ЕВКОВ_МОТ_ЗОРРОВТЕЮ — режим не поддерживается. 
См. примеры применения функции Зе \УаЦаеТ1 тег в разд. 3.6. 


зе \/шд4омГопе, Се \УштдомГТ.опх — управляют стилем окна 
Задают и определяют стиль окна 
Заголовочный файл И7пизег.й 


Синтаксис 


ТОМС ИТМАРТ 5ееМ1паомГопа (ТМ НИМР В\па, тм 1п6Е отлаех, 
ТМ ОМС амМемЬопа); 
ТОМС ИТМАРТ Сее\1паомЬопа (ТМ НИМО В\па, тм 1пе пТпаех); 


Описание 

Функция Зе \УтдомТ,опе задает стиль окна. Параметр В\У/п@ является 
дескриптором окна. Если функция должна применяться к еще не созданному 
окну, в качестве параметра В\/п@4 можно использовать дескриптор приложе- 
ния АррПсайоп->Нап@е. 

Параметр пех задает относительное смещение того значения, опреде- 
ляющего стиль, которое изменяется данной функцией, а параметр 4мМемТ.опй 
определяет задаваемое новое значение. 

Функция де шдомГ.опй возвращает существующий в данный момент стиль 
окна. Смысл параметров В\УпЯ и шШп4ех тот же, что и для функции 
эег\/тдомТ.опг. Таким образом, чтобы изменить стиль окна, можно получить те- 
кущее значение составляющей стиля функцией Се \У/т4о\мТопй, изменить и пе- 
редать это измененное значение третьим аргументом в функцию Зе М тдомТоп?. 

В обеих функциях возможные значения параметра шШп4ех лежат в преде- 
лах от 0 до числа байтов в дополнительной памяти окна минус 4. Например, 
если вы задали не меньше 12 байтов дополнительной памяти, то значение 
п шаех = 8 укажет на третье 32-разрядное целое. Смещение может также зада- 
ваться следующими константами: 


С\Т_ ЕХЗТУГЕ ‚Задает новый расширенный стиль окна. 


—_ 
СУТ ЭТУГЕ Задает новый стиль окна. 


С\УГ_ \МОРКВОС Задает новый адрес процедуры окна. | 


С\Т_НТМ5ТАМСЕ Задает новый дескриптор экземпляра приложения. 


СУТ, Ш Задает новый идентификатор окна. 


СУТ ОЗЕКОАТА Задает значение 32-разрядной величины, связанной с ок- 
ном. Подобная величина может задаваться для каждого 

окна и использоваться произвольным образом в прило- 
жении, создающем окно. 


Для диалоговых окон дополнительно возможны значения: 


О\УГ ОГСРВОС Задает новый адрес диалоговой процедуры. 


О\Г МЫСВЕБЗОГТ |Задает значение сообщения, вырабатываемого диалого- 
вой процедурой. 


ОРУТ О5ЕК Задает дополнительную информацию, специфичную для 
приложения, например, дескрипторы и указатели. 


$е\ММптаомиР!асетеп* — задает местоположение окна формы 687 


Каждая составляющая стиля является комбинацией различных флагов. 
Эти флаги вы можете посмотреть в справке ит323аЕ.Мр. 

В данной книге приведено несколько примеров применения функций 
Зе шдомТопе и Се \Ут9домГопрг. В разд. 1.9 дается пример создания при- 
ложения — невидимки. Для этого значение шп4ех надо задать равным 
С\Т, ЕХЗТУГЕ, а значение амМемГопй задать соответствующим флагу 
\М5_ЕХ_ТООГМТМООУ.. В разд. 5.2.4 приведен другой пример — создание 
окон компонентов с изменяемыми пользователем размерами. Для этого значе- 
ние ппдех надо задать равным СУГ. ЭТУГЕ, а к текущему стилю, возвра- 
щаемому функцией, добавть значение флага М5 _ТШСКЕКАМЕ или 
\5_5Т2ЕВОХ. 


Зе тдочР]асетеп{ — задает местоположение окна формы 
См. функцию Се \тдомР1асетепф. 


Зе ш4омРо$ — изменяет параметры окна 


Изменяет размер, местоположение и позицию в Й-последовательности до- 
чернего окна, всплывающего окна, или окна верхнего уровня. 


Заголовочный файл И7пизег.й 


Синтаксис 


#11с]пАе<илпазег. [> 

ВООГ МТМАРТ ЗеЕ\1паоиРоз$ (ТМ НИМО Рипа, тм НУМО Р\паТозее к АЕсег, 
ТМ 11е Х,Т1М 1106 У,ТМ 116 сх,1М№М 1106 су, 
ТМ ОТМТ оЕ1ааз); 


Описание 

Функция Зе \т4омРо$ изменяет размер, местоположение и позицию 
в 2-последовательности дочернего окна, всплывающего окна, или окна верхне- 
го уровня. Параметр В\У/п4 указывает дескриптор отображаемого окна. Пара- 
метр В\’пЧТтзег( АЁег определяет положение окна в Й-последовательности: 


Н\УМР ВОТТОМ Внизу (перекрывается другими окнами). 


НУ\УМО МОТОРМОЗТ Выше всех окон, не имеющих статуса «поверх 
других», но ниже окон, имеющих этот статус; ра- 
ботает, только если окно в данный момент имеет 
статус «поверх остальных». 


Н\УМО_ ТОР На вершине 7-последовательности (перекрывает 
все прочие окна); работает только для активного 
окна. 


Н\УМО_ТОРМОЗТ То же, что Н\УИМО_МОТОРМОЗТ, но работает 
даже для неактивного окна. 


Параметры Х, У, сх, су указывают соответственно координаты левого 
верхнего угла, ширину и высоту окна. Но эти параметры не учитываются при 
соответствующих флагах, включенных в параметр иЕ1а5$. 
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Параметр иЁЕР]а5$ является комбинацией различных флагов: 


э\Р РКА\ЕКАМЕ Рисовать рамку (фрейм) вокруг окна. 


Э\Р_ ЕКВАМЕСНАМСЕО Послать окну сообщение \УМ_МССАТСЗТАЕ, даже 
если окно не должно изменять размеры. При отсут- 

ствии этого флага сообщение \УМ_МССАГСФТЕЕ по- 

сылается только в случае изменения размеров окна. 


э\Р_НГШЕМТМОО\М” Сделать окно невидимым. 


5 \УР_МОАСТТУАТЕ Не активизировать окно. Если этот флаг не уста- 
новлен, окно активизируется и перемещается на 
верх последовательности окон, указанной пара- 
метром В\Упашзе АЁег. 


$\УР_МОСОРУВГТ$ 


Не учитывать содержание клиентской области 
окна. Если этот флаг не указан, то содержимое 
клиентской области сначала сохраняется, а затем 
копируется обратно в окно после изменения его 
размеров или после перемещения. 


Э\УР_МОМОУЕ Сохранить текущее положение (игнорировать па- 


раметры Х и У). 


эЗ\Р_ МООММЕВИОКВОЕВ |Не изменять позицию окна-владельца в Й-последо- 


вательности. 


Не перерисовывать изменения. Если этот флаг 
установлен, автоматической перерисовки окна не 
произойдет, и приложение должно явным образом 
перерисовывать необходимые части окна. 


5 \Р_МОВЕРОЗТТТОМ То же что 5\Р_МООММЕВ2ОВШЕК. 


э\УР_МОЗЕМОСНАМСТМС | Предотвращает получение окном сообщения 
\М_\УТМРОМРО$СНАМСТХС. 


$ \УР_МО5ЗТАЕ Сохранить текущие размеры (игнорировать пара- 
метры сх и су). 


5 \”Р_МО2ОВЬЕКБ, Сохранить текущую позицию в объект 7-последо- 
вательности (игнорировать параметр В\Уп@Тезег- 
{АЁег). 


Примеры применения функции вы найдете в разд. 2.3.5, 5.2.1, 5.2.4. 


Зе \Уш4омВяп — задает окну сформированный регион 
Задает окну сформированный регион. 
Заголовочный файл И7пизег.й 


Синтаксис 

#Т0с10аАе <И1пизегк.|Н> 

1пЕ бееИ1паомКап (ТМ НИММР В\па, тм НВСМ РВап, ТМ ВООЪ БВе@агам); 

Описание 

Функция Зе \УтдомВеп задает окну, указанному своим дескриптором 
Ь\’п@, сформированный регион (см. разд. 5.2.2.1), указанный своим дескрип- 


$е\/Иптаому$НооКЕх, Уппоок\М/таоми$НооКЕх — регистрация ловушки 689 


тором ВВт. Параметр 6БКедгам должен быть равен фгие, если надо немедлен- 
но после задания региона перерисовать окно. Как правило, для видимых окон 
это необходимо. 
Функция возвращает ненулевое значение, если выполнилась успешно. 
Примеры применения функции приведены в разд. 1.7, 5.2.2.2, 5.2.2.3, 
5.3.1.2, 5.3.1.3. 


Зе \Ушдом$НооКЕх, Оппоок\тдом$НоокКЕх — регистрация ловушки 
Регистрация ловушки сообщений У/1тп94о\з 
Заголовочный файл Утизег.й 


Синтаксис 


ННООК ЗееИ1паомзНоокКЕх (116 1АНоок, НООКРКОС 1рЕп, 
НТМ5ТАМСЕ Птоа, ОМОВО амТЬгеаата); 


ВОО ОпвоокКИ1паом$НоокКЕх (ННООК ВВК); 


Описание 

Регистрация ловушки сообщений У/т9до\уз (см. разд. 4.3) осуществляется 
функцией Зе \тдомзНооКЕх. Параметр 1АНооК задает тип регистрируемой 
ловушки. Он может принимать значения: 


\Н_САСГ\ММОРВОС Ловушка для перехвата сообщений до того, как они 
будут посылаться в окно, которому предназначены. 
Представляется в виде функции СаП\У/паРГгос. 


\Н_САГТММОРКОСКЕТ | Ловушки для перехвата сообщений после того, как 
они обработаны в окне, которому предназначены. 
Представляется в виде функции Са|П\/паВе{Ргос. 


Ловушка большинства сообщений окон (создание, 
активация, перемещение, изменение размеров, 
уничтожение), мыши, клавиатуры, системных 
команд. Представляется в виде функции СВТРгос. 


\Н_ОЕВОС Ловушка для отладки других ловушек. Представ- | 
ляется в виде функции ОефизРгос. | 

\Н_СЕТМЕЗЗАСЕ Ловушка сообщений, переданных функцией Се Мез- 
заре. Представляется в виде функции Се М5еРгос. 


\Н_ТОЧКМАГРГАУ- Ловушка, вставляющая сообщения клавиатуры 
ВАСК и мыши в очередь системных сообщений. Пред- 
ставляется в виде функции 3 оигпа]Р1ауБасКРгос._ 


ИН И 


\Н_ТООВМАТГВЕСОВКО Ловушка сообщений, пересылаемых из очереди си. 
стемных сообщений и удаляемых из нее. Пред- | 
ставляется в виде функции доигпа|ВесогаРгос. 


\УН_КЕУВОАВО Ловушка сообщений клавиатуры. Представляется 
в виде функции КеуБоагаРгос. 

У\Н_МООЗЕ Ловушка сообщений мыши. Представляется в виде 
функции МоцбеРгос. 


\Н_МЗСЕП.ТЕВ, Ловушка сообщений, генерируемых при вводе 
в диалоговые окна, окна сообщений, при работе 
с меню и полосами прокрутки. Представляется 
в виде функции МеззаргеРгос. 


о 
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\Н_5НЕШ, Ловушка сообщений приложений-оболочек (созда- 
ние и уничтожение окна, активизация). Представ- 
ляется в виде функции 5ВеПРгос. 


У\УН_5УЗМЗСЕП.ТЕВ, Ловушка сообщений, генерируемых при вводе 
в диалоговые окна, окна сообщений, при работе 
с меню и полосами прокрутки. Реагирует на все 
подобные сообщения в системе. Представляется 
в виде функции ЗузМзеРгос. 


Параметр Ша функции Зе \Утдом$НоокКЕх является указателем 
на функцию ловушки. Место реализации этой функции определяется парамет- 
ром амТвВгеа ТА. Этот параметр может указывать поток, для которого устанав- 
ливается ловушка, или может быть равен 0, что означает установку ловушки 
для всех потоков. Если параметр д\ТЬгеа 91а равен 0 или указывает на поток 
процесса, отличного от текущего, тогда параметр рп должен указывать адрес 
функции ловушки, помещенной в ОШ.. В этом случае параметр ВМо4 является 
дескриптором модуля ОГ, содержащего ловушку. Если же параметр 
4\ТЬгеа 1 указывает на поток текущего процесса, то функция ловушки, 
на которую указывает рЁп, может размещаться в модуле исполняемого файла, 
связанном с этим процессом. 

Вызов функции Зе \т4домзНооКЕх устанавливает (регистрирует) ловуш- 
ку и возвращает ее дескриптор. Удаление ранее зарегистрированной ловушки 
производится функцией Опвоок\УЛтдом$НооКЕх. В нее передается единствен- 
ный аргумент ВВК — указатель на функцию ловушки. 

Заголовок всех функций ловушек имеет одинаковую структуру: 


11 __36аса11 имя(1пе соае,1пе мРагаш, 1п%& 1Рагам) 


Но смысл и возможные значения параметров со4е, \“Рагат и [Рагат зави- 
сят от вида функции. 
См. примеры разработки ловушек в разд. 4.3. 


Зе \Уш4о\Тех{ — изменяет текст окна 
Изменяет текст указанного окна 
Заголовочный файл И7пизег.й 


Синтаксис 


#1п0с1аае <милпазег. [> 
ВООЪ ИМТМАРТ Зее\М1паомТехе (ТМ НИМО Рйпа, 
ТМ ГРСЗТК 1р5Ег1па); 


Описание 

Функция Зе \ш4омТехё задает текст, связанный с указанным окном 
или оконным элементом. Под текстом окна подразумевается или текст заго- 
ловка для окон форм, или текст окна редактирования, или имя панели и т.п. 
Параметр В\’п4 — дескриптор окна, который. Параметр 1рЭи`шще указывает 
на буфер, содержащий задаваемый текст. 

Функция не расширяет содержащиеся в строке символы табуляции. Эти 
символы отображаются в окне в виде вертикальной черты «|». 

См. примеры применения функции в разд. 5.1.1 и 5.1.4. 


5е\/МопаТгап$Тогт — осуществляет трансформацию координат 691 


Зе\ог1ЧТгапогт — осуществляет трансформацию координат 


Осуществление трансформации координат контекста: поворот, зеркальное 
отображение, сдвиг, масштабирование 


Заголовочный файл и1п541.Й 


Синтаксис 


#10с10ае <и"1паа1.8> 


суредеЕ зегаосе ФадхгоОВМ 


{ 
ЕГОАТ —еМ11; 
ЕГОАТ еМ12; 
ЕГОАТ — еМ21; 
ЕГОАТ — еМ22; 
ЕГОАТ —е0х; 
ЕГОАТ —епу; 
} ХЕОВМ, *РХЕОВМ, ЕАВ *ГРХЕОВМ; 


ИТМСОТАРТ ВООГБ бе Мог1АТгапзЕогм (ТМ НОС Вас, ТМ СОМ$Т ХРОВМ *); 


Описание 

Иногда в приложениях требуется преобразовывать координаты изображений 
и надписей. Например, поворачивать под заданным углом, осуществлять зер- 
кальное отображение, сдвигать, масштабировать и т.п. Это можно делать при по- 
лучении изображений и надписей на контексте устройства (см. разд. 5.5.1). 

Трансформация координат осуществляется функцией Зе \Уог1ЧТгап$- 
Гогт. Аргумент Ве является дескриптором контекста того устройства, коор- 
динаты которого подвергаются трансформации. Второй аргумент функции оп- 
ределяет адрес структуры типа ХЕОВМ, поля которой задают элементы мат- 
рицы линейного преобразования координат. 

Преобразование исходных координат Х и У в координаты Х’и У’ опреде- 
ляется соотношениями: 


х' Х : ем11 + У - еМм21 + е5дх, 
уУ' = Х : ем12 + У : ем22 + епу, 


Например, если надо просто сдвинуть изображение на еОх по оси Х и на 
е)у по оси У, следует в структуре ХЕОКМ задать еМ11 = еМ21 = еМ12 = 
еМ22 = 0, и установить требуемые значения еОх и еБу. 

Если при всех описанных далее преобразованиях надо сохранить непод- 
вижной точку с координатами (ХО, У0), например, центр изображения, то зна- 
чения еОх и еБу надо определять соотношениями: 

ерх = ХО - ХО - еМм11 - У0 - ем?21; 

еру = У%0 - ХО - емМ12 - \0 - ем22; 

Зеркальное отображение относительно оси с Х = ХО задается соотноше- 
ниями еМ12 = еМ21 = 0, еМ11 = -1, еМмМ22 = 1. Если элементы матрицы задать 
соотношениями еМ12 = еМ21 = 0, еМ11 = 1, еМ22 = -—1, то получится зеркаль- 
ное отображение относительно оси с У = У0, т.е. изображение перевернется. 
Если задать еМ1Т = еМ22 = М, еМ12 = еМ21 = 0, то изображение растянется 
(при М > 1) или уменьшится (при М < 1) в М раз. 

Поворот изображения на угол А осуществляется при задании еМ1Т = 
еМ22 = соз(А), еМ12 = з11(А), еМ21 = —з10(А). При необходимости осущест- 
вить более сложные преобразования, связанные с одновременным поворотом, 
сдвигом и изменением размера, вы можете сами по приведенным соотношени- 
ям вывести нужные соотношения. 
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Перед вызовом функции Зе \Уон@АТгап$огт надо предварительно вы- 
звать функцию Зе СгарШс$Моде, задав с ее помощью графический режим 
СМ_АБУАМСЕЮ. Иначе функция Зе Мог1АТгап$!огт не будет работать. 

Описанная трансформация координат контекста устройства с помощью 
функции Зе \Уог9АТгап$Ёогт возможно только начиная с УМ ш94домз М№Т/2000/ 
ХР. В У\У/шаомз 95/98 такая функция отсутствует. 

Примеры применения функции вы найдете в разд. 5.3.1.3, 5.5.2, 5.5.3. 


эНВгомзеЕогЕо]дег — позволяет выбрать папку в стандартном диалоге 


Предоставляет пользователю возможность выбрать в стандартном диалоге 
папку, как обычную, так и виртуальную 


Заголовочный файл оОЬБ.^ 


Синтаксис 
ЗНЗТРАРТ (ТРТТЕМТРЬТ$Т) $НВгомзегогРо1Чег (ТРВВОМ$ЗЕТМЕО 1рЬ1); 


Описание 

Диалог, вызываемый этой функцией, подобен вызываемому в первой фор- 
ме функции Заес ПО1гесфогу (см. разд. 6.5). Но функция ЗН@е $ реса1Ео]- 
егГосаЯоп обладает некоторыми дополнительными возможностями. Напри- 
мер, в качестве корневой можно задать любую обычную или виртуальную пап- 
ку. Подобных возможностей функция З@аес О1гесфогу не дает. 

Функция ЭНВгомзеЕогЕо4ег возвращает РПО, (см. разд. 6.2) выбранной 
пользователем папки или МОТГ, если пользователь не сделал свой выбор. 

Единственный параметр функции указывает на структуру типа 
ВКО\УЫМЕОА (ТВгомзе по), содержащую всю информацию, необходимую 
для вызова функции. Тип структуры объявлен следующим образом: 


суредеЕ з&госе БгомзелпЕол { 


НИМ `рипаОмпег; 
ТРСТТЕМТРЬТЗТ р191Боое; 
ЪРСОТК р5201$5р1ауМапе; 
ЪРСЫТК 1р$272Т161е; 

ОТМТ 11Е1а9$; 
ВРЕСАТЬВАСК 1рЕп; 

ТРАКАМ 1Рагам; 

1пе 1Тмаде; 


} ВВОИЗЕТМЕОА, *РВВОМЗЕТМЕОА, *ЬРВКОМЗЕТМЕОА; 


суредеЕ гомзелпЕоА ТВгомзеТпЕо; 


Поля структуры содержат следующую информацию: 


БД ООО ООО ПОЛОС ОКОВ 
Буа Очупег Дескриптор окна вызвавшего приложения | 
[т — — _ ОРТО В ОВЕЯ Вы о ннеаИИИИНИ 
| р191Кооф РШТ. папки, отображаемой как корневая 
в диалоговом окне 
`р$2015р!ауМате Возвращается имя выбранной пользователем 


папки 


Текст приглашения в диалоговом окне 


Флаги, определяющие, что именно может вы- 
брать пользователь в окне диалога 


Указатель на функцию обработки событий или. 


МО, — 


$Ле|_Мо{Тусоп — связь приложения с пиктограммой в 5у${ет Тгау 693 


ф ., | 
Определенный приложением параметр, переда- 


ваемый в функцию обработки событий 


Индекс системного списка значков, соответст- 
вующий выбранной папке 


Поле структуры и а$ может включать комбинацию следующих флагов: 


ВТЕ ВВОМ5ЗЕРГОВСОМРОТЕВ | Выбор только компьютеров 
ВГЕ_ВКОМЪУЕРЕОКРЕТМТЕКВ Выбор только принтеров 
В 


ТЕ РОМТСОВЕГОМООМАХ | Не включать в дерево сетевые папки, располо- 
женные ниже корневой папки 


ВГГ ВЕТОВМЕЗАМСЕЗТОВ5 |Выбор только предков системных папок 


ВТЕ_ ВЕТОВМОМГУЕ$ОТВ$ Выбор только системных каталогов 


ВТЕ_ЗТАТОЗТЕХТ Включать в диалог полосу состояния 


Задание флагов, определяющих выбор пользователя, приводит к тому, что 
выделение любых вершин дерева, не соответствующих этим флагам, не делает 
доступной кнопку ОК, так что пользователь не может произвести запрещен- 
ный выбор. 

Примеры применения функции ЭНВгомзеРогРо4ег даны в разд. 6.5. 


эНеП_Мо {Усоп — связь приложения с пиктограммой в Зуз{ет Тгау 


Осуществляет связь приложения с пиктограммой, размещенной в эузет 
Тгау. 


Заголовочный файл оРеПАРГ.Й 


Синтаксис 


ЗН5ТРАРТ_(ВООЪ) 5Ве11 Мо&1ЕуТсоп (РИОВР АмМеззасче, 
РМОТТЕУТСОМОРАТАА 1ррафа); 


Описание 

Связь приложения с пиктограммой, размещенной в Бузет Тгау (см. 
разд. 1.10), осуществляется функцией ЭВе]_МойЁУ[соп. Параметр 4\Меззахе 
указывает выполняемую операцию и может принимать значения: 


МТМ_АОО Добавить пиктограмму в область БЗуз4ет Тгау. 
| МУМ_РЕГСЕТЕ Удалить пиктограмму из области Буз4ет Тгау. 


МТМ_МОРОТЕУ Изменить изображение пиктограммы, текст ее 
ярлычка или идентификатор ее сообщения. 


Параметр 1Шр)а{а является указателем на структуру типа 
ТМой!Усоп)Оаёа, содержащую всю информацию о выполняемых операциях. 
Функция возвращает ненулевое значение при успешном выполнении и 0 в слу- 
чае ошибки. 

Тип ТМ№ойЁУ/[соп)афа имеет несколько вариантов, основной из которых 
объявлен следующим образом: 


суре4еЕ зЕгасЕ _МОТТЕУТСОМРАТА { 
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ОМОВО сЬ5127е; 
НИМО Вира; 
ОТМТ о1т0; 
ОТМТ оЕР]1адз; 
ОТМТ иСа11раскМеззасае; 
НТСОМ ПТсоп; 
#1Е ( И1М32_ТЕ < 0х0500) 
СНАК $2Т1р [64]; 
#е15е 
СНАВ $2Т1р [128]; 
фепа1тЕ 
#1Е ( И1№32 ТЕ >= 0х0500) 
ОМОВКО аАмЗтаее; 
РМОКО аАмзЗбаееМмазк; 
СНАК $2ТпЕо [256]; 
ип1оп 
{ 
ОТМТ аТ1пмеоцЕ; 
ОТМТ чУегз$1оп; 
} ПОММУОМТОММАМЕ; 
СНАК $2 пЕоТт1Е1е[64]; 


РИОВО АЧмТпЕоЕ1ааз; 
$епа1 Е 
#1Е ( М1№32_ ТЕ >= 0х600) 
СОТр аа1аАтТееп; 
#епа1Е 
} МОТТРУТСОМРАТАА, *РМОТТРУТСОМОАТАА; 


Поле с6512е указывает размер структуры. Поле \У/п@ определяет дескрип- 
тор окна, которое связано с пиктограммой и получает сообщения о перемеще- 
ниях над ней мыши. Поле а содержит номер размещаемой пиктограммы. 
Одно приложение может разместить в Зузвет Тгау несколько пиктограмм 
и ссылаться на них по этому номеру. Поле иСаШасКМеззаге задает идентифи- 
катор сообщения, которое будет посылаться при попадании курсора мыши 
в область пиктограммы. Поле Шсоп задает дескриптор пиктограммы. Поле 
$2Т1р содержит текст всплывающего ярлычка. Как видно из вышеописанной 
структуры, это поле в зависимости от версии У ш@Чомз может иметь разную 
длину. 

Поле иЕ1а5$ включает флаги, указывающие, какие поля структуры при- 
нимаются во внимание: 


Ы—— 
МТЕ ТСОМ Учитывается поле Шсоп 


МТЕ МЕЗЗАСЕ | Учитывается поле иСаПБасКМеззахе 


МТЕ ТР Учитывается поле з*Т1р 


Если вы разместили пиктограмму в области эуз4ет Тгау, надо обеспечить 
в приложении обработку сообщений о манипуляциях мышью в области этой пик- 
тограммы. Идентификатор этого сообщения вы задаете в поле аСаПБасКМеззасе 
записи типа ТМонРУТсопОа4а. В поле мРагат пришедшего сообщения вы мо- 
жете прочитать номер пиктограммы, который ранее задавали в поле и запи- 
си типа ТМонЁРУТсопОафа. А в поле 1Рагат пришедшего сообщения вы можете 
прочитать идентификатор сообщения, полученного от мыши, например, 
\М_ТВОТТОМОВГЕСЕК — двойной щелчок левой кнопкой. 

Примеры применения функции даны в разд. 1.10. 


$НеНЕхесшме — открывает или печатает указанный файл 695 


Зве|Ехесшще — открывает или печатает указанный файл 
Открывает или печатает указанный файл, открывает указанную папку 


Заголовочный файл 5йеПАРГ.А 


Синтаксис 

НТМУТАМСЕ $Бе11Ехесоаее ( 
НИМ Бмпа, // дескриптор родительского окна 
ТРСТЗТВ 1рОрега&1оп, // строка выполняемой операции 
ЪРСТ$УТВ 1рЕ11е, // строка с именем файла или папки 


ЪРСТЗТВ 1рРагамекегз,// строка параметров 
// выполняемого файла 
.РСТЗТВ 1рр1гесбогу, // строка каталога по умолчанию 


ТМТ пброиСсма // режим открытия файла 

); 

Описание 

Функция 5Ве|Ехесще позволяет выполнить любое приложение У/1п4о\мз. 
Можно также открыть файл документа, что означает выполнение связанного 
с ним приложения и загрузку в него этого документа. Например, обычно с до- 
кументами, имеющими расширение .4ос, связан УТога. В этом случае открыть 
файл, например, с именем “Ше.4ос” означает запустить У/ог4 и передать ему 
в качестве параметра имя файла "Ше.4ос”. Кроме описанных возможностей 
функция ЭвВе|Ехесше позволяет распечатать указанный файл или открыть 
указанную папку. Последнее означает, что будет запущена программа «Про- 
водник» с открытой указанной папкой. 

Параметры функции означают следующее: 


Параметр Описание 


щения запускаемого_ приложения. 


о приложения. _ 


рОрегайоп Указывает на строку с нулевым символом в кон- 
це, которая определяет выполняемую операцию. 
Эта строка может содержать текст «ореп» (от- 
крыть) или “рг1пё"” (напечатать). Начиная с У/т- 
Чо\з 95 определено еще одно значение: “ехр]оге” 
| (исследовать) — открыть папку. Если параметр 
1рОрегаЙоп равен МОТ, то по умолчанию вы- 
полняется операция «ореп». 


| 
Вугпа Родительское окно, в котором отображаются сооб- 
| 
| 
| 
| 
| 


Указывает на строку с нулевым символом в кон- 
це, которая определяет имя открываемого файла. 


о — — р 


 рРагатеёег$ Указывает на строку с нулевым символом в кон- 
це, которая определяет передаваемые в приложе- ‹ 
ние параметры, если ЕПеМате определяет выпол-' 
`няемый файл. Если 1рЕШе указывает на строку, 
‚определяющую открываемый документ, то этот 


__| параметр задается равным МОГГ. 


'рО1тесфогу Указывает на строку с нулевым символом в кон- 


це, которая определяет каталог по умолчанию. | 
ти —4 


‘ 15ро\Ст@Я Определяет, режим открытия указанного файла. 
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В свою очередь параметр пЗвВомСш@ может иметь значения: 


М} 
| $5 № НШЕ Окно делается невидимым и фокус передается 


—___ другому окну. НИ 


| 
5 \’_МИМТМТИЕ Свертывает (минимизирует) указанное окно и ак | 
тивизирует следующее в Й-последовательности | 
окно верхнего уровня в списке системы. | 


—щ 


Развертывает (максимизирует) указанное окно. 


3\ МАХИМТИЕ 
|5 \\_ВЕЗТОВЕ 


Активизирует и отображает окно. Если это окно 

свернуто или развернуто, то оно восстанавливает- 
ся до своих первоначальных размеров и отобра- 
жается в первоначальной позиции (почти то же 
самое, что 5\_ЗНОММОВМАГ). 


Активизирует и отображает окно в его текущей 
позиции и с текущими размерами. 


=— Ач 


Я 
| 
| 
| 


|83\_5НОм 


З\’_5ЗНОМ’РЕЕАОТ.Т Начиная с У\У1т4о\з 95. Устанавливает состояние 
в соответствии с флагом З\М/_ в структуре ЭТАВ- | 
'ГОРТУРЕО (см. ее описание в данной главе), пере- 
даваемой в функцию СгезжеРгосе$$ программой, | 
запускающей приложение. Приложение должно 
вызывать ЭВом 114 0ом с этим флагом, чтобы за- 


дать начальное состояние своего главного окна. 


— 


Активизирует и отображает окно в развернутом 
виде (максимизированном). 


\_5НО\М/МАХТМТИЕО 
\_ 5 


8 


‚3 НО\УМПИМТРЕР 


виде (в виде пиктограммы). 


- 

Активизирует и отображает окно в свернутом 
| 

- — — 


Отображает окно в свернутом виде (в виде пиктог-' 
раммы). Активным остается то окно, которое 
было активным до этого. 


_ 


Отображает окно в его текущей позиции и с теку- 
щими размерами. Активным остается то окно, ко-| 
торое было активным до этого. 


АА _ $НО\МТММОАСТТУЕ 
5\_ ЗНО\МА_ 


следними размерами. Активным остается то ОКНО, | 
‚которое было активным до этого. 


Активизирует и отображает окно. Если это окно 
свернуто или развернуто, то оно восстанавливает- 
ся до своих первоначальных размеров и отобра- 
жается в первоначальной позиции (почти то же 
самое, что 53\_ВЕЗТОВКЕ). 


ВУ _ ЗНО\’МОАСТТУАТЕ Отображает окно в его последней позиции и с по- 
ЭМ _ ЗНО\МОКЕМАТ, 


| 
и“ ОИ ПН 


| 
| 
| 


| 
| 


Функция возвращает дескриптор открытого приложения или дескриптор 
сервера приложения ПОПЕ. Если возвращаемое значение меньше или равно 32, 
это указывает на ошибку. 

Многочисленные примеры применения функции ЭвеПЕхесще вы найдете 
в разд. 1.4, 1.12, 2.3.3, 2.3.5, 6.6.1, 6.6.3, 6.6.5, 6.11. 


$НЕЙеОрегайоп — функция манипуляции с файлами и каталогами 697 


эНЕПеОрегаЙоп — функция манипуляции с файлами и каталогами 


Предоставляет способы манипуляций с файлами и каталогами: копирова- 
ния, перемещения, удаления 


Заголовочный файл бйеПАРГ.А 


Синтаксис 
ЗНЗТРАРТ (116) $НЕ11еОрега®1оп (ЪРЗНЕТЪЕОРЗТВОСТ 1рЕ11еор); 


Описание 

Функция ЭВЕПеОрегаЙоп предоставляет самые мощные по сравнению 
с иными способы манипуляций с файлами и каталогами: копирования, пере- 
мещения, удаления. В функцию передается единственный параметр 1рЕ1- 
1еОр — указатель на структуру, содержащую всю информацию о требуемой 
операции с файлами и каталогами. Тип этой структуры объявлен следующим 
образом: 


фуреаеЕ зЕгисе _ЗНЕТЬЕОРЗТВОСТ 
{ 


НМ Бипа; 

ОТМТ мЕапс; 

ЪРСЗТВ РЕгом; 

ЪРСЗТВ рТо; 

ЕТЪЕОР_ЕЪАСЗ ЕГ]ааз; 

ВООТ, ЕАпуОрега*1опзАрогееа; 
Т.РУОТО ЮМапеМарр1па$; 

.РСЗТВ ]1рз7РгодгеззТ1Е1е; 


} ЭНЕТЬЕОРЗТВОСТ, *ГРЗНЕТЬЕОРЗТВОСТ; 


Основное поле, определяющее производимую операцию — МРипс. В это 
поле можно записать одно из следующих значений: 


РО - ——_—  ———Щ—  ——— ии я] 
ГРО_СОРУ Копирование файлов, указанных в поле рЕгот, в файл или ка- 
. талог, указанный полем рТо. 

'РО_РЕГЕТЕ 


| 
‚Удаление файлов, указанных в поле рЕгот. Поле рТо игнори- 
руется. 
| 

| 

| 


РО _МОУЕ Перемещение файлов, указанных в поле рЕготш, в файл или ка- 
ШИ талог, указанный полем рТо. 
И - — 
 РО_ВЕМАМЕ | Переименование файлов, указанных в поле рЕгот. 


Поле рЕгот указывает буфер, содержащий имя или имена файлов, с кото- 
рыми производится заданная операция. Отдельные имена должны разделять- 
ся нулевыми символами. Завершаться список имен должен двумя нулевыми 
символами. | 

Поле рТо указывает буфер, содержащий имя файла или каталога, являю- 
щегося приемником. Если в поле Ё 1аё$ указан флаг ЕОЕ_МОТГТГЕ$ТЕП.Е$, 
то буфер может содержать список имен файлов. Отдельные имена должны раз- 
деляться нулевыми символами. Завершаться список имен должен двумя нуле- 
выми символами. 
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Поле На5$ может содержать комбинацию следующих флагов: 


РОЕ_АГГОМТОМОО ‘Сохранить по возможности информацию для 


| 
| ‚ отмены операции. Например, при удалении 
| 
| 


файлов они перемещаются в корзину, из ко- 
торой их потом можно восстановить. 


РОЕ_СОМЕ1ВММОЧЗЕ | Не реализован. 

РОЕ_ЕПЕЗОМГУ Осуществлять операцию только при задании 
о | шаблона «*, К». И — 
‚РОР_ МОГТТОЕЗТЕЦЕВ = Указывает, что поле То содержит не папку, 


куда надо доставить все файлы-источники, 
а множество имен приемников — по одному \ 
на каждый файл-источник. 


В 
| 
| 
| и 
| 


РОЕ_ МОСОМЕТЕМАТТОМ 


| КОЕ_МОСОМЕТВММКПО!В Не делать запрос о создании нового каталога, 


ес ебуемый каталог отсутствует. 
Е мели пои ое талог отсутству о 
и ВЕМАМЕОМСОШМАЛЬТОМ Если при операциях копирования, переноса 


Отвечать «да для всех» на все вопросы, кото- 
рые могут задавать диалоги в процессе вы- 
полнения операции: об удалении файлов. 

о создании новых папок и т.д. | 


или переименования файлы-приемники уже 
‚существуют, давать им имена типа «Копия 

| |..», не запрашивая у пользователя подтверж- 
ИИ 


‚дения. 


`РОР_ ЗПЕМТ Не показывать окно с отображением хода | 
процесса. 


РОЕ_ ЗТМРЕЕРКОСВЕ$ $ Показывать окно с отображением хода про- 
__ Цесса, но не е отображать в нем имена файлов. 


КОЕ _ \АМТМАРРИМСНАМОГЕ Заполнить поле ВИМатеМарр!т5$. Указанный 
в нем дескриптор должен быть в дальнейшем 
ИИ освобожден функцией 5НЕгееМатеМарр!т5$. 


В поле ЁГАпуОрегаНоп5 АБофе4 структуры _$НЕП.ЕОРЭТКОСТ функция 
ЭВЕПеОрегаЙоп возвращает фгие, если выполнение операции было прервано 
пользователем. Поле ВМатеМаррте$ содержит указатель на массив струк- 
тур, содержащий прежние и новые полные имена всех файлов, над которыми 
проводились операции. Поле 1р$7Ргоэгез Те содержит указатель текста, по- 
мещаемого в окно отображения процесса при включенном флаге ЕОЕ_ $М- 
РЕЕРВОСКЕ$Ъ. 

Примеры применения функции даны в разд. 6.10. 


эНЕП.ЕОРЭТКОСТ — структура для манипуляции с файлами 
и каталогами 


См. функцию ЭНЕЦеОрега оп. 


$Нбее$КторРоег — доступ к интерфейсу корневой папки 699 


5НСееЖорЕо!4ег — доступ к интерфейсу корневой папки 
Доступ к интерфейсу корневой папки Рабочий стол 
Заголовочный файл 5Й[ОЬУ).В 


Синтаксис 
З5НЗТРАРТ 5НСеерезкКеорЕго1аег (151е1]1РГо]1аег **ррзВЕ); 


НВЕЗОГТ (5ТОМЕТНООСАЬЬТУРЕ *Сефр15р1ауМамеоЕ) ( 
Т5$Ве11Ео]1аАег * Тр15$, .РСТТЕМТОГЬТЕТ р1а1, 
ЗНСОМЕ чЕ1ад5, ЗТВВЕТ *рМапе); 


НВЕЗОЬТ 5ТОМЕТНОРСАЬЬТУРЕ ЕпопОБ)есе$ (НИМР Вмпа, 
ЗНСОМТЕ агЕЕ1адз, ТЕпПашТОГ1$е **ррепиптрТ1$6) = 0; 


ЗНЗТРАРТ $НСефбрес1а1Ео1АегГоса®1оп (НИМ Вип, 1пе пРо1аег, 
ТРТТЕМТОГТ$Т *рр1а1); 


Описание 

Папка — понятие более общее, чем каталог (см. разд. 6.2). Наряду с пап- 
ками, соответствующими каталогам, существуют виртуальные папки: Панель 
управления, Принтеры, Мой компьютер и т.п. Папки имеют интерфейс 
5веПЕо!4ег. Доступ к интерфейсу корневой папки Рабочий стол (БезКюр} дает 
функция ЭНСбе Фе орЕРо!@ег. В случае успешного выполнения она возвра- 
щает значение МОЕВКОВ и заносит в рр$зВЁ указатель на интерфейс 
Т5вВеНЕо14ег. Учтите, что содержимое корневой папки в общем случае отлича- 
ется от содержимого Рабочего стола в более привычном понимании, т.е. от на- 
бора папок и ярлыков, расположенных на экране. Например, независимо от 
того, что вы вынесли на экран, корневая папка помимо элементов, размещен- 
ных на экране, обычно содержит такие элементы, как Мой компьютер, Сетевое 
окружение, тегте! Ехр|огег, Мои документы и ряд других. 

Рассмотрим некоторые методы интерфейса 13ВеПРо!4ег. Метод Се 15- 
р1ауМатеОЁ! дает доступ к имени элемента — файла или папки. Параметр 
р191 — указатель РТОГ на идентификатор элемента. Параметр иЕ]1а5$ задает 
форму отображения имени и может принимать одно из трех значений: 
НОСОМ _МОВМАГТ, 5НСОМ Т1МЕОГОЕВ или ЗЭНСОМ_ЕОКРАВЗТМС. Пер- 
вые два мало различаются, влияя только на отображение общих документов. 
А третье значение предназначено не для показа пользователю, а для про- 
граммного использования: имя, отображаемое в этом варианте, может переда- 
ваться в метод Рагзе 015 р1ауМате, позволяющий по имени найти РТШГ. 

Параметр 1рМаше определяет структуру типа ЭТВВЕТ (ТЗИ'Ве$, в кото- 
рую метод Се О15р1ауМатеОЁ возвращает имя элемента. Тип структуры объ- 
явлен следующим образом: 


суреаеЕ зегисЕ _5ТЕВЕТ 


{ 
ОТМТ аТуре; 
ип1оп 


.РИЗТВ рОо1ебекг; 

ОТМТ зоОЕЁЕзе*; 

сраг СбЕх[ 260 |; 
} РОММУОМТОММАМЕ ; 
} СТВВЕТ; 


$уредеЕ ЗТВВЕТ *ГРЗТВВЕТ; 
суреаеЕ _5ЭТВВЕТ Т5егВее; 
суреаеЕ _$ЗТВВЕТ *РЗТВВек; 
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Поле иТуре этой структуры содержит указание варианта, в котором запи- 
сано имя: 


ЭТВКЕТ \5ТБВ Имя содержится в массиве символов У/14еСВаг, 
на который указывает поле рОе$4г типа 
РУ\У/14еСваг. 


ЭТВКЕТ_С5ТВ Имя содержится в поле ег типа массива сим- 


волов СВаг. 


ЭТВКЕТ ОЕРЕЗЕТ Имя содержится в поле а6 О рассмотренной 
ранее записи типа ТЗНЦешШ Ш с индексом, 
определяемым полем чОЁё5еф. 


Для организации цикла по элементам, расположенным в папке, служит 
другой интерфейс папок — ПЕпит ОГ $$. Получить указатель на него можно 
с помощью метода ЕпишОесё5 интерфейса Т5ЗВеПЕо!4ег. Параметр 
В\упдО\мтпег — дескриптор окна, параметр Епит 101.15 — возвращаемый мето- 
дом указатель на интерфейс ГЕпит ПО Г15$$, а параметр эт Е а5$ является соче- 
танием флагов, указывающих, что именно должно включаться в список эле- 
ментов папки. Эти флаги могут быть следующими: 


ЗНСОМТЕ_РОГРЕВЗ паки 
ЗНСОМТЕ_МОМЕОГРЕН$ 
ЭНСОМТЕ_ ТМСГОРЕНТООЕМ | невидимые объекты 


Имеется также функция $НСбеЗреса1Ео]егТ.осайоп, которая возвраща- 
ет РОГ системных папок. Параметр ВмпЯОмпег — дескриптор окна вызываю- 
щего приложения. В параметр рр! 4! возвращается РТО... А параметр пЕо]4ег 
определяет ту системную папку, к которой требуется доступ. Этот параметр 
может принимать следующие значения: 


СЕ ЫТВОСКЕТ «Корзина». Местоположение этого каталога не 
заносится в реестр, а сам каталог имеет атрибу- 
ты системного и невидимого, чтобы пользова- 
тель случайно не переместил и не удалил его. 


СГ СОМТВОГ, 5 «Панель управления» — виртуальная папка. 


С5ШГ, БЕЗКТОР Корневая папка. 


С5ТОГ. РЕЗКТОРОТВЕСТОВУ | «Рабочий стол» — системный каталог, содер- 
жащий то, что размещено на экране. Не следу- 
ет путать этот каталог с корневой папкой. 


СТО. ОРВКУЕЗ «Мой компьютер» — виртуальная папка. 


СТО РЕОМТ$ «Шрифты» — виртуальная папка. 


С5ТОГ МЕТНООБ Системный каталог с объектами сетевого окру- 
жения. 


СЭТ МЕТМОВК «Сетевое окружение» — виртуальная папка. 
СТО РЕКЗОМАГ «Мои документы» — системный каталог. 
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| С5ТОГ РЕАТМТЕВ$ «Принтеры» — виртуальная папка. 
вн ИВ бе ны аи 

‚ С5ШГ_РКОСКАМ5 «Программы» — системный каталог, содержа- 
| ‚щий программные группы пользователя, кото- 


рые, в свою очередь, являются системными ка- 


талогами. 
`‘СТОЕ_ВЕСЕМТ _ . _ «Недавние документы» — системный каталог. 
С5ГОГ ЗЕМОТО «Бепа То» — системный каталог. 
СГ. 5ТАВТМЕМО «Пуск» — системный каталог. 
| СТО. 5ТАВТОР «Автозапуск» — системный каталог пользова- 
| — теля. 
С5ТРЕ_ТЕМРЕАТЕЗ «Шаблон» — системный каталог. | 


Примеры использования рассмотренных функций и интерфейсов даны 
в разд. 6.2, 6.3, 6.5. 


эНбе Е Пеп{%оА — информация об объекте файловой системы 


Позволяет получить информацию об объекте файловой системы: файле, 
папке, диске. 


Заголовочный файл ЗЙеПАРГ.А 


Синтаксис 


#1пс1о4е <5$Ве11АРТ. В > 

ип$1апеа 1пе 5ЗНбееЕ11еТпЕодА (сопзе сраг * рзиРа®В, 
ип51апеа 1]опд ЯмЕ11]1еАЕЕг1Боакез, 
_ЭНЕТЬЕТМЕОА *рзЕ\, 
ип51апеа 1пЕ сьЕ11еТтЕо, 
ипз1апеа 1пе аЕ1ааз); 


Описание 

Функция 5Нбе ЕПеП\оА дает возможность получить разнообразную ин- 
формацию об объекте файловой системы: файле, папке, диске. В частности, 
можно получить доступ к спискам пиктограмм \У/т94о\з. Параметр р$2РаёВ 
задает файл или шаблон файлов, о которых требуется получить информацию. 
Параметр 9миЕПеА т Ьше$ определяет атрибуты файла и используется только 
при флаге ЗНСЕТ ОЗЕЕПЕАТТЕТВОТЕ». В остальных случаях этот пара- 
метр игнорируется, и его можно задавать равным 0. В передаваемую по ссылке 
структуру рзЙ типа _ЗНЕШЕТМЕОА или эквивалентного ему типа Т$НЕ!- 
1е Ро функция заносит полученную информацию. Этот тип объявлен следую- 
щим образом: 


суреаеЕ зЕгисЕ _ЗНЕТЬЕТМГОА 
{ 


НТСОМ ВТсоп; 
пе 1Тсоп; 
РИОВО ЧмАЕЕг1Битез; 
СНАК 32015р1ауМаме [МАХ_РАТН]; 
СНАВ $2ТуреМапе [80]; 
} ЗЭНЕТЬЕТМРЕОА; 


суреаеЕ _ЭНЕТЬЕТМЕОА Т5НЕ11еТпЕо; 


Параметр е6Е|\е {о функции 5НСе ЕПепМо задает размер структуры 
р5Я. А параметр иЕ1ай$ включает наборы флагов. Возвращаемое функцией 
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значение зависит от включенных флагов. Параметр иЕ!ай$ может включать 
следующие флаги: 


НОЕ _АТТЕТВОТЕ$ Получение атрибутов файла. Флаги атрибутов 
‘заносятся в поле 4\АНгЮщез структуры р$й. 


О НСЕТ _РТЗРТАУМАМЕ Получение полного имени файла. Имя зано- 
 сятся в поле $201$р1ауМаште структуры рзй. 


СНСЕГ ЕХЕТУРЕ 


Если рз2Ра й — имя выполняемого файла, то 
функция возвращает тип файла (см. поясне- 
ния ниже). 


Доступ к дескриптору пиктограммы файла 
или к системному списку пиктограмм. При- 
меняется вместе с рядом модификаторов. Де- 
скриптор заносится в поле ШМШсоп структуры 
рзЯ, а индекс пиктограммы — в поле Цеоп. 
Функция возвращает дескриптор системного 
списка пиктограмм. 


| 
НЕ! _ТтСОМ 


— ИЕ 


| ЗНбЕт _ТСОМ.ОСАТТОМ 


Доступ к имени файла, содержащего пиктог- 
рамму данного файла. Имя заносится в поле 
$7015 р1ауМате структуры р$Ё. 


Модификатор ЭНСЕТ ТСОМ, дающий доступ 
к списку больших пиктограмм. 


| 


|| о 


`ЭНОЕ1 _УМКОУЕВГАУ Модификатор ЭНСЕТГ ТСОМ, дающий овер- 
ООО __| лейную связь с пиктограммами файлов. 
ЗНСЕГ _ОРЕМСОМ Модификатор ЭНСЕТ ТСОМ, дающий доступ 


к списку пиктограмм, соответствующих от- 
крытому контейнеру (папке, каталогу). 


= 


| 
эНСЕТ_РТОГ Указывает, что р$2Раё&В — адрес структуры 


ПИ о ГТЕМШОЫ$Т, а не имя файла. 


к списку пиктограмм с цветом, соответствую- 


 ЭНОЕТГ_ ЗЕГЕСТЕО | еписку пик ЭНСЕГ 1СОМ, дающий доступ 


щим выделению. 


| $ НСЕТ _ НЕ! 1СОМ$17Е Модификатор ЭНСЕТ_ТСОМ, дающий доступ 
к списку пиктограмм, размер которых опре- 
. | | деляется средой. 


ЭНСЕГ 5МАШЛСОМ ' Модификатор ОНСЕГ _ ТСОМ, дающий доступ 
| к списку малых пиктограмм. 


эНаЕЕ_5У51СОМИХОЕХ Доступ к индексу пиктограммы в системном 


‘списке. Индекс заносится в поле Исоп струк- 
туры рзЯ. Функция возвращает дескриптор 
—оистемного списка пиктограмм. 


| 
+ 
й 
й 


_ЗНСРТ _ТУРЕМАМЕ Доступ к строке описания типа файла. Строка 
| заносится в поле $2ТуреМаше структуры рзй. 


И а 
`ЗНбЕТ ОЗЕЕН.ЕАТТЕТВОТЕ$ Указывает, что функция должна использо- 
вать параметр © 4\ЕПеА г Ьифе$. 


$Нбе5реца!Ро4ет.осаНоп — функция интерфейса 15Ре!Ро!дег 703 


Если вы хотите определить тип исполняемого файла, в параметре и ]ад$ 
надо задать только ЗНСЕТГ_ЕХЕТУРЕ. Тогда возвращаемое функцией 5ЭНСеЕ1- 
1еТп{о значение указывает тип файла: 


0 ‹ невыполняемый файл или ошибка 


ГОУГОВО = МЕ приложение \У!114о\з$ 
или 
РЕ (17744) НГМОВФ = 3.0, 3.5 или 4.0 


ГО\ТОКВО = М7 (23117) файлы М$-00$ ‹ехе, сот или Ба! 
НТМГОЮЬ = 0 | 


ГОМГОВО = РЕ (171744) консольное приложение \!1132 
НГ\УОВО = 0 


См. примеры применеия функции в разд. 5.4.1 и 6.6.5. 


5Н@е Зреча1ЕРо|!4егГ.осайоп — функция интерфейса 15 вВеПРо!4ег 
См. функцию НСеОеКорЕо]1@4ег. 


эпомСигзог — управляет видимостью курсора мыши 
Управление видимостью курсора мыши в пределах окна приложения 


Синтаксис 
10пЕ сромСитзог (ТМ ВООЪ Б$Бом); 


Описание 

Управление видимостью курсора мыши в пределах окна приложения осу- 
ществляется функцией ЭвомСигзог. Значение 6ЗВо\м = #Ёа]5е делает курсор не- 
видимым, а значение фгие делает невидимый курсор видимым. Точнее, так 
происходит при однократном вызове функции ЭВо\Сиг5ог. В более общем 
случае надо учитывать, что в \/шЧо\мз подсчитывается число ссылок на кур- 
сор. Если число ссылок неотрицательно — курсор виден. Начальное значение 
числа ссылок равно 0. Каждый вызов ЭВомСигбог с параметром фгие увеличи- 
вает число ссылок на 1, а каждый вызов ЭВомСигзог с параметром #а]зе 
уменьшает на 1 число ссылок. Как только число ссылок станет отрицатель- 
ным, курсор станет невидимым. Так что если вам требуется сделать курсор не- 
видимым, независимо от числа ранее выполненных команд, делающих его ви- 
димым, это можно сделать, например, оператором: 


ир1]1е (5ПомСоагзог (ЁЕа15зе) > 0) 


Функция ЭвВомСиг5ог возвращает число ссылок, полученное в результате 
вызова функции. 


Эвом М т4о\ — устанавливает состояние отображения окна 


Устанавливает состояние отображения указанного окна. 
Заголовочный файл И7пизег.й 
Синтаксис 


#Тпс1аае <Ипазег.|> 
ВОО ИТМАРТ $ПомИ1паом (ТМ НИМО В\Мпа, тм 10 пСпа$пом); 
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Описание 

Функция ЗЭВом У шШдом позволяет задать состояние отображения окна, 
указанного его дескриптором В\/п4. Параметр пСт@ЗВом определяет вариант 
отображения окна. Он может принимать одно из следующих значений: 


5\_НШЕ Окно делается невидимым, и фокус передается 
другому окну. 


5\’_МАХИМТАЕ Развертывает (максимизирует) указанное окно. 


5 \’_МИММТАЕ Свертывает (минимизирует) указанное окно и ак- 
тивизирует следующее в 2-последовательности 
окно верхнего уровня в списке системы. 


3\_КЕЗТОВЕ Активизирует и отображает окно. Если это окно 
свернуто или развернуто, то оно восстанавливает- 


ся до своих первоначальных размеров и отобража- 
ется в первоначальной позиции (почти то же са- 
мое, что 5\_ЗНОММОВМАТ.). 


$\_5НО\М Активизирует и отображает окно в его текущей 
позиции и с текущими размерами. 


э\_ ЭНО\МРЕЕАОТТ Устанавливает состояние в соответствии с флагом 
53\_ в структуре ЗТАВТОРТУЕО (см. ее описа- 
ние в данной главе), передаваемой в функцию 
СгежфеРгосез$ программой, запускающей прило- 
жение. Приложение должно вызывать ЭвВом\Ут- 
4о\ с этим флагом, чтобы задать начальное состо- 
яние своего главного окна. 


5\_5НО\М/МАХТМТАЕО Активизирует и отображает окно в развернутом 
виде (максимизированном). 


э\_5НО\М/МИМТМТИЕО Активизирует и отображает окно в свернутом 
виде (в виде пиктограммы). 


5\/_5НО\/МИММОАСТТУЕ | Отображает окно в свернутом виде (в виде пиктог- 
раммы). Активным остается то окно, которое 
было активным до этого. 


5\_5ЗНОММА Отображает окно в его текущей позиции и с теку- 
щими размерами. Активным остается то окно, ко- 
торое было активным до этого. 


5 \_5НО\М/МОАСТТУАТЕ |Отображает окно в его последней позиции и с по- 
следними размерами. Активным остается то окно, 
которое было активным до этого. 


5\М_5НОММОВМАГ, Активизирует и отображает окно. Если это окно 
свернуто или развернуто, то оно восстанавливает- 
ся до своих первоначальных размеров и отобража- 
ется в первоначальной позиции (почти то же са- 

мое, что З\_КЕЗТОВЕ). 


Если до вызова ЗвВом М1 дом окно был видимо, функция возвращает не- 
нулевое значение, в противном случае возвращается 0. 

Программа автоматически вызывает в первый раз функцию ЭвВом Ут дом 
из функции \УтМашт. При этом используется параметр пСт9$Во\, заданный 
в УшМаш. 

См. примеры применения функции в разд. 1.7, 1.8, 5.1.1. 


ЗЧеер, $!еерЕх — функции ожидания 705 


31еер, 51еерЕх — функции ожидания 
Функции ожидания 
Заголовочный файл И’7пбазе.й 


Синтаксис 


Уо1А $51еер (РМОВКР ЯмМ1111зесопа$); 
РИОВО $1еерЕх (ТМ ПМОВО ам“М1111зесопаз, ТМ ВООГ БА1егфаЮ1е); 


Описание 

Функция еер обеспечивает задержку выполнения текущего потока (нити) 
на Ч“ МИЦ 5есоп4$ миллисекунд. На это время управление переключается на 
другие процессы с тем же или более высоким приоритетом. А в функции 
$ЗеерЕх параметр 6 Дега е, установленный в фгие, позволяет прервать ожида- 
ние, если в этом потоке завершилась функция обратного вызова, операция вво- 
да/вывода, или вызвана функция АРС. Следует отметить, что функции ЯЧеер 
и ЧеерЕх более нагружают процессор, чем прочие функции ожидания. Так что 
их имеет смысл использовать только там, где этот недостаток мало существе- 
нен: при сравнительно редких задержках на небольшие отрезки времени. 

См. примеры применения функций в разд. 2.3.3, 2.4.2, 3.5, 3.6. 


3]еерЕх — функции ожидания 
См. функцию Чеер. 


ЭМАГТ, ВЕСТ — характеризует прямоугольную область 
См. структуру ВЕСТ. 


ЭТАВКТОРТМЕО — определяет свойства главного окна процесса 
Определяет свойства главного окна 


Заголовочный файл И’1тфазе.й 


Синтаксис 

суредеЕ зЕгисЕе _ЗТАВТОРТМЕГОА { 
РИОКрО с; 
.РЗТК 1рВезегуеа; 
ЬРЗТВ 1ррезкКФор; 
ЬРСТК 1рТ1Е1е; 
ИОВ Ямих; 
РМОВр му; 
РИОВО ЧмХ517е; 
РИОВО ЯмУб17е; 
РИОВО ЯмхХСоипеСПаг$; 
РИОВО ЧмУуСоппЕСПаг$; 
ОИОВО ЯмЕг111АЕбузраее; 
РИОВр ЧиЕ1ааз; 
МОВЬ \5вомИ1 паом; 
ИОВ сЬКезегуеа2; 
.РВУТЕ 1рВезегуеа2; 
НАМОЬЕ Б$ЕатТприае; 
НАМОЬЕ Б5$аОчферие; 
НАМОЪЕ ПЮ5еаЕггог; 


} ЭТАКТОРТМЕОА, *ГРЗТАВТОРТМЕОА; 


суредеЕ УТАВТОРТМЕГОА ЗТАВБТОРТМЕО; 


сСуреаеЕ _5ТАБТОРТМЕОА Т5хаг®еорТптЕо; 
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Описание 


Структура типа ЭТАВТОРТУЕО (ТЗ$агеарП\о) определяет свойства глав- 
ного окна создаваемого процесса. Для процессов с графическим интерфейсом 
пользователя (СОТ) эта информация относится к первому окну, создаваемому 
функцией Сгеже\/ т4о\ и отображаемому функцией ЭВом УИ шао\м. Для кон- 
сольных приложений эта информация относится к создаваемому консольному 
окну. 

Поля структуры означают следующее: 


Размер в байтах данной структуры. 


]рКе5егуе4 Зарезервировано. Пока значение должно быть МОГ. 


]рдезКфор Только для УИ шаомз МТ. Указывает на строку или только 
с именем 4езК фор, или с именем окна и 4езКфор для данного 
процесса. 

ре Для консольных процессов — надпись в заголовке окна. Для 


процессов аОТ и консольных, не создающих новое окно, зна- 
чение должно быть МОП. 


4\Х, амуУ Игнорируются, если дмЕ 1а5$ не включает флаг 

ЭТАВТЕ ОЗЕРОЗТТТОМ. При включенном флаге 

ЭТАВКТЕ ОЗЕРОЗПШТОМ определяют координаты левого 
| верхнего угла окна. 


4\Х.$12те, ‚Игнорируется, если АмЕ1а5$ не включает флаг 
4\У5$127е ЗТАВТЕ _ОЗЕЗТРЕ. При включенном флаге ЗТАВТЕ_ОЪЕ- 
` 917Е определяют ширину и высоту окна. 

_. небе олд С У С —_ 
4\ХСоипёСВаг$, | Игнорируются, если 4мЕ1а5$ не включает флаг 
4\УСоиСВагз |ЭТАВТЕ_ОЗЕСООМТСНАВЬ. При включенном флаге 
ЭТАВТЕ_ОЗЕСООМТСНАВ и только для консольных при- 
‘ложений, создающих новое окно, определяют буферы шири- 
ны и высоты эрана в числе символов. В остальных случаях 
‘эти поля игнорируются. 


4“ЕШАИЙгЬще |Игнорируются, если 4мЕ1а5$ не включает флаг 
| ЭТАВТЕ ОЗЕЕПТАТТЕТВОТЕ. При включенном флаге 
ЭТАВТЕ_ОЗЕЕП.Т.АТТЕТВОТЕ и только для консольных 
приложений, создающих новое окно, определяют цвета тек- 
ста и фона. Значение поля может быть комбинацией следую- 
‚ щих значений: ЕОКЕСКОЙОМО_ВГОЕ, ЕОВЕСВООМО_СВЕ- 
 ЕМ, ЕОВЕСВООМО_ВЕО, ЕОВЕСКВОЧОМО ТМТЕМЗТУ, 
 ВАСКСВОПМО_ВГОЕ, ВАСКСВКООМО СВЕЕМ, ВАСКС- 
ВООМО_КЕО, ВАСКСКООМО_ТМТЕМЗТТУ. Например, сле- 
дующая комбинация определяет красный цвет текста на бе- 
лом фоне: ЕОВЕСВООМО_ВЕЬ | ВАСКСВООМО_ВЕШ | 
ВАСКСКОПМО СВЕЕМ | ВАСКСВООМО _ВТГОЕ. 


ЗизрепаТИгеа — приостановка потока 707 


 аУарз. ` Битовое 1 поле, определяющее флаги, указывающие на испо- 

| ‘льзование тех или иных полей структуры при создании окна 
процесса. Может содержать любые комбинации следующих 

значений: 5ТАВТЕ_ОЗЕЗНОМ МПМРОМ — игнорировать 

‚ поле мЭвом\М Шао“ 5ТАКТЕ ОЗЕРОЗЕЛОМ — использо- 
вать поля 4мХ и 4мУ$ТАВТЕ _ОБЗЕЗТАЕ — использовать 
поля 4мХ$!2е и 9мУ512езТАВТЕ_ОЗЕСООМТСНАНВ5 — ис- 
пользовать поля д9мХСопп СЬгг$ и 4мУСоипСвВагз- 
ЭТАВТЕ ОЗЕЕП.Т,АТТЕТВОТЕ —- использовать поле 4мЕП- 
1АИтьщеТАВТЕ_РОВСЕОМЕЕЕОВАСК — если этот флаг 
установлен, курсор указывает на процесс создания на протя- 
‚ жении 2 секунд после вызова СгезжфеРгосез$$. Если за это вре- 
мя процесс сделал первый вызов СОТ, система дает еще 5 се- 
кунд на процесс показа окна. Если за это время окно не на- 
‘рисовано, дается еще 5 секунд на завершение рисования. 

‚ Форма курсора восстанавливается после первого вызова @еф- 
‚ МеззасезТАВТЕ _ЕОВСЕОЕЕЕГЕЕОВАСК — восстанавливать 
‚форму курсора сразу после запуска процесса 

 ЭТАВКТЕ_ _ОЗЕЗТОНАМОГЕ$ — использовать дескрипторы 
‚потоков ввода, вывода и ошибок, указываемые полями 

_ В ри, 564Ошриф, В 5{АЕггог. 


\эвом Уп 9о\ _' Игнорируется, если аАмЕ1а$ не включает флаг 
'ЭТАВТЕ_ОЗЕЗНОМ \УГМОО\М/. Может содержать любые 


константы Б\У! _, объявленные в файле штизег.й. Например, 
| М _ ЗНОММОЕМАГ, — обычное окно, З\!/_НШЕ — неви- 
О _ димое. — о — 
сЬВевегуей2_ __ Вврезервировано, должно равняться 0. о. | 
1рЕезегуе42 _  Зарезервировано, должно равняться МОМ. 
в544Тприф _`Игнорируется, если 4мЕ 1а$ не включает флаг 
 ЭТАКТЕ_ ОЗЕЗТОНАМОГЕ$Ф. Определяет дескриптор стан- 
___дартного потока ввода. 
 ТАВТЕ ОЗЕЗТОНАМОГЕ$. Определяет дескриптор стан- 


| дартного потока вывода. 


44 Еггог 'Игнорируется, если 4 Еарз т не включает флаг | 
`ЗТАВТЕ_ ОЗЕЗТОНАМОГЕ$. Определяет дескриптор стан- 
| ‘дартного ого потока с ошибок. 


-_-- —_ ИНЬ 
ВО ирие `Игнорируется, если 4УЕарз к не включает флаг 


Единственное поле, которое обязательно должно быть заполнено, это поле 
сЪ. Остальные можно не заполнять, что обеспечит вид окна по умолчанию. 


Зизреп4ТИгеа — приостановка потока 
См. функцию ЕхЦТЬгеа4. 


эЭ\арМоизеВи Йоп — взаимно меняет функции кнопок мыши 
Взаимно меняет функции левой и правой кнопок мыши. 


Заголовочный файл И’таои3з.Й 
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Синтаксис 
ВООЁГ ЗмарМочзеВчЕ оп ( ТМ ВООЬ Е5мар); 


Описание 

Иногда может возникнуть потребность взаимно поменять функции левой 
и правой кнопок мыши. Это можно сделать функцией ЗмарМоци5еВи оп. 
Если параметр мар равен фгие, то левая кнопка начнет генерировать собы- 
тия, свойственные правой кнопке, а правая кнопка начнет генерировать собы- 
тия, свойственные левой кнопке. Например, контекстные меню будут веплы- 
вать при щелчке левой кнопкой. А делать щелчки на кнопках приложений 
надо будет делать правой кнопкой мыши. Если параметр Ё#З\мар равен #а[5е, то 
восстанавливаются нормальные функции кнопок. 

Учтите, что если вы переключили функции кнопок, а затем их не восста- 
новили, то измененные функции будут действовать не только на ваше прило- 
жение, но и на все остальные приложения У! ш@4до\з. Причем измененные 
функции кнопок сохранятся, даже если ваше приложение завершится. 


эузЕггогМеззасе, Еогта Меззасе — описание сообщений об ошибках 
Позволяют получить текстовое описание сообщений об ошибках 
Заголовочные файлы 5у30Н[5.Йрр, илтфазе.в 


Синтаксис 


#10с1аае <$у$0е11$.Врр> 
Ап$15Ег1па _ Еаз®са11 бузЕггогМеззаде (1пе ЕгкогСоае); 


#10с]1аае <м1празе.в> 

РИОВР ЕГогта*Меззаае (РМОКР ЗмЕ1адз, БРСУОТО 1р5о0гсе, 
РИОВКР ЧмМеззадзета, 
РИОВКР ЯмГапацасвета, 
.РТЗТВ 1рВаЕЕег, РМОВКР пб1?е, 
Уа_113е *Агдитепе$); 


Описание 

Функция ЭузЕггогМеззасе позволяет получить текстовое объяснение 
ошибки, возвращаемой какой-нибудь функцией АР] У/ш4о\з. Причем объяс- 
нение получается на русском языке, конечно, если на компьютере установлена 
соответствующая локализация. Единственный параметр этой функции 
ЕггогСо4е — код ошибки. Этот код может быть получен вызовом функции 
Се аз Еггог. Возвращаемое функцией ЗузЕггогМез5асе значение — это тек- 
стовое пояснение кода ошибки. 

Например, следующий оператор отобразит в метке Габе!] сообщение об 
ошибке: 


Таре11->СарЕ1оп = ЗузЕггохМеззаае (Сета Еггкохг ()); 


Помимо функции ЭузЕггогМез$ асе, введенной в С++ВоПаег, имеется бо- 
лее мощная функция Еогта{Мез$засе, объявленная в АРТ \/1114о\5. Параметр 
Ч\уЕ1а5$ является множеством флагов, определяющих параметры процесса 
форматирования. Параметр 4мМез5ае!4 определяет идентификатор требуе- 
мого сообщения, параметр амГапгиасе14 задает идентификатор языка выда- 
ваемого сообщения. Параметры 1рВиЁег и п$12е определяют буфер, в который 
будет помещено сообщение, и его размер. Параметр Аггитеп&$ является ука- 
зателем на массив значений, которые используются для вставки в отформати- 
рованное сообщение. 

См. примеры применения функции 5узЕггогМеззасе в разд. 1.1, 6.1.2, 6.7.2. 
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ЗУЗТЕМ 1ТМЕО — структура информации о процессоре 
Структура, содержащая информацию о процессоре 
Заголовочный файл У’тёфазе.й | 


Синтаксис 
#1п0с1аае<и1тпразе. [> 


фуреаеЕ зекисЕ _ЗУЗТЕМ ТМЕО 
{ 
иптоп { 
РИОВО аАмОешмтТа; 
ЗЕкисЕ { 
МОВКР имРгосеззогАгср1бесбаге; 
МОВКО мВезегуед; 
}; 
}; 
РИОВКО амРаде$12е; 
ТРУОТО 1рМ1п1томАрр11сае1опАЧаге$з$; 
ТРУОТР 1рМах1тамАрр11са*1опАЯЧаге$з$; 
РИОВР РТВ ЧмАс®1уеРгосеззотМазк; 
РИОВКО АмМиатоегОЕРгосе$5$ог$; 
РИОВР ЧмРгосеззогТуре; 
РИОКР ЧмА1]1осае1опСгапа]аг1®у; 
ИОВОР мРгосезз5огЪеуе]; 
ИОКО мРгосеззогВеу1$1оп; 


} ЗУЗТЕМ ТМРГО, *ГРЗУЗТЕМ ТМЕО; 


суреаеЕ _5УЗТЕМ ТМЕГО ТбузбемТпЕо; 


Описание 

Структура типа ЗУЗТЕМ_ТМЕО (ТЗузеп по) заполняется вызовом 
функции Се Зузвет шо и содержит информацию о процессорах компьютера. 

Структура представляет собой объединение (ип1оп). Но ветвь амОеш1Та — 
устаревший вариант, оставленный для обратной совместимости. Начиная 
с У!14омз МТ 3.51 и \/1114о\$ 95 используется ветвь \Ргосе$5огАгсЬ Ццесфаге. 

Поле мРгосе$$огАгеЦесвиге указывает архитектуру процессора. Значе- 
ние 0 соответствует архитектуре т4е]|, 1 — архитектуре МТРЬ, 2 — архитекту- 
ре АЁГРНА, 3 — иной, неизвестной архитектуре. 

Поле мРгосеззогГеуе] в \/1п4о\з 9.х не используется, а в \УшЧомз МТ оп- 
ределяет уровень процессора. Его смысл зависит от архитектуры процессора, 
т.е. от значения поля \РгосеззогАге в Цесфаге. Для архитектуры 1%] значе- 
ние 3 соответствует [114е] 80386, 4 — 14е] 80486, 5 — Репийишщт, 6 — Репииш 2 
и т.д. 

Поле мРгосез5огВеу1$10п указывает версию процессора. Для [ше] 80386 
и 80486 значения байтов этого поля можно представить как хху2. Если 
хх = ФЕЕ, то модель определяется как у — $А, а версия равна 7. Если хх не 
равняется ФЕЕ, то символ СВаг(хх + ог@4(‘А’)) указывает букву модели, а зна- 
чение ух — версию. Для Пе! Репйаш, Сумх и М№ех& еп 586 старшее слово 
поля \Ргосе5зогВеу1$10п определяет модель, а младшее поле — версию. 

Поле 4мРгосез5огТуре оставлено только для совместимости с \У/т4о\з 95, 
где оно может принимать значения РКОСЕЗЗОВ _ТПМТЕГ_ 386, РКОСЕЗЗОВ, _ 
ГМТЕГ 486, РКОСЕЗЗОВ _ ТМТЕГ, РЕМТГОМ, РВОСЕЗ ЗОВ _ МТР5 _В4000, 
РВОСЕЗЗОК_АТРНА_21064. В более современных версиях МУ пао\мз вместо 
этого поля используются описанные выше поля \мРгосеззогАге Цесфиге, 
уРгосез5огГеуе1, \РгосеззогВеу1$101. Значение поля амРгосеззогТуре может 
быть одним из следующих: 
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РВОСЕЗЗОВ_ТМТЕГ 386(386) 
РКОСЕЗОК_1МТЕГ._486(486) _ | процессор, совместимый с 80486 


РКОСЕЗЗОВ, 1МТЕГ РЕМТПОМ(586) процессор, совместимый с Репйит 
Л ЛИ и ды нони 


РКОСЕЗЗОВ_МЕ?$_В,4000 процессор, совместимый с процессором 


— М 
‚ процессор, совместимый с процессором 
‚ рва 


процессор, совместимый с 80386 


Поле 4мМиашБегОЁРгосез$$ог$ определяет число процессоров в системе. 
Поле дмАейуеРгосезогМазК определяет маску процессоров, сконфигуриро- 
ванных в системе: бит 0 — процессор 0, бит 31 — процессор 31. 

Поле мВезегуе4 зарезервировано и в настоящее время не используется. 

Поле 4мРазе512е указывает размер страницы, используемый функцией 
Уп{ша1АПос. Он характеризует дробность памяти. Поле дмАПоса Я опСгапо- 
]аг (у определяет минимальный размер резервируемого блока виртуальной па- 
мяти. Например, эсли функция Уп аа1АПос потребовала выделить 1 байт, то 
реально в адресном пространстве будет зарезервировано ЧмАПосаЙопСгапща- 
г{у байтов. 

Поля рМпититАррИсайопА994гез5 и ]рМахипитАррИсайопА9@гез$ 
указывают минимальный и максимальный адреса памяти, доступные для при- 
ложений и ОШ.. 


ЗузетРагатеег$ шо — получение и установка системных параметров 
Позволяет получить и установить системные параметры. 
Заголовочный файл И’тпизег.П 


Синтаксис 


#Тпс1аАе <М1пазег. [> 
ВОО ЗузбетРагапекег$ТптЕо (ТМ ОТМТ в1Асе1оп, ТМ ОТМТ а1Рагам, 
ТМ ОЧТ РУОТР руРагам, ТМ ОТМТ ЕМ1п1п1); 


Описание 

Функция ЗузетРагате ег шо позволяет получить и установить множе- 
ство системных параметров, связанных с обоями Рабочего Стола, хранителями 
экрана, характеристиками мыши и клавиатуры, способами отображения 
и упорядочивания окон ит.п. 

Параметр и1АсНоп определяет выполняемую функцией операцию и в за- 
висимости от этой операции меняется смысл параметров щРагашт и руРагат. 
Параметр и1АсИоп может принимать одно из следующих значений (в описа- 
нии под \!114омз МТ понимаются также У/шао\мз 2000\ХР, а под У/ш94о\мз 95 
понимаются все версии Ут 4Чо\з 9.х): 
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| МЕООТ 


ЗРГ_СЕТАССЕ$5Т1- = 
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Получить информацию оби интервале времени без на- 
‚жатия клавиш и кнопок мыши, после которого от- 

ключается фильтрация ввода — игнорирование слиш- 
ком кратких или повторных нажатий клавиш 
_и управление скоростью повтора при удержании кла- 
_виши в нажатом положении. Параметр руРагат ука- 
зывает на структуру типа АССЕЗЗТТМЕОТТ, а пара- 
‚метр и1Рагат определяет размер структуры — $12е- 
оКАССЕЗЗТТМЕООТТ). То же значение должно иметь 
‚ поле сб З$12е структуры. В поле ТипеОи&М$ес структу- 
‚ры возвращается интервал времени в миллисекундах. 


ЭРГ _ СЕТАМТМАТТОМ Получить информацию об эффектах анимации. Пара- 


‚метр руРагат указывает на структура типа АММА- 
'ТТОМУЕО, а параметр и1Рагат определяет размер 
‚структуры — $12ео (АМТМАТТОМТУЕО). То же значе- 
‘ние должно иметь поле е5512е структуры. В поле 1М1- 
'ПАштае структуры возвращается ненулевое значе- 
‘ние, если анимация включена, и 0, если анимация 
выключена. 


' ЗРТ_СЕТВЕЕР 


‘чена. Параметр иш1Рагат не используется. 


Определить, включена ли звуковая индикация оши- 
‘бок. Параметр руРагат указывает на булеву перемен- 
ную, которая принимает значение фгие, если индика- 
‚ция включена, и равна #а]5е, если индикация выклю- 


 $РГ_СЕТВОЕОЕВ 


Ы 


‚Определить толщину бордюров окон. Параметр руРа- 
‘гат указывает на целую переменную, в которую за- 
‘носится ширина. Параметр шРагат не используется. 


‚ ЗРТ_ СЕТРЕРЕАОТТТМ- 
РОТТАМС 


`ЗРГ. СЕТОКАСЕОТ. | 
`ТМТМрОУ5 


Определить раскладку клавиатуры для языка по 
умолчанию. Параметр руРагат указывает на 32-бит- 
‚ную переменную, в которую возвращается дескриптор 
раскладки клавиатуры по умолчанию. Параметр 
_ 1 Рагаш не используется. 


Определить, установлено ли отображение содержимого 
‚окна при перетаскивании. Параметр руРагаш указы- 

‹ вает на булеву переменную, которая принимает значе- 
ние фгие, если отображение содержимого окна включе- 
‚но, и равна #а][5е, если отображение выключено. Пара- 
метр ч1Рагашт не используется. Для У/ш9о\з 95 этот 
флаг поддерживается только если установлен У/Лт4о\з 
Раз! (см. ЗРТ_СЕТУ\УТМОО\ЗЕХТЕМ$ ТОМ). 


ПИ 


 УЕТСН 


| ЭРТ _ СЕТЕАЗТТА$К$- Устаревшее значение, позволявшее для ранних вер- 


НИИ 
‚сий \У/ш4о\мз определять, возможно ли переключение 


между окнами клавишами АЁ-ТаЬ. Начиная с У/т- 
Ч0\/5$ 95 и \М/шао\мз МТ 4.0 это всегда возможно. 
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. ЗР1 _СЕТЕНЛЕВКЕУ$ , Получить информацию ‹ (9 , фильтрации в: ввода — игно- ‘ 
‘рировании слишком кратких или повторных нажатий ' 
‘клавиш и управлении скоростью повтора при удержа- 
‘нии клавиши в нажатом положении. Параметр руРа- 
гаш указывает на структуру типа ЕПИ.ТЕВКЕУ$, 

'а параметр ш1Рагат определяет размер структуры — 
 $17ео(ЕП.ТЕВКЕУ5). То же значение должно иметь 
'поле сЬ$12е структуры. Остальные поля заполняются 
функцией. Поле 4\Е1а55 содержит комбинацию фла- 
‘гов, из которых основной ЕКЕ ЕПШТЕВКЕУЗОМ — 
`если он имеется, фильтрация включена. Поле 1\\ац- 
Мес содержит задержку, после которой срабатывает \' 
‚нажатая клавиша. Поле Де!ауМ$ес — задержка на- 
чала повтора при нажатой клавише, а поле 1Вереа{ М- | 
Зее — интервал повтора. Поле 1ВоипееМ$ее — интер-. 
‘вал, в течение которого игнорируется повторное на- 

‚ жатие клавиши. Поля Фе!ауМ5ес и 1ВоппееМ5ес не 
‚ могут иметь ненулевое значение одновременно. Все 


| 

| 

| 

| 

| 

| 

| 

| 

| ‚ задержки указываются в миллисекундах. 


БР _СЕТРОМТ$МООТ- "Определить, включена ли возможность сглаживания 
НИХ ‘экранных шрифтов. Параметр руРагат указывает на ‹ 


булеву переменную, которая принимает значение 
`фгие, если сглаживание включено, и равна Ёа[5е, если ‹ 
‚ сглаживание выключено. Для У/т94оугз 95 этот флаг 
‹ поддерживается, только если установлен \/1114о0\з 


ОАО 9 'Р\аз! (см. БР СЕТУТМООМ 5ЕХТЕМЬТОМ). _ 


| .5РГ СЕТСВШОСКВАМО- Определить текущее значение размера зерна экрана. 
ТАВТТУ ‚ Параметр руРагат указывает на целую переменную, 


| ‘в которую функция заносит размер зерна. 
ОЕ ИЯ ОИ ин д 


'$РТ_ СЕТНТСНСОМТ- 'Только для У1т9до\з 95: получить информацию об 
ВАТ ‚ установке режима высокой контрастности. Параметр 
| ‚руРагат указывает на структуру типа НН@НСОМТ- 
| ‚ ВАЗТ, а параметр иРагат определяет размер струк- 
туры — з1тео (Н1СНСОМТВА$Т). То же значение 
'должно иметь поле еЬ$12е структуры. Остальные 
| 
| 
| 
| 
| 
| 


поля заполняются функцией. Поле 4уЕ]абз содержит : 
‘комбинацию флагов, из которых основной НСЕ_Н1О-_ 
НСОМТВАЗТОМ — если он имеется, режим включен. 

' Поле 1р52Оеёаи {свете указывает на строку, содер- 

‘ жащую имя используемой по умолчанию цветовой 
схемы. 


|——-—- о _--..- к - а а ен —— -— -.- 4 


РГ. СЕТТСОММЕТ- Получить информацию о о метрике пиктограмм. Пара- 
81С5 ‘ метр руРагат указывает на структуру типа 1СОМ- 
 МЕТЕ!С$, а параметр и1Рагат определяет размер 

| ‘структуры — зео ЙСОММЕТВ1С$). То же значение 

| ‘должно иметь поле сЪ$12е структуры. Остальные 

| ‚поля заполняются функцией. В поля 1Чог25раеше 

‚и 1Уег65раете заносятся соответственно горизонталь-. 
| 

| 


‚ный и вертикальный размеры зазором между пиктог- 
‘раммами при их выравнивании. Поле 1Т1Йе\УИгар 


‚ определяет, осуществляется ли (при ненулевом значе- . 
| В 
‘нии) перенос длинных заголовков на новую строку 


(при нулевом значении переноса нет). Поле ИРош 
_‘ определяет шрифт заголовков. 
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`$РТ СЕТСОМТИТЕ- 
ТОбЕОМТ 


_В поле ИНее В заносится величина, определяющая 
вертикальный размер шрифта: 0 — используется раз- 


‚в логических единицах. В поле №\У’е1е+ передается 
‘толщина линий от 0 до 1000 (нормальная — 400, 
‚жирный — 700). Поле ИЕасеМате содержит имя 


Получить информацию ос о текущем Е шрифте заголовков о 
пиктограмм. Параметр руРагат указывает на струк- | 
туру типа ГОСЕОМТ, а параметр и1Рагат определяет | 
размер структуры — $12ео (ГОСЕОМТ). Все поля 
структуры заполняются функцией. Основные из них 
следующие (см. подробнее в справке С++Ви!ает). 


мер по умолчанию, ненулевое значение — высота 


‚ шрифта. Поле НОметща Йоп указывает угол наклона 
текста в десятках градусов. _ 


_ЗРТ СЕТСОМТЕТЕЕМ 
ВАР 


РТ СЕТКЕУВОАЕР- 
`РЕГАУ 


НО ЕН ——_ мП2—— 


`Определить длительность нажатия клавиши, после 

‚ которой символ начинает повторяться. Параметр 
‚руРагат должен указывать на целую переменную, 
‚в которую функция заносит длительность в миллисе- 


—- а ее = ———— 41| 


Определить, разрешено ли переносить длинные заго- | 
‚ловки пиктограмм на новую строку. Параметр руРа- | 
‚‘гат указывает на булеву переменную, которая прини-| 
 мает значение фгие, если разрешено, и #а[5е в против- | 
‘ном ‘случае. Параметр и Рагат не используется. 


кундах. Параметр иРагаш не используется. 


ЗЫ. СЕТКЕУВОАВОР- | 
`ВЕЕ 


ни 
|, 
| 
|: 


| 
и 
] 


‚ $РГ. СЕТКЕУВОАЕОЗ- 
`РЕЕО 


‚ 5РТ_ бЕТГО\РОЖЕ- | 
' ВАСТТУЕ 


| ЗРГ СЕТГО\РОЖМЕВ- | 
ТМЕООТ 


`6РТ СЕТМЕМООВО- | 
`РАНСММЕМТ 


если справа. 


‚энергопотребления при срабатывании хранителя экра- | 
‘на. Параметр руРагат указывает на булеву перемен- 


:И Рае в противном случае. Параметр ш1Рагат не ис- 
пользуется. 


‘определить значение задержки перехода в режим по- 


_ Определить, появляется ли выпадающее меню слева, 
‚или справа от соответствующего головного раздела. 


`Определить, включен ли режим управления мышью — 
‚с помощью цифровой клавиатуры. Параметр руРагат \ 
‚указывает на булеву переменную, которая принимает ! 
значение фгие, если включен, и Ёай5е в противном | 
_ случае. Параметр. \1Рагат не используется. 


а: ам 


| 
Определить скорость повторения символов при удер- 
живании клавиши. Параметр руРагаш указывает на | 
‘переменную типа О\УОВЮ, в которую возвращается ‹ 
‚полученное значение. Параметр и1Рагат не использу-. 
‚ется. 


Только, для 1 16-1 -разрядных приложений Мпа 95: | 
‘определить, задан ли переход в режим пониженного \! 


ную, которая принимает значение фгие, если задан, 


‚Только для 16-1 -разрядных приложений Мпа 95: 


ниженного энергопотребления при срабатывании хра- 
нителя экрана. Параметр руРагат указывает на це- 
лую переменную, в которую возвращается значение 
задержки. Параметр \Рагаш не используется. 


| 
тапа не используетея.. ВИ — 


Параметр руРагат указывает на булеву переменную, 
которая принимает значение фгие, если слева, и #а|$е, | 
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ЭРТГ_СЕТМИМТМТАЕО- ‚Получить информацию о метрике свернутых окон. | 
МЕТВ!СУ ‚Параметр руРагат указывает на структуру типа М- | 
‚ МОМТРЕОМЕТВГСЬ, а параметр 1Рагат определяет 


‘размер структуры — змео (МТМИМТ7ЕОМЕТВТС$5). 
‘То же значение должно иметь поле е5512е структуры. | 
`Остальные поля заполняются функцией. В поле 
ТУ заносится ширина свернутого окна в пиксе- 
‘лах. В поля Шог2Сар и 1Уе {Сар заносятся интерва- 
‚лы по горизонтали и вертикали между свернутыми 
‘окнами. В поле 1Аггапее заносится начальная пози- 
‘ция и направление упорядочивания. Начальная пози- 
‚ция определяется одним из следующих значений: 
 АВ\_ВОТТОМГЕЕТ, АКВ\_ВОТТОМЕСНТ, 

'АВМ _ТОРТЕЕТ, АВМ _ТОРЕСНТ — соответственно 
‘нижний левый, нижний правый, верхний левый, вер- 
‚хний правый угол рабочей области. Направление упо- 
‚ рядочивания задается одним из следующих значений: 
‚ АВ\У’ТЕЕТ — влево (при АК\М_ВОТТОМЕТСНТ или 
АВ\_ _ТОРЕТСНТ), АБУ _ ЕСНТ — вправо (при 
 АВ\’_ВОТТОМЕЕЕТ или  АВ\ _ТОРГЕЕТ), 

 АВУ’_ ОР — вверх (при АВ\У’_ВОТТОМЕЕЕТ или 
 АВМ _ _ВОТТОМЕТСНТ), АБУ’ _ РО\М — вниз (при 
АВМ. _ТОРГЕЕТ или АВ\ ‚№ _ТОРЕСНТ). 


ЭРТ СЕТМООЗЕ ‘Получить информацию о двух пороговых значениях 
`и скорости мыши. Параметр руРагат должен указы- 
‘вать на массив из трех целых величин, в которые 


функция заносит эти значения. 


ЭРТ_СЕТМОПОЗЕНО- Только для У шдомз МТ: получить высоту в пикселах 
УЕКНЕТСНТ ‘рамки, пребывание курсора мыши внутри которой 
‘вызывает функцию ТгаскКМоизеЕуеп{ для генерации 
сообщения \М_МООЗЕНОУЕК. Параметр руРагат 

‚ должен указывать на переменную типа ОТМТ, в кото- 
] рую возвращается затребованное значение. 


ЭРГ СЕТМОЧЗЕНО- | Только для У\У/и14о\з МТ: получить интервал времени, 
УЕВЛТТМЕ ‚в течение которого указатель мыши должен пребы- 
‘вать внутри рамки, чтобы функция ТгасКМопзеЕуеп{ 
‚ сгенерировала сообщение \УМ_МОЧЗЕНОУЕВ. Пара- 
‘метр руРагаш должен указывать на переменную типа 
ОЛМТ, в которую возвращается затребованное значе- 


‘Только для У паомз мт: получить ширину в пиксе- 
'лах рамки, пребывание курсора мыши внутри кото- 
рой вызывает функцию ТгасКМоцзеЕуеп{ для генера- 
‘ции сообщения \УМ_МОЧОЗЕНОУХЕКА. Параметр руРа- 
‘гат должен указывать на переменную типа Т1МТ, 


‚В которую возвращается затребованное значение. | 
НИ —= — 


$РТ СЕТМООЗЕНО- 
УЕВУТОТН 
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1.5 


н 
| 


| 5РТ_ СЕТМОМСЦЕМТ- 
`МЕТВ!С$ 


' оу1АасрагРТ_СЕТРО- 
| УУЕКОЕРАСТТУЕ 


| ЭРГ_СЕТРОМЕКВОЕ- 
| РТТУМЕООТ 


| $РТ СЕТЗСКЕЕМВЕА- 
РЕК 


‚ ЭРГСЕТМОПЗЕКЕУ$ Получить информацию о режиме управления мышью 


_ Жим См: подробности в справке О++Вииет. 
ЭРГ_ СЕТМООЗЕТВА- |Только для У/шаомз МТ: определить, включен ли ре- 
0 


подробности в справке С++Ви!аег. | 
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‚с помощью цифровой клавиатуры. Параметр руРагат 
указывает на структуры типа МООЗЕКЕТХ5, а пара- 
‚метр Рагат определяет размер структуры — $12е- 

‹ О(МООЗЕКЕУХ$5). То же значение должно иметь поле 
`©6$512е структуры. Остальные поля заполняются функ- 
‘цией. Поле амЕ1а:$ содержит комбинацию флагов, из 
‚которых флаг МКЕ_АУАПАВГЕ говорит о том, что 

` этот режим включен. Остальные флаги и остальные 

‚ поля структуры определяют те или иные особенности 


жим отображения следа указателя мыши. Параметр 
‘руРагаш должен указывать на целую переменную. 
Если функция занесет в эту переменную 0 или 1, зна-_ 
‚чит этот режим выключен. Значение большее 1 свиде- 
‚тельствует о включенном режиме и указывает число 
изображений курсора при его перемещении. Пара- 

' метр ч1Рагат не используется. | 


Получить информацию о метрике неклиентской обла- | 
‘сти несвернутого окна. Параметр руРагат указывает 
‘на структуру типа МОМСЕТЕМТМЕТВТСЬВ, а параметр | 
и1Рагаш определяет размер структуры — $12ео (МОМ- 
СЫЕМТМЕТВ1С5). То же значение должно иметь 
поле сЪ512е структуры. Остальные поля заполняются 
функцией. Они определяют характеристики бордюра, 
полосы меню, полос прокрутки и многое другое. См. 


‘Только для 16-разрядных У ш@о\з 95: определить, 
‘задан ли режим автоматического выключения пита- | 
‘ния при работе хранителя экрана. Параметр руРагат о 
‘должен указывать на булеву переменную, в которую | 
возвращается фгие, если режим задан, и Ёа|5е в про- 
тивном случае. Параметр ш1Рагат не используется. 


Только для 16-разрядных У/шаомз 95: определить за- 
держку автоматического выключения питания при 
работе хранителя экрана. Параметр руРагаш должен 
‘указывать на целую переменную, в которую возвра- 

' щается затребованная величина. Параметр шРагат 
не используется. 


Только для \Мш9домз 95: определить, включен ли ре- 

жим замены графической информации текстовой, пе- | 
‚ ресылаемой на синтезатор речи или описываемой на | 
‘экране шрифтом Брайля. Параметр руРагат должен 
‘указывать на булеву переменную, в которую возвра- 
щается фгие, если режим включен, и #а]$е в против- 


|мИ 
| ЗРГ_СЕТЗСВЕЕМ$А- 
| УЕАСТТУЕ 


‘ном случае. Параметр ш1Рагат не используется. 
- А -- - а. -- —- —-. -—. . ео - - — 


Определить, включен ли режим автоматического за- | 
‘пуска хранителя экрана. Параметр руРагаш должен 
‚указывать на булеву переменную, в которую возвра- 


| 


‹ щается фгие, если режим включен, и #а[$е в против- | 


‘ном случае. Параметр ч1Рагат не используется. | 
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РТ _СЕТЗСВЕЕМ$А-_ 
УЕТМЕООТ 


РТ _СЕТЗЕВТАТКЕУ$ 


| 


| $РТ СЕТЗНО\50- 
|9№0$ 


`ЗРТ СЕТЗМАРТОРЕЕ- 
| ВОТГОМ 


‚не используется. 
Е - 
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] 
Определить задержку в секундах автоматического за- | 
‚ пуска хранителя экрана. Параметр руРагат должен 
указывать на целую переменную, в которую возвра- 
‚ щается затребованная величина. Параметр шРагапт 


Только для Мом 95: получить информацию о воЗ- 
 можностях зег1а1Кеуз — интерпретации данных, по- 
`лученных из последовательного порта, как системных. 
‘команд имитации управления клавиатурой и мышью. | 
| Параметр руРагат указывает на структуру типа ЭЕ- 
| 
| 


' ВТАТКЕТУХ5, а параметр и!Рагашт определяет размер 

‚структуры — члхео (ЗЕВТАТКЕУХ5). То же значение 

‚ должно иметь поле е5512е структуры. Должно быть | 
‘заполнено таже поле 1р52АсНуеРог{ — указатель на | 
‚ строку с именем порта («Ащщфо», если любой порт, 
‚и МОШЬ, если порт не определен). В поле 1р$2Рог 
‚должен быть записан МОТ.Г.. Поля мЕ1ар$, 1Ваа@дВафе | 
И 1Рогё 5$ же заполняются функцией. См. их описание | 
в: _| В справке С С++Ви|аег. —_ 


‘Определить, включен ли режим визуального оповеще- | 
‚ния о системных звуковых сигналах для людей 

‚ с ослабленным слухом. Параметр руРагат должен 
‘указывать на булеву переменную, в которую возвра- 
щается фгае, если режим включен, и #а]5$е в против- 
‘ном случае. Это эквивалентно вызову аеЗузетМе- 
'71с$ ($М_$НОМ$5О0М5), но выполняется эффектив- 
нее. — | 


Только д для \Ушаоме МТ: определить, включен ли ре- 
‚ жим автоматического перемещения курсора мыши 
‚К кнопке по умолчанию диалогового окна (кнопки 
ОК, Применить и т.п.). Параметр руРагат должен 
‘указывать на булеву переменную, в которую возвра- | 
‚ щается фгае, если режим включен, и #ЁаЁ5е в против- 
‚ном случае. Параметр и!Рагашт не используется. 


Получить информацию о режиме визуального опове- 
щения о системных звуковых сигналах для людей 

с ослабленным слухом. Параметр руРагат указывает 
‚на структуру типа ЗООМОЗЕМТВУ, а параметр и1Ра- 
‘гаш определяет размер структуры — $512ео ($09 МО- 
 ЗЕМТКУ). То же значение должно иметь поле с6512е 
‘структуры. Остальные поля заполняются функцией. 
‚Поле 4мЕ!а5$ содержит значение $5Е_АУАП.АВЕЕ, | 
если режим доступен, и значение 55Е_ЗООМОЗЕМТ- 
 ВУОМ, если он включен. Остальные поля структуры 
‚ определяют особенности визуального отображения. 
‚См. подробности в справке С++ВиПдег.. | 
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_ЗРТ. СЕТЗТЕСКУКЕУ 


РТ СЕТТОССТЕКЕУ$ _ 


_$РТ СЕТ\НЕЕТ.5С- | 
`ВОПЛЛМЕЗ 


$РТ бЕТУИМРОМ- 
`ЗЕХТЕМЗТОМ 


`ЗРТ СЕТУОВКАВЕА _ 


_ЗРТ 1СОМНов170М- | 
 ТАГЗРАСИУ@ 


- $ЗРТ 1СОМУЕВТТСАТ5- 
РАС = 


‚ РГ ТАМСОВТУЕВ _ 


_$РТ_ЗСВЕЕМЗАУЕВ-_ 
 ВОМмММС 


‚можно отпустить, и она остается активной до нажа- 


КЕУб). То же значение должно иметь поле еЪ$12е 
структуры. Поле 4мЕ1а5$ заполняется функцией и со- |! 
‚держит совокупность флагов. Основной из них — 
ЭКЕ_5ИСКУКЕУЗОМ, обозначающий, что режим 
включен. Остальные флаги уточняют характеристики 


‚метр руРагат указывает на структуру ТОбСТГЕКЕ- | 
_У5, а параметр и1Рагат определяет размер структу- | 
‚ры — чтео (ТОССТЕКЕУ5). То же значение должно 
‚иметь поле с6512е структуры. Поле амЕ1а5$ заполня- | 
‘ется функцией и содержит совокупность флагов. 
Основной из них — ТКЕ ТОССЬГЕКЕУЗОМ, обознача-, 
‘ющий, что озвучивание включено. Остальные флаги 


__ ние в справке С++Ви|Наег). 


| 
Н 
| 
‚ванная величина. Значение по умолчанию — 3. Пара- | 
| 
р 
| 
} 
| 


вать на структуру типа ВЕСТ, в которую функция 
__ возвращает размер области. 


Установить ширину пиктограмм. Параметр и1Рагат 


‚задает высоту. В пикселах. | 


Получить информацию о о режиме залипания клавиш, | 
‚ позволяющем заменить одновременное нажатие ком- 
‚бинаций горячих клавиш поочередным: нажатую 

вспомогательную клавишу (С411, А\, 51, У119о\з) 


‚ на структуру типа ЭТ1СКУКЕУЪ, а параметр шРа- 


| 
‚тия другой клавиши. Параметр руРагат указывает 
| 
‘гаш определяет размер структуры — $12ео (5ТТСКУ- 
| 

| 


| 
| 
| 
этого режима (см. их описание в справке › С++Виег)._ 
| 


Получить информацию об озвучивании переключения | 
‚режимов для людей с ослабленным зрением. Пара- 


‘уточняют характеристики озвучивания (см. их описа- 


ОНИ — д 


Только для УшЧомз МТ: определить заданное число — 
строк, прокручиваемых при вращении колесика 

мыши. Параметр руРагат должен указывать на пере- | 
менную типа ТМТ, в которую возвращается затребо- 


метр ч1Рагаи не используется. 


Только для У ш94о\з: определить, установлено ли рас-. 
'ширение \У1п4омз Раз! . В параметре шРагат надо 
‘задать 1. Параметр руРагат не используется. Функ- 
‚ция возвращает фгие, если расширение установлено, 
- и #[5е в противном случае. 


Определить размер рабочей области экрана, не заня- \ 
той полосой задач. Параметр руРагат должен указы- | 


| 
| 
ЫУФд— 


‚задает ширину в пикселах. | 
а 
‚Установить высоту пиктограмм. Параметр и!Рагат 


_Пока не реализовано. ] 


Только для Утдомз 95 и только для внутренних це- ' 
` лей. Приложения не должны использовать этот флаг. 


} 
{| 

—_—= =. ;. 
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ЭРГ_З5ЕТАССЕ$ЗТ1- `Задать интервал времени без нажатия клавиш и кно- 


МЕООТ ‚пок мыши, после которого отключается фильтрация 
‘ввода — игнорирование слишком кратких или по- 
‘вторных нажатий клавиш и управление скоростью | 
‹ повтора при удержании клавиши в нажатом положе- 
нии. Параметр руРагат указывает на структуру типа 
‹ АССЕЗЗТТМЕОСТ, а параметр шРагат определяет 
размер структуры — $12ео (АССЕЗЗТТМЕОТТ). То же 
‘значение должно иметь поле е6$12е структуры. 

‚ В поле ТипеОщМ5$ес структуры заносится устанавли- 
‚ваемый интервал времени в миллисекундах. А в поле 
`Ф\Е1а55 можете занести флаг АТЕ_ТТМЕООСТОМ — 

‚ бесконечный интервал, и флаг АТЕ _ ОМОЕЕЕЕЕР- 
_ВАСК - — звуковое извещение о конце интервала. 


ЭРТ ЗЕТАМТМАТТОМ Включить или выключить эффекты анимации. Пара- | 
' метр руРагат указывает на структуру типа АММА- | 
ТТОМТЕО, а параметр и1Рагат определяет размер 

| структуры — $12ео (АМТМАТТОМУ\ЕО). То же значе- 
‘ние должно иметь поле с6517е структуры. В поле 1М:!- | 
'ПАпппа{фе структуры заносится 1, если анимацию | 
‚надо включить, и 0, если анимацию надо выключить. 


ЭРТ 5ЕТВЕЕР Включить или выключить звуковую индикацию оши- 
бок. Параметр и1Рагаш надо установить в 0, если 

‘надо выключить индикацию, и установить в 1, если | 
‘надо включить ее. Параметр руРагат не использует- | 
ся и должен быть равен . МОГГ._ 


и 
ЭРТ ЗЕТВОВОЕК Установить толщину бордюров о окон. . Параметр шРа- 
‘гаш определяет ширину бордюра. Параметр руРагат | 
— _ не используется и должен быть равен МОГ. | 
ЭРТ ЗЕТОБЕЕАОТЛТУ- ‘Установить язык по умолчанию. Параметр руРагат 
РОТЕАМС ‘должен указывать на 32-битную переменную, в кото- 
‚рой указан дескриптор раскладки клавиатуры по 
—_ __ _ и умолчанию. Параметр и\1Рагат не используется. 
ЭРТГ_ ЗЕТОЕЗКРАТ- ' Установить текущую конфигурацию Рабочего стола, 
ТЕВМ _ |8 записанную в файле И’т.пы в разделе «РаЦегп = ...» 
ЭРТ _ ЗЕТРЕЗКУ АТ ‚ Установить обои Рабочего стола. Параметр р руРагат 
ТРАРЕВ ‘должен указывать строку с полным именем графиче- 
В ского файла обоев. Параметр \1Рагат не используется. а 


ЭРТ_ ЗЕТРООВЕЕСТЛС-_ Установить максимальную задержку нажатия кнопки 
КТМЕ мыши при двойном щелчке. Задержка в миллисекун- 
‘дах задается параметром и1Рагашт. Параметр руРагат 
_|не. используется и должен быть ‘равен. МОГ. 


ЭРТ ЗЕТОРООВЕЕСТК- Установить высоту области, внутри которой повторный 

НЕССНТ ‚ щелчок мыши воспринимается как двойной щелчок. ый 
Высота задается параметром шРагат. Параметр руРа- 
‘гат не используется и должен быть равен МОТЕ. _| 


ЭРТ ЗЕТОООВЬЕСГК- Установить ширину области, внутри которой повтор- 
\УТГОТН ‘ный щелчок мыши воспринимается как двойной щел- 
‚чок. Ширина задается параметром \Рагат. Пара- 

' метр руРагат не используется и должен быть равен 


ЗузетРагатеег$тТо — получение и установка системных параметров 719 


`ЗРТ ЗЕТОВАСЕОТ- 
ГМО $ 


эЭРГ_ЗЕТОВАСНЫСНТ 
| 


ЭРГ_ЗЕТОКВАС\УШТН 


`ЗРГ_ЗЕТЕАЗТТА$К$5- 
УАТСН 


‘Включить или выключить режим отображения содер- 
' жимого окна при перетаскивании. В параметре шРа- 


гат задается 1 для вкличения режима, или 0 для его 
выключения. Для У шАо\з 95 этот флаг поддержива- 
ется только если установлен У\У/ш@Чо\жз Р[аз! (см. 

ЭРТ СЕТ\УТМООМ5ЕХТЕМЗТОМ). Параметр руРа- 
гат не используется и должен быть равен МОШ.. 


Установить высоту области, используемой для иден- 
тификации начала операции перетаскивания. Переме- 
‘щение курсора мыши с нажатой клавишей на боль- 
‘шее расстояние фиксируется как начало перетаскива- | 
ния. Высота в пикселах задается параметром ш1Ра- | 
гаш. Параметр руРагат не используется и должен 
быть равен МОГГ. Текущее значение высоты можно 
‚ получить флагом З°М_СУОВАС при вызове функции 
Се ЗузетМейчс$. 


‘Установить ширину области, используемой для иден- 
‚тификации начала операции перетаскивания. Переме- 
щение курсора мыши с нажатой клавишей на боль- 
шее расстояние фиксируется как начало перетаскива- 
‘ния. Ширина в пикселах задается параметром \1Ра- 
‘гат. Параметр руРагат не используется и должен | 
‘быть равен МОТ... Текущее значение высоты можно 
‘ получить флагом ЗМ_СХОКАС при вызове функции 


 СефЗузетМейт1с$. 
' Устаревший флаг, позволявший в ранних версий 

' М7тао\з включать и выключать возможность пере- 
‘ключения между окнами клавишами АЁЦ{-ТаЬ. Начи- 


| можно. 


НИ ———- —_—_—_ 4 


ЗРТ ЗЕТЕПТЕВКЕУ$ 


ООО диво обильно ООО 


‘ная с Ушдо\з 95 и \Мшдомз МТ 4.0 это всегда воз- 
| 


Установить характеристики фильтрации ввода — иг- 
норирования слишком кратких или повторных нажа- 
тий клавиш и управление скоростью повтора при 
‚удержании клавиши в нажатом положении. Параметр | 
руРагашт указывает на структуру типа ЕП.ТЕВКЕУХ5, 
| а параметр и1Рагаш определяет размер структуры — 
‚ 17ео(ЕП.ТЕВКЕУ5). То же значение должно иметь 
поле сЬ512е структуры. В поле 4мЕ1а5$ записывается | 
‘комбинация флагов, из которых основной ЕКЕ_ЕП-- 
'ТЕВКЕУЗОМ — если он имеется, фильтрация вклю- | 
‚ чается. Поле 1\Уа /М5ес содержит задержку, после 

| которой срабатывает нажатая клавипта. Поле даа- 
`УМ5ес — задержка начала повтора при нажатой кла- 
‘више, а поле {Вереа{М$ес — интервал повтора. Поле 
 ВоипсеМ$ес — интервал, в течение которого игнори- 
руется повторное нажатие клавиши. Поля ШО@ауМ- 

' Зес и 1ВоипсеМ$ес не могут иметь ненулевое значе- 
'ние одновременно. Все задержки указываются в мил- 
'лисекундах. 


ЗРГ ЗЕТРОМТ5МООТ- | 
Н1\6 


| 


Включить 1 или выключить возможность сглаживания 
‘экранных шрифтов. В параметр шРагат заносится 1, 
‚если возможность надо включить, и 0, если возмож- 

‚ность надо выключить. Для \/1119о\з 95 этот флаг 

‚ поддерживается, только если установлен \/11Чо\з$ 
| Р1аз! (см. 5Р1 _СЕТМ\У1ТМООМ 5ЕХТЕМЬТОМ). 


'ЗР. ЗЕТСЕВШСВАМО- 


| СГАВТТУ 


| 
ЭРГ_ЗЕТНАМРНЕГО 


используется и должен быть равен МОГГ. 
Е 


‘Установить значение размера зерна экрана. Размер 
‘задается параметром шРагат. Параметр руРагат не 


‘Используется внутренне. Приложения не должны 
применять этот флаг. 


| 
| 
НЫ 
| 
р 


‚ ЗРГ_ЗЕТНУСНСОМТ- 
' ВАЗТ 


| 


| 
' ЭРГ_ ЗЕТ1СОММЕТ- 
В1С$ 


ОИ 


| $РТ_ЗЕТТСОМТЕТЕ- 
| ГОбРОМТ 


ЗРТ_ ЗЕТТСОМТИТЕЕМ- 
ВАР 


‘Только для У/1а0\з 95: установить характеристики 

‚ режима высокой контрастности. Параметр руРагат 
‘указывает на структуру типа Н1СНСОМТВАЗТ, а па- 
‹раметр и1Рагат определяет размер структуры — $12е- 
оНТОНСОМТВАЗТ). То же значение должно иметь 

‘ поле е6З1те структуры. Поле 4\Е]а55. содержит ком- 
бинацию флагов, из которых основной НСЕ_ШСН- 

‚ СОМТВКАЗТОМ — если он имеется, режим включает- 
‚ ся. Поле 1р$2Беаи Ц ЗсВете указывает на строку, со- 


держащую ИМЯ используемой по умолчанию цветовой | 


| схемы. 


Установить параметры метрики пиктограмм. Пара- 
‘метр руРагат указывает на структуру типа 1СОМ- 
‚ МЕТВГС5, а параметр шРагат определяет размер 
‘структуры — $12ео (ТСОММЕТВТС5). То же значение 
‘должно иметь поле е6512е структуры. В полях Шог?7- 
 Зраешт& и 1УегЕЗрасте указываются соответственно 
‚горизонтальный и вертикальный размеры зазором 

‚ между пиктограммами при их выравнивании. Поле 

‚ Ге\гар определяет, должен ли осуществляться ли 


‚ (при ненулевом значении) перенос длинных заголов- 


нет). Поле Еопф определяет шрифт заголовков. 


` Задать характеристики шрифта заголовков пиктог- 
‹рамм. Параметр руРагат указывает на структуру 
‘типа ГОСЕОМТ, а параметр и1Рагаш определяет раз- 
‘мер структуры — $12ео (ТОСЕОМТ). Основные поля 

` структуры, которые надо заполнить, следующие (см. 
подробнее в справке С++Ви!@аег). В поле Нее за- 
носится величина, определяющая вертикальный раз- 


‘мер шрифта: 0 — используется размер по умолчанию, ‚ 
‚ ненулевое значение — высота в логических единицах. | 


В поле И\М! ев передается толщина линий от 0 до 

| 1000 (нормальная — 400, жирная — 700). Поле ИЕа- 
` сеМаше содержит имя шрифта. Поле МОмещайоп 
указывает угол наклона текста в десятках градусов. 


‘Включить или выключить возможность переноса 
‘длинных заголовков пиктограмм на новую строку. 
'В параметр шРагат записывается 1, если перенос 
‘надо включить, или 0, если перенос надо запретить. 
‚Параметр руРагаш не используется и должен быть 
‚равен МОТ. 


^ 
И 


‚ ков на новую строку (при нулевом значении переноса 
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`РЕГАУ которой символ начинает повторяться. Задержка 
‚в миллисекундах задается параметром и\Рагат. Па- 
раметр руРагаш не используется и должен быть ра- 


о овен МО 
‚ РГ ЗЕТКЕУВОАВОР- |Только для У/ш4домз 95: включить или выключить 
`ВЕЕ ‚режим управления мышью с помощью цифровой кла- 


`виатуры. В параметр шРагат записывается 1, если 
режим надо включить, или 0, если его надо выклю- 
чить. Параметр руРагат не используется и должен 
быть равен МОТГ.. 


| 


Задать скорость повторения символов при удержива- 
'РЕЕБ нии клавиши. Задается параметром и1Рагат. Пара- 
| метр руРагат не используется и должен быть равен 


РТ ЗЕТКЕУВОДЕВО5- 


‚ ЭРГЗЕТЕАМСТОССЬГЕ 
| мый язык. Параметры и1Рагат и руРагат не исполь- 
зуются. Сочетания горячих клавиш читаются из ре- 
естра, где они предварительно должны быть записа- 
ны. Сочетания хранятся в ключе НКЕУ СОБ- 
'ВЕМТ_ОЗЕВ \ Кеуфоага Гауоц* \ Тосе. Возможные 
значения параметров: 1 — АШ-551, 2 — С-З, 
| 3 — не заданы. 
‚ 5РГ ЗЕТГОМРОМЕ- Только для У/т9о\з 95: включить или выключить пе- | 
ВАСТТУЕ `реход в режим пониженного энергопотребления при | 
| срабатывании хранителя экрана. В параметр шРагат 
‚ записывается 1, если возможность перехода надо 
‘включить, или 0, если ее надо выключить. Параметр 
руРагат не используется и должен быть равен МОТГ. 


— д че. 


РГ ЗЕТГОМРОМЕВ- Только для У/ш9омз 95: задать задержку перехода 
- ТТМЕООТ | В режим пониженного энергопотребления при сраба- 
| ‘тывании хранителя экрана. В параметр и1Рагат за- | 
_ 'писывается задержка. Параметр руРагаш не исполь- , 
зуется и должен быть равен МОЕГ. 


уч 


РГ ЗЕТМЕМООКВО- Задать появление выпадающего меню слева, или 

‚ РАШСММЕМТ справа от соответствующего головного раздела. В па- | 
| раметр и1Рагат записывается 1, если меню должно — 
появляться справа, или 0, если оно должно появлять- | 
| ся слева. Параметр руРагат не используется и дол- 
` жен быть равен МО1Ш.. 


=—= — = = — =—=: г === == ==: =-— ое пЕССТЕ г ЕР тит токе] 
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ЭРТГ ЗЕТМИМТМТИЕО- | Установить метрику свернутых окон. Параметр руРа- ‚ 
МЕТВ!С$ гаш указывает на структуру типа МИМ1МТАЕОМЕТ- 
В1С, а параметр и1Рагат определяет размер струк- 
туры — $12ео (МТМТМТЛЕОМЕТВТС5). То же значе- 
ние должно иметь поле еБ$12е структуры. В поле 
ТУ заносится ширина свернутого окна в пиксе- 
лах. В поля Шог2Сар и 1Уе Сар заносятся интерва- 
лы по горизонтали и вертикали между свернутыми 
окнами. В поле 1Аггапее заносится начальная пози- 
ция и направление упорядочивания. Начальная пози- 
ция определяется одним из следующих значений: 
АВУ\У_ВОТТОМЕЕЕТ, АВ\_ВОТТОМЕТСНТ, 
АКУ\У’_ТОРГЕЕТ, АВ\_ТОРЕСНТ — соответственно | 
нижний левый, нижний правый, верхний левый, вер-_ 
хний правый угол рабочей области. Направление упо- 
рядочивания задается одним из следующих значений: 
АКУ\У_ТГЕЕТ — влево (при АКВУ\У_ВОТТОМСНТ или 
АВ\У_ТОРЕ1СНТ), АВУ\У_ВТСНТ — вправо (при 
АВ\У_ВОТТОМЕЕЕТ или АВМ_ТОРГЕЕТ), 

АВУ’_ ТОР — вверх (при АК\_ВОТТОМЕЕЕТ или 
АВУ\У _ВОТТОМВСНТ), АВУ_ _ФОММ — вниз (при 
АВУ_ТОРЕГЕЕТ или АВ\ _ТОРЕСНТ). 


Задать информацию о двух пороговых значениях 
и скорости мыши. Параметр руРагат должен указы- 
вать на массив из трех целых величин, в которые за- 
носятся эти значения. 


ЭРГ_5ЕТМООЗЕ 


— 


од 
Изменить или восстановить назначение кнопок 
мыши. Если в параметр шРагат записать 1, функ- 
ции левой и правой кнопок мыши поменяются: пра- 
вая станет основной, а левая вспомогательной, вызы- 
вающей контекстные меню и т.п. Если в параметр 

и Рагат записать 0, то восстановятся исходные функ- 
ции кнопок. Параметр руРагат не используется 

и должен быть равен МОГГ. | 


ЭРТ_ ЗЕТМООЗЕНО- Только для У шао\мз МТ: установить высоту в пиксе- 

УЕВКНЕСНТ лах рамки, пребывание курсора мыши внутри кото- 
рой вызывает функцию ТгасКМоцзеЕуеп{ для генера- | 
ции сообщения \УМ_МООЗЕНОУХЕК. Высота задается. 
параметром шРагат. Параметр руРагат не исполь- 
зуется и должен быть равен. МОГГ. 


ЭРГ_ЗЕТМООЗЕВОТ- 
ТОМ5\АР 


ЭРГ_ЗЕТМОПОЗЕНО- ‘Только для У\Ушао\з МТ: задать интервал времени, | 
УЕВТТМЕ в течение которого указатель мыши должен пребы- 
вать внутри рамки, чтобы функция ТгаскКМоизеЕуепф 
 сгенерировала сообщение УМ_МОПЗЕНОУЕВ. Ин- 
` тервал задается параметром иРагат. Параметр руРа- ! 
гаш не используется и должен быть равен МОТ. 


ИОНЫ о 


ЭРТ ЗЕТМООЗЕНО- ‘Только для У тао\мз МТ: установить ширину в пиксе- 
УЕВУ\УТОТН `лах рамки, пребывание курсора мыши внутри кото- 

рой вызывает функцию ТгаскКМоизеЕуеп{ для генера- ' 
ции сообщения \УМ_МООЗЕНОУЕВ. Ширина задает- | 
‘ся параметром шРагат. Параметр руРагат не испо- | 


‘льзуется и должен быть равен МОЕГ. — 
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указывает на структуру типа МООЗЕКЕТХЪ, а пара- 

‚ метр !Рагат определяет размер структуры — $12е- 
 Оо(МОПОЗЕКЕХ5). То же значение должно иметь поле | 
с6512е структуры. Поле 9мЕ1ая$ содержит комбина- 
цию флагов, из которых флаг МКЕ_АУАП,АВГЕ го- 

| ворит о том, что этот режим включается. Остальные 
флаги и остальные поля структуры определяют те 
‚или иные особенности режима. См. подробности 


ЭРТ_ЗЕТМООЗЕТКА- 
| ПУ 


$РТ_ЗЕТМОМСМЕМТ- 
`МЕТЕГС$ 


, ЗРТ_ЗЕТРЕМУТМ- 
`20%3 


| ЗРГ_ ЗЕТРО\ЕВОЕ- 
‚ РАСТТУЕ 


| 
! 


РГ ЗЕТРО\ЕВОЕ-. 
ЕТТМЕООТ 


т 


‚ РЕВ 


= —=————_--. 


‚не используется и должен быть равен МОТ. 


ЗРТ ЗЕТЗСВЕЕМЗА- 


` УЕАСТТУЕ 


| 
| 
| 


‘режим отображения следа указателя мыши. Если зна-. 
‚чение шРагат задать равным 0 или 1, то этот режим _ 
‚будет выключен. Значение большее 1 свидетельствует . 
о включении режима и указывает число изображений _ 
‚курсора при его перемещении. Параметр руРагат не 
‘используется и должен быть равен МОЕГ. 


ни _- 


Установить характеристики метрики неклиентской | 
‚ области несвернутого окна. Параметр руРагат указы-. 
‚ вает на структуру типа МОМСШЕМТМЕТЕТСЬ, а па- _ 
 раметр иРагаш определяет размер структуры — $12е- 

‚ Оо(МОМСЫЕМТМЕТВТС5). То же значение должно 
‘иметь поле себ 512е структуры. Остальные поля опреде- 

‚ ляют характеристики бордюра, полосы меню, полос 
‘прокрутки и многое другое. См. подробности в справ- 


ке С-+-+Ви!аег.. 


‚Только для \/1п90о\з 95: загрузить или выгрузить перо . 
окон. Задание и!Рагашт = 1 соответствует загрузке 
пера, а значение 0 выгружает перо. Параметр руРагат 


Только для У шао\з 95: включить или выключить 
‘режим автоматического отключения питания при ра- 
боте хранителя экрана. Задание \Рагат = 1 соответ- 
‚ствует включению режима, а значение О — отключе- 
‘нию. Параметр руРагат не используется и должен 


быть равен МОГ.Г. 
Только для У 1т9омз 95: задать задержку автоматиче-_ 
| ского выключения питания при работе хранителя эк- 
‘рана. Задержка задается параметром шРагат. Пара- 
‘метр руРагат не используется и должен быть равен 


ЭРТ_ЗЕТЭСКЕЕМВЕА- Только для У/тш4о\мз 95: включить или выключить ре- 


‘жим замены графической информации текстовой, пе- 
‘ресылаемой на синтезатор речи или описываемой на 
‘экране пприфтом Брайля. Задается параметром 1\Ра- 
‘гаш: 1 — включить, 0 — выключить. Параметр руРа- 


‘гаш не используется и должен быть равен МОТ... 


‚ Включить или выключить режим автоматического за- 
‚пуска хранителя экрана. Задается параметром шРа- 
‘гаш: 1 — включить, 0 — выключить. Параметр руРа-. 
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‚ Установить задержку в секундах автоматического за- 
‘пуска хранителя экрана. Задается параметром ш1Ра- 
гат. Параметр руРагат не используется и должен 


| $ЗРГ_ЗЕТЗЕВЛАТКЕУ$ 


‚ ЭРЕЗЕТЗНОМЪ5О- 


| 9№05 


Только для УИ таомз 95: задать информацию о воз- 
можностях зета|Кеуз — интерпретации данных, по- 


Параметр руРагат указывает на структуру типа ЗЕ- 
ВТАГКЕУ5, а параметр и!Рагат определяет размер 
структуры — з12ео (ЗЕВТАТКЕУ 5). То же значение 
‘должно иметь поле сБЗ12е структуры. Поле 1р52Ае8- 
уеРог{ — указатель на строку с именем порта 
‘(«Ащфо», если любой порт, и МО, если порт не 

‚ определен). В поле 1р$2Рог{ должен быть записан 
МОТ.. Должны быть заполнены также поля МЕ ]а5$, 
1ВапаВафе и 1Рог{ 5 фе заполняются функцией. См. 
их описание в справке С++Ви!аег. 


‚Включить или выключить режим визуального опове- 
щения о системных звуковых сигналах для людей 
с ослабленным слухом. Задается параметром 1Ра- 


‘гаш не используется и должен быть равен МОТГ. 
— —_—щ-- - --.. ---. -— =. ---- — ОНИ ==. и оч п и а еее - -- 


$Р1_ЗЕТЗМАРТОРЕЕ- 
ВОттОМ 


Только для У\УшШаомз МТ: включить или выключить 
режим автоматического перемещения курсора мыши 
к кнопке по умолчанию диалогового окна (кнопки 
ОК, Применить и т.п.). Задается параметром и1Ра- 


| ЗРТ_ЗЕТЗООМОЗЕМТ- 
‚ ВУ 


Задать информацию о режиме визуального оповеще- 
‚ния о системных звуковых сигналах для людей 


гат определяет размер структуры — $12ео ($ООМЬ- 
ЗЕМТКУ). То же значение должно иметь поле се 512е 
структуры. Поле амЕ1а55$ должно содержать флаг 


ЭЗЕ_АУАП,АВГЕ, если режим надо сделать доступ- 
‚ным, и значение 55Е_ЗООМОЗЕМТЕУОМ, если его 

` надо включить. Остальные поля структуры определя- 
| ют особенности визуального отображения. См. по- 

‚ дробности в справке С++Ви!|аег. 


‚ лученных из последовательного порта, как системных ' 
| команд имитации управления клавиатурой и мышью. . 


гат: 1 — включить, 0 — выключить. Параметр руРа-. 


с ослабленным слухом. Параметр руРагат указывает | 
на структуру типа ЗООМОЗЕМТВУ, а параметр шРа- | 
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гат: 1 — включить, 0 — выключить. Параметр руРа-. 
| гаш не используется и должен быть равен МОТ. . 
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"бр. ЗЕТЗТИСКУКЕУ 5 Задать информацию о режиме залипания клавиш, по-. 
‘зволяющем заменить одновременное нажатие комби- 
наций горячих клавиш поочередным: нажатую вспо- 
| могательную клавишу (С%4г|, А\, 51, У Шшт9омз) 
можно отпустить, и она остается активной до нажа- | 
тия другой клавиши. Параметр руРагат указывает 
на структуру типа ЗТСКУКЕТХБ, а параметр шРа- 
гат определяет размер структуры — $12ео (ЗТТСКУ- _ 
КЕУ5). То же значение должно иметь поле еЪ512е 
структуры. Поле а4мЕ1а$ должно содержать совокуп- | 
| ность флагов. Основной из них — ЭКЕ 5ИСКУКЕУ- 
5ОМ, обозначающий, что режим включен. Остальные , 
флаги уточняют характеристики этого режима (см. их, 
- описание в справке С++Ви|4ег).. 


що —щ- оо щен —-- - Ее же + 


в 


‚РГ ЗЕТТОССГЕКЕУ$ | Задать информацию об озвучивании переключения 
| режимов для людей с ослабленным зрением. Пара- 
метр руРагат указывает на структуру ТОСОСТЕКЕ- 
У5, а параметр и1Рагаш определяет размер структу- 
ры — $12ео (ТОССГЕКЕУХ5). То же значение должно 
иметь поле сЪ$17е структуры. Поле дмЕ1а5$ должно 
содержать совокупность флагов. Основной из них — 
ТКЕ_ТОССТГЕКЕУЗОМ, обозначающий, что озвучива- 
ние должно быть включено. Остальные флаги уточня- 
ют характеристики озвучивания (см. их описание 

_|в справке С++Ви|Цаег). 


| 
р 
, 
| 
| 


` ЗРТ. ЗЕТУНЕЕТС- Только для \!119490\$ МТ: задать число строк, прокру- 
‚ ВОТЛЛЛМЕ$ чиваемых при вращении колесика мыши. Это число 
. задается параметром и1Рагат. Если задать значение 
.0, прокрутки не будет. Значение по умолчанию — 3. 
Если задать число больше, чем число видимых строк, 
или задать равным \УНЕЕГ РАСЕЗСКОТТ, (соответ- 
‘ствует ОТХТ МАХ), то вращение колесика интерпре- | 
тируется как щелчок на полосе прокрутки над или 
под движком. 


ОИ ОНО ОА ЬИ ОВО ИВ И а а... 


_$РТ. ЗЕТ\ОВКАВЕА | Задать размер рабочей области экрана, не занятой по-. 
лосой задач. Параметр руРагат должен указывать на . 
структуру типа ВЕСТ, в которую заносятся координа-_ 
ты области. : 


Выше приведен полный список возможных значений параметра шАсйоп. 
Смысл параметров шРагат и руРагат, как видно из таблицы, определяется 
параметром и1Аейоп. Если параметр ш!Рагат не используется, он должен 
быть равен 0. Если параметр руРагат не используется, он должен быть равен 
МОЕББ. 

Параметр ЁЕУИ ши при режимах установки системных параметров опреде- 
ляет, должен ли обновиться профиль пользователя и следует ли послать всем 
окнам верхнего уровня сообщение ММ_5ЗЕТТИМССНАМОСЕ, извещающее об 
изменении системных параметров. Параметр Е! тПи может быть равен 0, или 
может равняться одному из следующих значений: 
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ини И 
ЭРТЕ_ ОРРАТЕТГМТЕП.Е | Записать новые параметры в профиль пользова-. 
теля. 


| 

Разослать сообщения \УМ_$ЗЕТТТМССНАМСЕ | 
после обновления параметров, не записывая па- | 
раметры в профиль пользователя. 
ДМ —_—_—_ 


ЭРТЕ_ЗЕМРУ1МИСНАМСЕ | Идентично ЗРЕ_ЗЕМОСНАМСЕ. 


—— 


$РТЕ_бЕМОСНАМСЕ 


При значениях ЭРТЕ_ЗЕМОСНАМСЕ или ЭРТЕ_ ЗЕМОМТМТИМСНАМСЕ 
новые параметры будут действовать только во время текущего сеанса работы 
данного пользователя. При перезагрузке \У/1149о\з$ или при смене пользователя 
восстановятся прежние значения параметров. 

Функция ЗузетРагатефег шо возвращает ненулевое значение в случае 
успешного завершения. 

Примеры применения функции вы найдете в разд. 1.3, 1.4, 1.5. 


ЗУЭТЕМ"ТМЕ (Т5узетТипе) — тип структуры, содержащей 
информацию о дате и времени 


Тип структуры, содержащей информацию о дате и времени. 


Заголовочный файл И/’/т4оиз.йрр 


Синтаксис 
суреаеЕ зегисе _ЗУЗТЕМТТМЕ { 
ИОВ муУеаг; // год 
ИОВР иМопЕП; // месяц (январь - 1, 
// февраль - 2 ит.д.) 
ИОВО мрауоЕМеек; // день недели (воскресенье - 0, 
// понедельник - 1 ит.д.) 
ИОВО ипау; // день месяца 
ИОВР мНопйг; // час 
МОВО мМ1па*е; // минута 
ИОВОР ибесопа; // секунда 


ИОВО имМ11115есопа$; // миллисекунда 
} ЗУЗТЕМТТМЕ, *Р5ЗУЗТЕМТТМЕ, *ГРЗУСТЕМТТМЕ; 


суреаеЕ _ЗУЗТЕМТТМЕ Т$узфепТ1пе; 


Описание 
Тип структуры ЗЭУЗТЕМТТМЕ (Т5ЭузетТипе) используется многими 
функциями АР] \У!1т9омз для отображения времени. Поля этой записи означа- 
ют следующее. 


—- — Е НИ — .—- — Е ея 


и И 


| 
о — 


месяц (январь — 1, февраль — 2 ит.д.) _ 


день недели (воскресенье — 0, понедельник — 1 ит.д.) — | 


день месяца 


]мНопг 


\“Мшще 


уЗесоп@ секунда 


\МИ5есоп@$ миллисекунда _ 
нид ПБ АЯ, ЛидлььнИНИЙ —. и 
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Непосредственное сложение или вычитание значений типа ЗУЗТЕМТТМЕ 
не рекомендуется. В АРТ \Уш4о\мз рекомендуется для подобных операций пе- 
ревести сначала структуру, например, в структуру типа ЕШЕТМУЕ, затем пре- 
образовать ее в структуру типа ГАВСЕ_ТМУТЕСЕК, а уж с этой записью можно 
осуществлять арифметические операции. Однако в С++ВиПаег имеется более 
простой способ — функция ЗузетТипеТора%&еТ1те. Она переводит значение 
ЗУЭТЕМТМЕ в тип ТОаеТ!те, к которому можно применять арифметиче- 
ские операции. 


ЗузетТипеТтТоджеТипе — переводит отображения дат и времени 
См. функцию ВаёеТипеТоЗузет'Тите. 


Тегиипа4еРгосез$ — завершет процесс 
См. функцию де РиогцуС1а$$. 


ТегиипайеТЬгеаЯ — завершет поток 
См. функцию ЕхИ'ТЬгеа4. 


ТЕЦе{геат — конструктор, методы и свойства потока 
Модуль С[1а35ез 


Синтаксис 


__Еаз®са11 ТЕ11е5егеам (сопзЕ Ап515Ег1лпа Е11еМаме, Мога Моае); 
__ргорег®у 1пЕ Напа1е; 
ргорег®у 10664 Роз1Е1оп; 


_ ргорег®у —_ 10564 $12е; 


У1геиа1 1пеЕ _ ЁЕаз®са11 Веаа(уо1а *ВиЕЕегк, 1п® Соипе); 

Уу01а __Еаз$&са11 КеааВаЕЕЁек (уо1а *ВоЕЕег, 1п& Сойпе); 

У1геиа1 1п& __ Еаз®са11 Иг1®е (сопзЕ уо1а *ВиЕЁЕег, 1пе Соцп®); 
У01а __ЁЕаз®са11] Мг1севВоЕЁек (сопзЕ ус1а *ВиаЕЕек, 1пе Соспе); 

ТСотшропепе* __Еазса11 КеаЯаСотропепе (ТСошропвепе* Тпзтапсе); 

у014 __Ёазеса11 Мг1$еСотропеп® (ТСомропепЕ* Тпзеапсе); 

__ 1064 __Еаз®са11 СоруЕгом (Т5&геам* $очгсе, __ 11664 СоцпЕ); 
епим ТбеекОг1а1т { зоВедтпплпа, зоСиггепе, зоЕпа }; 


\1г6иа1 __ 10664 __Еаз®са11 5еекК(сопзЕ __ 110664 ОЕЁЕзефк, 
Тбееког1а1пт Ог1ла1п); 
Описание 
Операции с файлами могут выполняться с помощью потоков класса 
ТЕПе&геат. Создание такого потока осуществляется вызовом конструктора 
ТЕПе{геат. Первый аргумент ЕЦеМаше — строка с именем файла. Если 
в ней не задан путь к файлу, подразумевается текущий каталог. Второй аргу- 
мент Моде определят режим открытия файла и может включать один флаг ре- 


тСгеа&е ‚ Создается файл с данным именем. Если подобный файл 
‘уже существовал, его содержимое стирается и файл от- 
р ‘крывается в режиме записи. 


| 
о. 


И 
‚ НпОрепКеа4 ‚Открывает существующий файл только для чтения. 
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{пОреп\У/гЦе Открывает существующий ‘файл. только для записи. 

_ Прежнее содержимое файла стирается. 
"И и — —_ ^ 

| пОрепВеад\тНе _ Файл открывается для чтения и записи. 


ЕЕ ОЕ РЕНИ - а -.—= ---:--: 


Е НЫ == р: === ео Е Ес 


| воЗвагеСотра _ | Доступ от определяется ЕСВ. 


-—.— Ще . — ея] 


рибВагеЕхсазуе Другие приложения не могут открыть файл ни для запи- . 
‘си, ни для чтения. 


= —__ =—— _- А, 


| 
ОИ 
Н | 

{юЭВагеДепу\тгЦце ‚ Другие приложения могут открыть файл только для чте- 
| ‘ния, но не для записи. 


| ИНН ли ИИ И 


НиЗВагеОепуВеаа. Другие приложения могут открыть файл только для за- - 
писи, но не для чтения. 


ТОРИ _ Я ООО 


| 
| ,абВагеепуМопе Полный я доступ к файлу др других приложений. 


После того как поток создан, его свойства НапШе, Ро$110п и 517е дают 
доступ соответственно к дескриптору потока (свойство только для чтения), 
к текущей позиции файла и его размеру. Размер 512е — свойство только для 
чтения, а текущую позицию Ро${10п можно изменять. Текущую позицию из- 
меняет также метод ЗееКк. Параметр ОЁ#5е{ этого метода указывает, на сколько 
должна быть сдвинута текущая позиция. Положительные значения соответст- 
вуют сдвигу к концу, а отрицательные — к началу потока. Параметр Омет 
указывает, от какой точки отсчета задается сдвиг параметром ОЁ5еф. Пара- 
метр Ог1ет может принимать следующие значения: 


зоРгошВебшише Сдвиг относительно начала потока. При этом значение 
| ; ОНзе 5её должно быть больше или равно 0. 


Г _ Ц ——щ—_ НИИ 


| зоРгошСигтеп < Сдвиг относительно текущей позиции Розюп. При 
‘этом значение ОЁ5еф может быть как положительным, 


_ так и отрицательным. 


О БЫ инь ИИ 


зогготЕпа | Сдвиг относительно конца потока. При этом значение 
. _, ОЁЁ5е% должно быть меньше или равно 0. 


— ===: ЕЕ Ет о ыч —=—Щ — ——= т :. === ЕЕ 2. ПЕТЬ ЕД. ЕЕДЕЕРЕШТЕГ Л.) 


Метод ЭЗееК возвращает новое значение текущей позиции Роз 1оп. 

Из файла, октрытого как поток, можно читать методом Веа4 и записывать 
в него методом У\У!Це. В этих методах параметр ВиЙЁег указывает буфер, в ко- 
торый заносятся читаемые данные или из которого данные записываются 
в файл. Параметр Соипф определяет размер буфера. Методы возвращают число 
прочитанных или записанных байтов. При чтении возвращаемое значение мо- 
жет быть меньше указанного параметром Соипф, если, например, в процессе 
чтения достигут конец потока (файла). Методы ВеадВиЁег и \УгЦеВоийЁег отли- 
чаются от методов Веа4 и УгЦе тем, что если не удалось передать Соип& байтов, 
генерируется исключение ЕВеа4Еггог или Е\/гцеЕггог соответственно. 

Чтение или запись рассмотренными методами осуществляется, начиная 
с текущей позиции. Методы сдвигают текущую позицию потока на число пере- 
данных байтов. 

Читать из потока и записывать в поток можно также методами Гоад- 
Егот${геат и ЗауеТо{геат, свойственными многим классам С++Ви!аег. 
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Ниже приведен пример записи текста в файл методом УгцЦе: 


ТЕ11ебегеап *Т = пем ТЕ11ебегеап ("Е.$хе", ЕмСгеафе); 
сраг *5 = "Это текст"; 

Т->Иг1ее ($, зЕх1еп(5)); 

Че1ехе Т; 


Следующий код служит продолжением примера и показывает чтение из 
файла методом Веад: 
Т = пем ТЕ11ебегеам("Е.6хе", ЕпОрепВеаа)}; 


сраг *51 = (сраг *)та11ос (Т->517е); 
Т->Веаа (51, Т->6517е); 


В этом коде под читаемую строку выделяется память, размер которой ра- 
вен размеру файла Э12е. 


Следующий код служит продолжением этого примера и показывает по- 
вторное чтение того же файла в окно Мето1 методом ГоаЯ9ЕготЭ#геат: 


Т->Роз1Елоп = 0; 
Мепо1->Ь1пез->ГоааЕгощб геац(Т); 
ае1еке Т; 


Первый оператор кода сдвигает позицию на начало файла, после чего 
текст читается в окно редактирования методом ГоадЕгот$ф{геат. 

Копировать файлы можно с помощью метода СоруЁРгот. Параметр Зоигсе 
определяет поток, из которого копируются данные, а параметр Соипф указыва- 
ет число копируемых байтов. Если Социф = 0, то копируется весь файл. Копи- 
рование призводится в тот поток, для которого вызывается метод СоруЕгот. 

Ниже приведен упрощенный пример копирования файла [Це1 в файл /Це2 
с помощью потоков: 

ТЕ11е5егеам * Тагаеф = пем ТЕ11]ебегеам ("Е11е2", ЕтСгеафе); 

ТЕ1]1ебегеам * боцгсе = пем ТЕ1]1ебфегеап ("Е1]е1", ЕтОрепВеаа); 

Тагае*->СоруЕгом (5$очгсе, $оцгсе->512е); 


Че1еее Тагаеф; 
Че1ефе 5оогсе; 


Более полный пример с учетом возможных ошибок при открытии файлов 
и копировании приведен в разд. 6.9. 

При копировании дата копии станет текущей. Если вы хотите при копиро- 
вании сохранить в копии дату исходного файла, это можно сделать функция- 
ми Е|еСсеае и ЕПЦеЗеОафе: | 


Е1]ебесрафе (Тагдее->Нап1е, Е11ебсефраке ($опгсе->Напа1е)); 


Здесь использовано описанное ранее свойство потока Нап Ме. 

Метод УгцеСотропепё позволяет записать в поток текущую информацию 
о компоненте 1т$$апее. Эта информация записывается в двоичном виде. При 
желании ее можно преобразовать в текстовый формат функцией Одес В1- 
пагуГоТех{. Метод Веа4Сотропеп& читает записанную ранее методом \!1- 
феСотропеп{ информацию, заносит ее в компонент шз$фапсее и создает на осно- 
ве полученной информации все дочерние компоненты, которыми владеет 
]п$фапсе. Метод возвращает указатель на компонент т$фапее. Аргумент 
1а5фапсе в вызове метода можно задать равным МОШЕ. В этом случае компо- 
нент создается на основе информации о типе, содержащейся в потоке. 

Примеры использования методов и свойств класса ТЕПе&геат вы найде- 
те в разд. 1.14, 6.9, 6.13. 


730 Глава 8. Справочные данные по функциям и структурам АР! \М/тдом/$ 


ТМетогу{геат — конструктор, методы и свойства потока 
Модуль С[1а3зез 


Синтаксис 


__Еаз®са11 ТМемогку$&геам (уо1а) : С1аззез: :ТСазфомМетогуз®геам(); 
_ ргорегк®у уо1а * Мемогку; 

__ргорекгбу _ 10864 Ро$1®1оп; 

__ргорекеу _ 11664 512е; 


\1Есиа1 1пе _ Еаз®са11 Веа@а(уо1а *ВаЕЁег, 1пЕ Соцп®); 

У01а __Еаз®са11 ВеааВчЕЕег (уо1та *ВаЕЕег, 1пе Сопп®); 

У1ксна1 10 _ Еаз®са11 Мг1се (сопз® уо1а *ВаЕЁег, 1пе Соцп®); 
\у01а _ Еаз®са11 Иг1сеВаЕЕег (сопз® уо1аА *ВиЕЁег, 1пе Соцп®); 


ТСотропеп®* _ _Ёазеса11 КеаЯаСотропеп® (ТСомропепе* Тпзфапсе); 
У01А __Еаз®са11 Мг1®еСопропеп® (ТСомропепе* Тпзбапсе); 


01а _ Еаз®са11 ГоааРгомЕ1]е (сопз® Апз15Ех1пд Е11еМапме); 
у01а __Еаз®са11 ЗауеТоЕ11е (сопзЕ бузкет: :Апз15&г1па Е11еМапе); 


У01Аа _ Еаз$&са11 ГоаЧ4Егом5 Е геам(Т5$&геам* 5&геам); 
у©1А _ Еаз®са11 5ауеТозЗЕгеан(Т5Егеам* 5&геам); 
__ 10664 __Еаз®са11 СоруЕгом (Т5Егеам* 5оцгсе, __ 110864 Соип®); 


епим ТбеекОг1а1п { зоВеяч1пп1па, зоСиггепе, зоЕпа }; 
У1геиа1 110664 _ ЕазЕса11 5еек(сопзе 10664 ОЕЕзеб, 
Тбееког1а1п Ог191п); 


Описание 

Создание потока класса ТМетогу{геат осуществляется вызовом его кон- 
структора, в который не передаются никакие параметры. Поток создается 
в области памяти, на которую указывает его свойство Метогу. Свойства 
Ро5 {101 и 512е дают доступ соответственно к текущей позиции потока и его 
размеру. Размер З1ле — свойство только для чтения, а текущую позицию 
Роз! 10оп можно изменять. Текущую позицию изменяет также метод Зеек. Па- 
раметр ОЁ#$еф этого метода указывает, на сколько должна быть сдвинута теку- 
щая позиция. Положительные значения соответствуют сдвигу к концу, а отри- 
цательные — к началу потока. Параметр Омеш указывает, от какой точки от- 
счета задается сдвиг параметром ОЁ5еф. Параметр Ог1е1ш может принимать 
следующие значения: 


_зоЕготВезтите Сдвиг относительно начала потока. При этом значение 
' ОЁЙзеф должно быть больше или равно 0. 


ОНИ либо 


 оРЕготСиггеп$ Сдвиг относительно текущей позиции Ро оп. При этом 
‘значение ОЁЁ5еф может быть как положительным, так 
‚и отрицательным. 


` зоЕготЕп@Я ‘Сдвиг относительно конца потока. При этом значение 


Метод ЭееК возвращает новое значение текущей позиции Роз 1оп. 

Из потока можно читать методом ВеаЯ и записывать в него методом 
\У/гЦе. В этих методах параметр ВийЁег указывает буфер, в который заносятся 
читаемые данные или из которого данные записываются в поток. Параметр 
Соипё определяет размер буфера. Методы возвращают число прочитанных или 
записанных байтов. При чтении возвращаемое значение может быть меньше 
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указанного параметром Соипф, если, например, в процессе чтения достигут ко- 
нец потока. Методы ВеаЯВиЁег и УгцеВиЁЙег отличаются от методов Веа4 
и \УгЦе тем, что если не удалось передать Соип& байтов, генерируется исклю- 
чение ЕВеа4Еггог или Е\/гЦеЕггог соответственно. 

Чтение или запись рассмотренными методами осуществляется, начиная 
с текущей позиции. Методы сдвигают текущую позицию потока на число пере- 
данных байтов. 

В поток можно записать методом Гоа9ЯЕгот{геат информацию из друго- 
го потока. Можно также сохранить информацию в другом потоке методом 
ЗауеТо (4 геат. Другой вариант обмена информацией с другим потоком — ис- 
пользование метода СоруЕгот. Параметр Зопгсе определяет поток, из которо- 
го копируются данные, а параметр Соип& указывает число копируемых бай- 
тов. Если Соцп& = 0, то копируется весь файл. Копирование призводится в тот 
поток, для которого вызывается метод СоруЕгот. 

Записать информацию в поток можно из файла методом Гоа9ЕгошЕ Пе. 
А метод ЗауеТоЕПе позволяет сохранить информацию в файле. Так что с уче- 
том этих методов поток класса ТМетогу${геат позволяет делать то же, что 
и поток класса ТЕПе$фгеат, но немного сложнее. Для потока ТЕЦе&геат 
достаточно указать имя файла при вызове конструктора: 


ТЕ1]ебфегеам *Т = пем ТЕ1]ебЕетгеап ("Е.аае", ЕпСгеаее); 


После этого содержимое потока Т будет тождественно содержимому файла 
и любое изменение этого содержимого буде немедленно отражаться в файле. 
В потоках ТМетогу{геат связь с файлом организуется несколько иначе: 


ТМепогу$©геам *Т = пем ТМепогубегеац(); 
Т->ГоааРгопЕ11е ("Е.Чаф"); 


После выполнения этих операторов в поток Т в памяти будет загружено 
содержимое файла. Но после этого связь потока с файлов прервется. Если по- 
сле какого-то преобразования информации потребуется занести ее обратно 
в файл, надо будет выполнить оператор: 


Т->бауеТоЕ1]е("Е.Чае"); 


Такая управляемая связь потока с файлом может быть полезна при преоб- 
разованиях содержимого, поскольку исключает постоянную фиксацию на дис- 
ке и тем самым повышает призводительность приложения. 

Метод \У/гцеСотропепф позволяет записать в поток текущую информацию 
о компоненте Тт$фапее. Эта информация записывается в двоичном виде. При 
желании ее можно преобразовать в текстовый формат функцией ОБес&Вта- 
гуТоТех{. Метод Веа4Сотропеп& читает записанную ранее методом У\Ут- 
$еСотропеп{ информацию, заносит ее в компонент шзфапсе и создает на осно- 
ве полученной информации все дочерние компоненты, которыми владеет 
Го$фапсе. Метод возвращает указатель на компонент Шш$%апее. Аргумент 
Тпзфапсе в вызове метода можно задать равным МОТ. В этом случае компо- 
нент создается на основе информации о типе, содержащейся в потоке. 

Примеры использования некоторых методов класса ТМетогуЗ&геат вы 
найдете в разд. 6.13. 
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ТМепиЦет {о — тип структуры, используемой для информации 
о разделах меню | 


См. МЕМОЛТЕМУЕО. 


ТОуеарре — структура, используется при асинхронном режиме 
чтения и записи 


См. ОУЕВГАРРЕЮ. 


ТРгосеззпЁогтаИоп — информация о выполнении нового процесса 
См. РКОСЕЗЗ_ ТМЕОВМАТТОМ. 


ТКезопгсе {геат — конструктор, методы и свойства потока 
Модуль С1[а35ез 


Синтаксис 


__ Еаз&са11 ТВезоигсе$геам(1пЕ Тизбапсе, сопзЕ Апз156г1па ВезМаме, 
сраг * ВезТуре); 
_ Еазеса11 ТВезочгсе5геам(1пе Тпзфапсе, 1пЕ ВезТр, спак * ВезТуре); 


__ргорегеу уо1а * Мепогу; 
_ ргорегеу _ 1п%64 Роз1®1оп; 
_ ргорек®у 11664 $512е; 


У1Е6ца1 1п& _ ЕазЕса11 Веаа(уо1А *ВоЕЁЕег, 11% Соцп®); 

У014 __ЁРаз®са11 ВеааВоЕЕег (уо1А *ВиЕЁег, 1пе СоппЕ); 

У1гепа1 1п& _ Еазеса11] Иг1(е (сопзЕ уо1а *ВиЕЕег, 11 Сопп®); 
Уу014 __Еаз®са1]1 Мг1кеВаЕЕет (сопзЕ уо1а *ВаЕЁЕег, 1п6е Сойп®); 
ТСопропепе* _ _Еазеса11 ВеаСотропеп® (ТСотропепе* Тпзфапсе); 
\01А __Еаз&са11] Иг1&еСотропеп® (ТСомропепе* Тпзфапсе); 

У01А __Еаз®са11 5ауеТоЕ11е (сопзе Зузеем: :Апз15Ег1лпа Е11еМапе); 
у01А _ Еаз®са11 бауеТобегеам(Т5Егеам* 56геам); 

__ 10664 __Еаз®са11 СоруЕгоп(Т5$&геам* 5оцгсе, __ 110664 СоипЕ); 
епим ТбеекОг1алптп { зоВеа1тпп1лпа, зоСаггепЕ, зоЕпа }; 


У1геца1 110664 _ Еаз®са]11 5еек(сопзе __ 11664 ОЕЁЕзек, 
ТЗеекОг1а1п Ог1а1п); 

Описание 

Потоки класса ТВезопгсе {геат используются для получения доступа 
к нестандартным типам ресурсов (см. разд. 4.1.4). Конструктор этого класса 
имеет две формы. Параметры ТШазбапсе — дескриптор приложения, содержа- 
щего ресурс, и ВезТуре — тип ресурса одинаковы в обеих формах. В качестве 
значения параметра ВКезТуре можно использовать предопределенное значение 
ВТ_ВСОАТА, если в объявлении ресурса тип указан как ВСОАТА, или стро- 
ку с именем типа, введенного пользователем. 

Параметр ВезМате, указывающий имя ресурса, различается в приведен- 
ных формах конструктора. Если в файле описания ресурса вы указали цифро- 
вой идентификатор, то проще использовать вторую форму. Впрочем, можно 
использовать и первую, предварив число символом #. Пусть, например, вы 
объявили ресурс строкой: 


100 ВКСРАТА муЕ11е 
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Тогда для его загрузки можно применить вторую форму конструктора: 
ТКезоиксеб геам *ВЕЁЕ = пем ТВКезоцгсе5 < геам(0, 100, ВТ ВСРАТА); 


или первую форму: 
ТКезоигсеё5геам *КЕЕ = ТВезоигсе5геам(0, #100, ВТ ВСРАТА); 


Поток создается в области памяти, на которую указывает его свойство 
Метогу. Свойства Ро51оп и 512е дают доступ соответственно к текущей пози- 
ции потока и его размеру. Размер 812е — свойство только для чтения, а теку- 
щую позицию Роз {1оп можно изменять. Текущую позицию изменяет также 
метод Зеек. Параметр ОЁё$еф этого метода указывает, на сколько должна быть 
сдвинута текущая позиция. Положительные значения соответствуют сдвигу 
к концу, а отрицательные — к началу потока. Параметр Отт указывает, от 
какой точки отсчета задается сдвиг параметром ОЁ5её. Параметр Оше мо- 
жет принимать следующие значения: 


 зоЕготВезшите Сдвиг относительно начала потока. При этом значение 
ОЁЁ5её должно быть больше или равно 0. 

= | и —_—_—_—_ — —— —_—_ 

‚ 5оЕгошСиггеп& Сдвиг относительно текущей позиции Ро \1оп. При 


| 
и и ии 7 ^ - > оиио =] 
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 5оЕгот Ева ‘Сдвиг относительно конца потока. При этом значение 


' ОЁ5еф должно быть меньше или равно 0. 


этом значение ОЁ#5еф может быть как положитель- 


Метод ЗееК возвращает новое значение текущей позиции Роз 10оп. 

Из потока можно читать методом ВеаЯ и записывать в него методом 
\У’гЦе. В этих методах параметр ВиЁег указывает буфер, в который заносятся 
читаемые данные или из которого данные записываются в поток. Параметр 
СоипЁ определяет размер буфера. Методы возвращают число прочитанных или 
записанных байтов. При чтении возвращаемое значение может быть меньше 
указанного параметром Соипф, если, например, в процессе чтения достигут ко- 
нец потока. Методы Веа4ВиЁег и УгцеВиЁег отличаются от методов Веа@4 
и У\Угце тем, что если не удалось передать Соцпф байтов, генерируется исклю- 
чение ЕВеаЧЕггог или Е\гЦеЕггог соответственно. 

Чтение или запись рассмотренными методами осуществляется, начиная 
с текущей позиции. Методы сдвигают текущую позицию потока на число пере- 
данных байтов. 

Информацию, содержащуюся в потоке, можно перенести в другой поток 
методом ЗауеТо{геат. Другой вариант обмена информацией с другим пото- 
ком — использование метода СоруЕгот. Параметр Зоигсе определяет поток, 
из которого копируются данные, а параметр Сопиф указывает число копируе- 
мых байтов. Если Соип& = 0, то копируется весь файл. Копирование призво- 
дится в тот поток, для которого вызывается метод СоруЕгот. Метод ЗауеТоЕ1- 
]е позволяет сохранить информацию в файле. 

Метод У\УгцеСотропеп{ позволяет записать в поток текущую информацию 
о компоненте Шшзфапсе. Эта информация записывается в двоичном виде. При 
желании ее можно преобразовать в текстовый формат функцией ОБесВта- 
гуТоТех&. Метод Веа4Сотропеп читает записанную ранее методом \Ут- 
$еСотропеп6 информацию, заносит ее в компонент Шшзфапсее и создает на осно- 
ве полученной информации все дочерние компоненты, которыми владеет 
Газфапсе. Метод возвращает указатель на компонент Ш$6апсе. Аргумент 
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п$фапсе в вызове метода можно задать равным МОГЕ. В этом случае компо- 
нент создается на основе информации о типе, содержащейся в потоке. 
Примеры использования класса ТВезоигсе {геат вы найдете в разд. 4.1.4. 


ТбесигцуАИгЮщез$ — задает дескриптор защиты 
См. ЗЕСОВТТУ_АТТЕВОТЕВ. 


Т5$аграршШЁо — определяет свойства главного окна процесса 


См. разд. «эЭТАВТОРГИМЕРО — определяет свойства главного окна создавае- 
мого процесса». 


Т5узетТипе — тип структуры, содержащей информацию о дате 
и времени 


См. ЗУЗТЕМТТМЕ. 


Т\ММ№орРагап1$ — тип сообщения \1190\5$ без параметров 
Тип сообщения У/1п4о\з без параметров. 
Заголовочный файл Меззазез.йрр 


Синтаксис 


сегисе ТИММоРагамз$ 

! 
чизтапеа М$а; 
йога Опизеаг!4]; 
з0с Вези1Е; 

| 


. 
] ' 


Описание 
Тип Т\ММоРагап1$ объявлен в С++ВоПаег как тип сообщения \/11490о\$ 


без параметров. Он используется в объявлениях ряда типов сообщений: 
У\/М_СГОЗЕ, \УМ_САМСЕЕГМОПЕ и многих других. 


Опвоок\/тдо\5НооКЕх — удаление ранее зарегистрированной ловушки 
См. функцию Зе \т4дом$НооКЕх. 


Опге1${егНо{Кеу — снятие с регистрации горячих клавиш 
См. функцию Вег1$$егНо{Кеу. 


У\Уа(цСоттЕуеп& — приоставливает выполнение приложения 
до наступления события порта 


См. функцию Зе СоттМабзК. 


У\Уа(ЕГогпри Ще — останавливает выполнение процесса 


Останавливает выполнение родительского процесса до момента, когда по- 
рожденный процесс инициирован и ждет ввода со стороны пользователя 


Заголовочный файл И’пизег.й 


М/аНРог$пто!еОШЩесЕ, ММаНРог5таеОШЫесцЕх — функции ожидания 735 


Синтаксис 


#Тпс1аае <и1пизегк. В > 
РИОВР МТМАРТ Ма1зЕЕГогТпроеТа]1е (1М№ НАМОЬЕ ВРгосез$, 
ТМ ОМОВОР амМ11115есопаз); 


Описание 

Функция СгезжеРгосе$$, создающая дочерний процесс, возвращается, не 
ожидая окончания инициализации порождаемого процесса. Если родитель- 
ский процесс должен ждать окончания инициализации, чтобы взаимодейство- 
вать с порожденным, то ожидание его инициализации можно организовать 
с помощью функции УаЦЕогшриИ@ае. Параметр пРгосез$ — дескриптор до- 
чернего процесса, тот самый дескриптор, который в родительском процессе 
хранится в поле ВРгосе$$ структуры 1рРгосез$Пп{огтайоп. Параметр аи МИ- 
зесоп45 — время ожидания в миллисекундах. 

Функция возвращается, если истекло время ожидания, или когда порож- 
денный процесс инициирован и ждет ввода со стороны пользователя. Возвра- 
щаемое функцией значение может быть следующим: 


И ННЕНННЬ -_- — ——- 


0 | Порожденный процесс инициирован и ждет ввода со сторо- 


} 


| УАТТ ИМЕОЧТ |Заданный интервал ожидания истек. 


_— - 
` ОХРЕРЕЕРЕЕ Произошла ошибка. Информацию о ней можно получить 


| _ | @ помощью функции @ае аз Егтог. _ 


Функцию У\УаЦЕогшри Ше следует применять, например, если родитель- 
ский процесс должен иметь доступ к дочерним окнам порожденного процесса. 
Создание этих окон завершается как раз к моменту возвращения функции 
У\акЕогшриНа!е. 


У\УацЕог51то1еОесё, УацЕогэто]еОБес Ех — функции ожидания 


Обеспечивают ожидание изменения состояние одного объекта синхрониза- 
ции 


Заголовочный файл И тфазе.й 


Синтаксис 


#Тос1аае <итпБазе.й> 
ОМИОКО УТМАРТ Ма1ЕГог51п91е0Б]есе (ТМ НАМОГЕ РНапа1е, 
ТМ ОМИОВО амМ11115есопа$); 


РИОВО Ма1®Гог51п91е0р)есеЕх (ТМ НАМОЪЕ ПНапа1е, 
ТМ ОМОВО амМ11115есопа$, 
ТМ ВООЬ РА1егкаЬ1е); 


Описание 

Функция Уа[Еог5те1еОЪесё — одна из функций ожидания (см. 
разд. 3.2), позволяющая организовать для синхронизации процессов и потоков 
ожидание события одного объекта синхронизации. 

Параметр ВНапМе — дескриптор объекта синхронизации. Параметр 
Ч\УМИШ5$есоп$ — время ожидания (тайм-аут) в миллисекундах. Если объект, 
на который указывает ИНапШе, в данный момент находится в несигнальном 
состоянии, функция ждет, пока он перейдет в сигнальное состояние, или пока 
не закончится время ожидания. Если объект в момент вызова функции нахо- 
дится в сигнальном состоянии, функция возвращается немедленно. Если воз- 
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вращенное функцией значение равно МАТ 'ПМЕОСТТ, это свидетельствует 
о том, что время ожидания истекло, а объект так и не перешел в сигнальное 
состояние. Значение \АТТ_ОВ.ЕСТ_0 свидетельствует о том, что объект сра- 
зу был в сигнальном состоянии или перешел в это состояние во время ожида- 
ния. Возвращенное функцией УаЦЕог5те]1еОБуесё значение \АТТ_АВАМ- 
РОМЕРО возможно только для мьютексов и свидетельствует о том, что мьютекс 
освободился вследствие окончания выполнения владевшего им потока. Под- 
робнее это рассмотрено в теме мьютексы. Значение \УАТТ_ЕАП.ЕО свидетель- 
ствует об ошибке выполнения функции. 

Если параметр 9мМИП$есоп4$ задан равным 0, функция тестирует состоя- 
ние объекта и немедленно возвращается, независимо от состояния объекта. 
Если а/МИШ5есоп4$ = ПМЕТМТТЕ, функция возвращается только при переходе 
объекта в сигнальное состояние. Такое значение параметра 4мМИШ$есоп4$ 
надо задавать с большой осторожностью. При этом надо быть абсолютно уве- 
ренным, что рано или поздно объект перейдет в сигнальное состояние. В про- 
тивном случае приложение «зависнет». 

Перед возвращением функция УацЕогэте1еОЩеей изменяет состояние 
объекта, например, захватывает мьютекс, уменьшает число семафора на 1 ит.д. 


Функция УаЦЕогэше]еОЦес Ех используется, когда ожидание связано 
с функциями расширенного чтения или записи ВеадЕПеЕх и У\УтцеЕПеЕх, 
или с асинхронным вызовом процедур (азупсЬгопоцз ргоседиге са] — АРС), 
ставящихся в очередь функцией диепеО5егАРС. В функции Уа(Еог5то- 
1еОБзес Ех имеется дополнительный параметр 6 МещаШе. Если этот параметр 
равен фгие, то функция возвращается не только в случае сигнального состоя- 
ния синхронизирующих объектов или по истечении заданного времени ожида- 
ния, но и при завершении операции ввода/вывода функцией обратного вызо- 
ва, или при вызове функции АРС. Если параметр 6 Щега Ме равен #а15е, то 
функции ожидания не возвращаются, пока не наступит сигнальное состояние 
синхронизирующих объектов или пока не истечет заданное времени ожида- 
ния. До этого момента не выполняются также (т.е. задерживаются) функции 
обратного вызова и функция АРС. 

Функция \УайЕРогэштоеО Бес Ех может возвращать те же значения, что 
и функция Уа(ЦЕРогЭшто]еОЩес&, но дополнительно возможно возвращаемое 
значение \УАТТ ТО _СОМРЕЕТТОМ — возврат функции вследствие окончания 
процедуры чтения/записи. 

См. примеры применения функций в разд. 2.5.3, 3.3, 3.4, 3.5, 3.6, 3.7, 
3.10, 6.6.4. 


УацЕогэшто1еОес Ех — функция ожидания 
См. функцию Уа(ЦЕогэте1еОБес+. 


У\УМУштЕхес — выполняет указанное приложение 
Выполняет указанное приложение. 
Заголовочный файл И/’/пизег.Й 


Синтаксис 


ОТМТ ИМ1пЕхес ( 
ТРСЗТВ 1рСтаЬ1пе, // адрес командной строки 
ОТМТ аСма$Бом // режим открытия приложения 


); 


\ММтЕхес — выполняет указанное приложение 737 


Описание 

Функция УтшЕхес позволяет выполнить указанное приложение. Пара- 
метр 1рСт@ЯГте является указателем на строку с нулевым символом в конце, 
содержащую имя выполняемого файла и, если необходимо, параметры ко- 
мандной строки. 

Если имя указано без пути, то \У/ш4омз ищет выполняемый файл в сле- 
дующей последовательности: 


и Каталог, из которого загружено приложение. 

и Текущий каталог. 

" Системный каталог \У/1по\з, возвращаемый функцией де ЗузфетПОгес- 
фогу. 

и Каталог У/1пЧо\з, возвращаемый функцией Се \ том О1гесфогу. 

и Список каталогов из переменной окружения РАТН. 
Параметр иСт@$Во\ определяет форму представления окна запускаемого 

приложения \!114о\з. Для приложений не \Мш4о\мз, для файлов РГЁ ит.д. со- 


стояние окна определяет само приложение. 
Параметр аСт@ЗВо\ может принимать одно из следующих значений: 


НИИ 
$\_НШЕ Окно делается невидимым, и фокус передается 
. В „другому. окну. — ОИ 
5\ МАХТМГЯЕ '`Развертывает (максимизирует) указанное окно. 
$ \’_МИМИМТЯИЕ ' Свертывает (минимизирует) указанное окно и ак- 


‘тивизирует следующеев (-последовательности 
окно верхнего уровня в списке системы. 


5\’_КВЕЗТОКЕ ‚ Активизирует и отображает окно. Если это окно 

‚ свернуто или развернуто, то оно восстанавливает- 
‚ся до своих первоначальных размеров и отобра- 

‹ жается в первоначальной позиции (почти то же 

| самое, что 5\7 _5НО\МОВМАГ.). 


О ИВ —- — Да я 


5\’ НОМ Активизирует и отображает окно в его текущей 
позиции и с текущими размерами. 


ООО ——_- о 


5\/_ЗНОМ/ОЕЕАОГТ '`Устанавливает состояние. в соответствии с флагом 
`5$\М_ в структуре ЭТАВТОРТЕО, передаваемой 

`в функцию Сгеа&еРгосез$ программой, запускаю- 
щей приложение. Приложение должно вызывать 
 ЗВом \У/1140о\м' с этим флагом, чтобы задать нача- 

` льное состояние своего главного окна. 


5\/_ 5НОМ/МАХТМГИЕР  Активизирует и отображает окно в развернутом 
‚виде (максимизированном). 


5\’_5НО\М/МИМТМТАЕО `Активизирует и отображает окно в свернутом 
виде (в виде пиктограммы). | 


М7 _ СНО\УМТАМОАСТТУЕ Отображает окно в свернутом виде (в виде пиктог- 
‚раммы). Активным остается то окно, которое 
было активным до этого. 


‘Отображает окно в его текущей позиции и с теку- 
‚щими размерами. Активным остается то окно, ко- 
‚ торое было активным до этого. 
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ат а ИИ | 
5\’_5НО\/МОАСТТУАТЕ |Отображает окно в его последней позиции и с по- 


следними размерами. Активным остается то окно, 
которое было активным до этого. 


Активизирует и отображает окно. Если это окно 
свернуто или развернуто, то’ оно восстанавливает- 
ся до своих первоначальных размеров и отобра- 
жается в первоначальной позиции (почти то же 
самое, что Э\_КЕЗТОВЕ). 


3\_ЗНО\МОВМАТ, 


При успешном выполнении запуска приложения функция УщЕхес воз- 
вращает значение, большее 31. Если возвращено меньшее значение, это свиде- 
тельствует об ошибке. 

Достоинством функции УшЕхес является ее совместимость с ранними 
версиями \!14о\з. Собственно для этого она и сохраняется в \!11 32, хотя для 
\У/1132 рекомендуется пользоваться функцией СгезжфеРгосез$. 

При работе с \Ут32 функция УшЕхес завершает работу, если вызванное 
приложение вызывает функцию (бе Ме5з5асе или заканчивается выделенный 
лимит времени. Таким образом, ожидание можно прервать, предусмотрев 
в процессе, запущенном с помощью УтЕхес, в нужный момент вызов функ- 
ции Се Меззаоге. 


\У/тНер — управляет справочной системой 
Посылает указанную команду программе У таомз Нер 
Заголовочный файл ИУтизег.й 


Синтаксис 


ВООГ И1пНе]1р (ТМ НИМО ВИпаЯМа1п, ТМ ЬБРСЗТВ 1рз2Не1р, 
ТМ ОТМТ оСотмапа, ТМ ОТОМС_РТВ амрафба); 


Описание 

Функция УтшНер запускает программу М1!сгозоЁ \У/шдомз Нер 
(ИУтлер.ехе), передает ей имя файла справки и посылает указанную команду. 

Параметр ВУ/пЯМаш задает дескриптор окна, вызвавшего справку. Этот 
дескриптор используется для запоминания того, какое приложение вызвало 
У/тадо\з Не]р. | 

Параметр 1р57Не№р указывает строку, содержащую имя справочного фай- 
ла. Если файл расположен не в текущем каталоге, то в имент файла должен 
быть указан путь к нему. В случае, если используется файл справки, связан- 
ный с вашим проектом, то в качестве значения параметра 1р$2Не]р может ис- 
пользоваться значение свойства Арр|Исайоп->НерЕПе, переведенное в тип 
(саг *), т.е. (АррИсайоп->НерЕПе).с_5%г(). 

После имени файла может указываться символ «>» и имя вторичного 
окна, в котором следует отобразить тему справки. Это одно из имен окон, за- 
данных в разделе [М//ИМОО\М/$] файла проекта справки. Например, (АррПеа- 
ИЙоп->НерЕПе + ">\1”).с_5%г0. 

Параметр иСотштап@ указывает посылаемую команду. Вид команды опре- 
деляет смысл и последнего параметра функции — 4мОаца. Ниже приводится 
список наиболее часто используемых команд. 
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‘Значение Рафа 


Команда 1 Описание 
- —_- - 


НЕЕР_СОМТЕХТ ‘Отображает тему, указанную номе- Целое без знака, 
‘ром, включенным в раздел [МАР] ‘соответствующее 
файла проекта справки. номеру темы 


и 
| 


| 
У 


НЕГР _СОМТЕХТРО- ‚Отображает во всплывающем окне |Целое без знака, 
`РОР ‘тему, указанную номером, вклю- соответствующее 

‘ченным в раздел [МАР] файла про- номеру темы 
‚екта справки. 


| НЕГР _ЕПХОЕКВ ‘Отображает страницу Содержание Игнорируется, дол- 
| ` или Предметный указатель (какую жно равняться 0 


' именно из них опеределяется тем, 
какая из них вызывалась последей 
‘в прошлом сеансе работы со справ- 
| ‘ками). | 


Г 
| НЕСР_РЕОВСЕЕЦПЕ —|Проверяет, отображается ли в дан- 
| ‘ный момент заданный файл справ- 
ки. Если открыт другой файл, то 
вместо него открывается указан- 
‘ный файл. 


| Игнорируется, дол- 
жно равняться 0 


| 
Н— -- 


'НЕГР_КЕУ Отображает тему, указанную клю- | Адрес строки, со- 
‘чевыми словами, заданными в про- | держащей ключе- 
‚екте сносками К. Если есть неско- \вое слово 

лько тем, соответствующих этим = 
ключевым словам, отображается 

| ‚окно Найденные разделы. Если за- = 
‘данного ключа нет, отображается 


‚ страница Предметный указатель. — 
|. --— --—— = — ЫЭ————— и 


НЕГР_  РАЕТТАТКЕУ ‚Отображает тему, указанную клю- | Адрес строки, со- 
чевыми словами, заданными в про- | держащей ключе- 
‚екте сносками К. Если есть неско- |вое слово 
‘лько тем, соответствующих этим | 
‚ключевым словам, отображается | 
‚страница. Предметный указатель. ии 
В 


НЕГР от. ‘Информирует о завершении работы | Игнорируется, дол- 
'со справочным файлом. Если ника- жно равняться 0 
‚кие другие приложения не исполь-_ 
| ‚ зуют эту справку, окно справки за- | 
_| крывается. 


Есть еще ряд команд, доступных при вызове \УтНеТр. Но они или устарев- 
ие, или настолько экзотические, что вряд ли стоит на них останавливаться. 

Функция У\УтНе возвращает 0, если при ее выполнении не произошла 
ошибка. 

Примеры рассмотренных команд и их обсуждение вы найдете в разд. Т.4. 
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У\УгцеЕПе — производит запись в файл, открытый функцией СгежеЕПе 
См. функцию ВКеа4Е |1е. 


\УгцеЕПеЕх — производит асинхронную запись файла 
См. функцию ВеадЕ!еЕх. 


ХРОЕМ- структура трансформации координат 
См. функцию Зе Уог19Тгап$Рогт. 


+-+Випаег и сети 


„. 


Организация взаимодействия 
приложений в сети 


9.1 Немного о сетевых протоколах 
и идентификаторах ресурсов. 


9.1.1 Сетевые протоколы 


В этой и последующих главах неоднократно будет идти речь о различных 
сетевых протоколах. Так что для начала полезно хотя бы коротко рассмотреть 
их назначение. Рассматривать будем только те протоколы, которые обычно ис- 
пользуются в Интернете или в локальных сетях, основанных на протоколах 
Интернета. Такие локальные сети называются сетями Интранет. 

Начнем с протокола [Р (межсетевой протокол — ифегпеф ргофосо]). Этот 
протокол обеспечивает отправку пакетов данных в сеть по указанному адресу, 
и не ожидает подтверждения их доставки адресату. Так что никакой обратной 
связи, а значит, и никакой гарантии целостности данных не обеспечивается. 
Это забота протоколов более высокого уровня. 

Каждый пакет [Р несет в себе адреса отправителя и получателя, некото- 
рую служебную информацию и контрольную сумму пакета. Эту контрольную 
сумму может проверить только получатель. Если записанная сумма не совпа- 
дет с контрольной суммой пришедшего пакета, то такой пакет просто будет от- 
брошен. При этом отправитель даже не узнает, что данные передались с ошиб- 
кой, и не сможет повторно послать их. 

[Р-адреса состоят из четырех байтов, которые при записи принято разде- 
лять точками. В адресе указывается его тип, номер сети и номер узла в ней. 
Например, 1Р-адрес вашего компьютера 127.0.0.1. Этот адрес можно использо- 
вать для отладки программ без выхода в Интернет. 

Цифровые [Р-адреса помнить достаточно сложно. Поэтому для облегчения 
работы были предложены символьные адреса ОМЗ (ОФоташ Маше Бузбет). 
Практически служба ОМБ является просто огромной базой данных, в которой 
хранятся символьные адреса и соответствующие им Г?-адреса. Так что когда 
вы пишете символьный адрес сервера, происходит обращение к этой базе дан- 
ных, из нее извлекается требуемый [Р-адрес, и уже по этому адресу передается 
пакет данных. Имеется возможность программно определить ГР- адрес по м 
(см. разд. 10.2). 

Поскольку протокол Г? сам по себе не обеспечивает надежной передачи 
данных, он используется совместно с другими протоколами более высокого 
уровня. Укажу два таких протокола: ОШР и ТСР. Пакеты данных, сформиро- 
ванные этими протоколами, не могут в чистом виде передаваться по сети. Они 
обрабатываются после их формирования протоколом ПР, который добавляет 
к ним сетевой адрес получателя и другую указанную выше информацию. В та- 
ком виде пакет передается по сети. Получает его на компьютере адресата тоже 
ТР, и после некоторой обработки передает в ОПР или ТСР. 
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Протокол ОШР обеспечивает быструю, но ненадежную передачу данных. 
Он не организует диалог с получателем и не гарантирует, что отправленные 
данные будут доставлены. Так что этот протокол можно использовать только 
для передачи таких данных, частичная потеря которых не особенно сущест- 
венна. Например, это могут быть звуковые файлы, в которых потеря каких-то 
небольших фрагментов может пройти практически незамеченной. 

Протокол ТСР (протокол управления передачей — %$гапз11$$10оп сопёго] 
рго$осо!) существенно более сложный, но соответственно и не такой быстрый. 
При отправке данных ожидается в течение определенного времени ответ полу- 
чателя. Если ответа нет или пришел ответ о получении испорченных данных, 
то делается повторная попытка передать тот же пакет. Большие пакеты разби- 
ваются на отдельные фрагменты, и имеется механизм, с помощью которого 
принимающая сторона восстанавливает первоначальную последовательность 
фрагментов, даже если из-за задержек в сети порядок их поступления перепу- 
тан. При организации диалога отправляющего и принимающего компьютеров 
(клиента и сервера) используются случайные числа, с помощью которых ком- 
пьютеры обеспечивают защищенность связи. 

Благодаря отмеченным особенностям для надежной передачи данных 
чаще всего используется сочетание протоколов ТСР и ГР. Они настолько срос- 
лись друг с другом, что обычно воспринимаются как единый протокол ТСР/ТР. 

На уровне прикладных программ имеется множество частных сетевых 
протоколов и сервисов: ЕТР, ЭМТР, РОР и ряд других, которые мы рассмот- 
рим в последующих разделах одновременно с компонентами, предназначенны- 
ми для работы с ними. 


9.1.2 Идентификаторы ресурсов 


При общении в сетях, и особенно в Интернете, постоянно возникает задача 
идентификации требуемого ресурса. Например, вам надо обратиться к како- 
_ му-то файлу, расположенному в некотором каталоге на определенном сервере. 
Для идентификации используется универсальный идентификатор ресурсов 
ОВЬ — Ощуегза!| Везоигсе еп ег (ВЕС 2396, Ацигиз$ 1998). Это строка сим- 
волов, содержащая все необходимые данные. 

ОН объединяет форматы: 


и ОВГ (ОпМогт Везопгсе Г.осафогз) — явно описывает местонахождение ре- 
сурса 

и ОВМ (ОпМогт Везоигсе Матез) — идентифирует ресурс, независимо от его 
местонахождения 


и ОБС (Оп огт Кезопигсе СБагасфег1$1с$) — задает метаинформацию о ресурсе 


Наиболее часто используется формат ОВГ. Так что этот формат следует 
рассмотреть подробнее. ОВГ, формируется следующим образом: 


<имя схемы ОВГШ>:<информация схемы> 
Одна из схем, знакомая, наверное, каждому - это схема Бр. Информация 


в этой схеме выглядит так: 


Веер: // [<изег> [ :<раззмога] >@ ] <Позф> [ :<рог®>] 
[/ [<их1-рафв>] [?<зеагспра&в>]] [#БооКмакКк] 


Элементы схемы, указанные в квадратных скобках, являются необяза- 
тельными. Элементы означают следующее: 
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ыы — ——— 
Элемент Описание 


и5ег Идентификатор (10511) пользователя. Может содержать латинские 
буквы, цифры и некоторые вспомогательные символы. Буквы 
приводятся к нижнему регистру. Необязательный элемент. 


раззмог4 (Пароль. Может присутствовать только если задан элемент изег. 


В05$$ ‚ Адрес сервера (хост). Единственный обязательный элемент схемы. 


рог Порт (см. подробнее в разд. 9.2). По умолчанию 80. Необязатель- 
ный элемент. 


иг] -раё В Путь к ресурсу на сервере. Необязательный элемент. 
зеагспра | Передаваемый в ресурс параметр. Необязательный элемент. 


БооктагкК |Закладка — ссылка на фрагмент документа. Необязательный эле- 
мент. | 


В Интернете и в локальных сетях для организации обмена файлами широ- 
ко используется протокол ЕТР (см. разд. 10.4). Схема ОВ] по этому протоколу 
задается следующим образом: 


Екр:// [<изехг> [ : <раззмога] >@ ] <Возф> [ :<рог®>] [/<иг1-раеН>] 


Все элементы этого (ВТ имеют тот же смысл, что и в схеме Бр. 


При работе с электронной почтой используется схема таШфо: 


па11%6о: [<адрес>{,<адрес>}] 
[?<имя поля заголовка>=<значение>{&<имя поля заголовка>=<значение>}] 


Имена полей заголовка оговорены в соответствующем стандарте. Напри- 
мер, Зи 1есё — тема, Бо4у — текст сообщения и др. 

Имеется еще много других схем, некоторые из которых далее будут рас- 
смотрены в гл. 10. 

Рассмотренные варианты представляют собой полные ОЕ. Возможно так- 
же указание относительных ОВЛ. В этом случае можно пропускать такие эле- 
менты, как имя схемы, В0$%, пропускать первый слеш в указании пути. В этом 
случае недостающие элементы берутся из ранее заданного полного О, а путь 
без предшествующего слеша означает путь, относительный к ранее указанному. 

При задании ОВ все не алфавитно-цифровые символы должны быть, со- 
гласно стандарту, преобразованы. Преобразования сводятся к следующему: 


" Любой не алфавитно-цифровой символ (в том числе символы кириллицы) 
преобразовывается в знак процента, за которым следует шестнадцатерич- 
ный код этого символа из таблицы АЗСП. 


= Пробелы заменяются символами «+». 
= Все поля (переменные) отделяются знаками &. 
" Имена полей и данных разделяются символом «=». 


Некоторые программы, воспринимающие ОВГ,, проводят подобные преоб- 
разования самостоятельно, неявно для пользователя. Но для надежности 
обычно лучше проводить подоные преобразования программно, до использова- 
ния соответствующей программы (см. разд. 10.6 и 10.7). 
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9.2 Некоторые общие свойства, методы 
и события компонентов, характеризующие 
соединение 


В данной главе мы рассмотрим организацию обмена информацией между 
приложениями, работающими на разных компьютерах, объединенных сетью, 
основанной на рассмотренных в разд. 9.1 протоколах ТСР/ТР. Прикладные про- 
граммы могут применять любой протокол, который основывается на ТСР/ГР 
и используется для связи в Интернете. Протокол ТСР/ТР используется также 
в Интранете. Под этим термином понимаются корпоративные сети, ресурсы ко- 
торых подобны ресурсам Интернета, но доступны только тем пользователям, 
которым такие права предоставлены — сотрудникам этих организаций. 

Протокол ТСР/ТР позволяет организовать обмен между двумя приложе- 
ниями, работающими на разных компьютерах под управлением разных опера- 
ционных систем. При этом можно пересылать друг другу как текстовые сооб- 
щения (см. разд. 9.3), так и файлы (см. разд. 9.4). Подобный обмен информа- 
цией может быть очень ценным для организации совместной работы сотрудни- 
ков. Причем они могут работать в данный момент не только в разных помеще- 
ниях, но и в разных городах. Лишь бы был доступ к сети — Интернет или Ин- 
транет. Но можно сделать большее (см. разд. 9.5): организовать коллективный 
доступ к единому серверу. Тогда группа сотрудников может в реальном време- 
ни общаться друг с другом, обсуждать общие проблемы (или последний фут- 
больный матч, если начальство не уследит), проводить совещания. 

Многие из компонентов, рассмотренных в последующих разделах и реали- 
зующих описанные выше возможности, требуют указания сервера — компью- 
тера, на котором работает то приложение, с которым необходимо связаться, 
и порта. Название сервера задается в свойстве Но$$. В этом свойстве может 
указываться имя сервера (его ОВГ,) или [Р-адрес серверного компьютера. 

Если вы отлаживаете приложение на локальном сервере, не выходя в Ин- 
тернет, то ГР-адрес вашего компьютера 127.0.0.1. В этом случае значение свой- 
ства Но$& можно задавать равным "127.0.0.1” или "]оса!0о$%". Если у вас уста- 
новлен локальный сервер, то можно задавать также его имя: "тусотшрифег”. 
Во всех этих случаях ваш компьютер одновременно является и сервером, 
и клиентом. 

Имя компьютера вы можете уточнить (если окажется, что оно не равно 
"тусотрифег”), воспользовавшись папкой Панель Управления и имеющимся 
в ней апплетом “Система”. В открывшемся окне на закладке Имя Компьютера 
вы можете увидеть имя вашего компьютера, а при желании и изменить его. 

При работе в Интранете каждый компьютер также может быть одновре- 
менно и сервером, и клиентом. Значение Но$ должно содержать имя или 
[Р-адрес соответствующего компьютера. 

При работе с Интернетом значение Но$& записывается как полный адрес: 
"Ир: //\м\\м.оигзегуег.сот". Соответственно в этом случае сервером может 
быть только компьютер, имеющий ОВГ.. 

Теперь остановимся на свойстве Рогё — порт. Применительно к нашим за- 
дачам речь будет идти не об аппаратных портах компьютера, а о программных 
портах УИ ш4о\з. К этим портам могут подключаться программы, чтобы пере- 
давать или принимать информацию. Порт характеризуется своим номером. 
Многие номера закреплены за определенными протоколами или службами Ин- 
тернета. Так что при использовании этих протоколов и служб свойство Рог за- 
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дается автоматически. В других случаях вы можете задавать номер порта 
сами. Только надо следить за тем, чтобы случайно не задействовать какой-то 
из уже занятых портов. 

Вы можете узнать, какие именно порты заняты, посмотрев файл Зегусез 
без расширения, расположенный в каталоге \!114о\з при работе с У/1т94о\жз 9.х 
или в каталоге бузет32\апоетгз\е при работе с \Мт9домз МТ/2000/ХР. Файл 
описывает ‘сетевые службы и содержит строки в формате: <имя службы> <но- 
мер порта> /<протокол> псевдонимы # <комментарий>. Например: 


ппёр 119/Еср изепее # Меемогк Мемз ТгапзЕег Рговосо1 


Эта строка определяет службу “ппёр”, использующую порт 119, протокол ТСР, 
и имеющую псевдоним “изепеф”. При необходимости вы можете внести в этот 
файл новую строку, определяющую новую, введенную вами службу и соответ- 
ствующий ей порт. Только следите за тем, чтобы не задействовать уже заня- 
тый порт. С развитием технологий, связанных с Интернетом, в Уш9о\з все 
большее число портов оказывается занятым. 

После изменения файла беплсез компьютер нужно перегрузить, чтобы 
система восприняла новые порты. 


9.3 Компоненты страницы Ра${Ме* 


9.3.1 Общее описание 


В С++ВаН@ег 6 и более ранних версиях в библиотеке имеется страница 
Га$Ме!, которая содержит множество компонентов, обеспечивающих работу 
в сети. Правда, уже в С+-+Ви!аег 6 стали бурно развиваться страницы библио- 
теки семейства Пфегпеф П1гесф (ш94у), которые лучше приспособлены к меж- 
платформенным взаимодействиям. А в С++ВиПаег 2006 страница Га Ме! вооб- 
ще исчезла. Несмотря на это, поскольку многие пользователи работают 
с С+-+ВиПаег 6 и даже с более ранними версиями, в данном разделе расмотрена 
организация взаимодействия сетевых приложений с помощью компонентов 
страницы Га$!Ме!. А компоненты штау будут рассмотрены в разд. 9.5. 

Для установления соединения многие компоненты страницы Газ\е! ис- 
пользуют метод Соппес&. Проверить, соединен ли компонент, можно по значе- 
нию булева свойства Соппесе4: {гие — соединен с удаленным сервером, 
Га]5е — не соединен. 

При установлении соединения двух компьютеров задается свойство Типе- 
Оцф, определяющее в миллисекундах время, в течение которого ожидается от- 
вет. Если в течение указанного времени ответ не получен, то генерируется ис- 
ключение, и текущая операция прерывается. Если ТипеОо задать равным 
нулю, время ожидания ответа не ограничено. Это иногда может привести 
К «зависанию» приложения. С другой стороны, если сеть медленная и очень 
загружена, то при задании недостаточного значения ТипеОцф ответ может не 
успеть дойти до клиента, и обмен информацией не состоится. 

В процессе соединения генерируется ряд событий. Если соединение осуще- 
ствляется с помощью Г?-адреса, то наступает событие ОпНо$&Везо]уеа. Собы- 
тие ОпСоппес& наступает в момент установления соединения. Обработчик это- 
го события можно использовать для информации пользователя об успешном 
соединении. Событие ОпР1$соппес+{ наступает при разрыве соединения. Обра- 
ботчик этого события можно использовать для извещения пользователей об 
окончании соединения. 
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Процесс соединения всегда сопряжен с возможностью неудачи. В этом слу- 
чае генерируются исключения. Их обработка по умолчанию сводится к отобра- 
жению окон с сообщениями на английском языке, которые вряд ли порадуют 
пользователя. Пример такого окна в случае, если не был найден указанный 
в приложении хост, показан на рис. 9.1 а. 


Рис. 9.1. Стандартное сообщение об ошибке соединения (а) и русифицированные сообще- 
ния (6) и (в) 


Чтобы сделать интерфейс более дружественным, желательно русифициро- 
вать эти окна. Для перехвата исключения при неудачном соединении запрос 
на соединение можно оформить следующим образом: 

ку 

{ 


...//процесс соединения 


} 
саёсрв (...) 


{ 


ЗПомМеззасе ("Ошибка соединения") 


} 


Это обеспечит в случае неудачи замену окна рис. 9.1 а на окно рис. 9.1 6. 
В ряде случаев (но не всегда) подобного же эффекта можно добиться, включая 
оператор с сообщением об ошибке (в приведенном примере — вызов ЭВом- 
Меззаге) в обработчик события ОпСоппесИопЕа!е4. 

Чтобы заменить окно рис. 9.1 а каким-то более русским, можно также вос- 
пользоваться событием ОпшуаП9Ноз&. Оно наступает, если в свойстве Но5%& 
был задан ошибочный адрес сервера. В обработчик этого события передается 
по ссылке булев параметр Нап ед. Он определяет, надо ли пробовать после 
окончания работы обработчика повторно установить соединение. По умолча- 
нию значение Нап Ше4 равно #а15е — не надо. Так что обработчик этого собы- 
тия может состоять, например, из оператора: 


5ромМе$засе ("Неверный адрес"); 


Тогда пользователь вместо окна, показанного на рис. 9.1 а, увидит более по- 
нятное окно, показанное на рис. 9.1 в. Но можно ввести в обработчик диалог, 
позволяющий пользователю изменить неверный адрес. Подобный пример вы 
увидите в разд. 9.3.2. 

Из свойств, присущих многим рассмотренным далее компонентам, можно 
отметить также свойство Афоцф. Это свойство только времени проектирования 
и только для чтения. Оно дает информацию о разработчике соответствующего 
компонента. | 

Свойство ВерогГеуе] определяет степень детализации процесса передачи со- 
общения. По умолчанию оно имеет нулевое значение и никак не влияет на про- 
цесс соединения. Но если его значение равно 1, 2, 4, 8 или 16, то на некоторых 
промежуточных операциях установления соединения и передачи сообщений воз- 
никают события Опа щ$. Заголовок обработчика такого события имеет вид: 
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\01А _ ЁЕазЕса11 имя (ТСотропепЕ *5еп4ег, Апз156г1па 56афи5) 


Строка 5$афиз содержит информацию о текущем этапе соединения. Чем 
выше значение ВерогТ.еуе|, тем больше событий Оп$$фафи$ происходит. Обра- 
ботчики этих событий можно использовать для каких-то сообщений пользова- 
телю, для вмешательства в процесс соединения и передачи сообщения. Но 
чаще всего эти события имеет смысл использовать в процессе отладки прило- 
жения. Подробнее примеры последовательности событий Оп$файа$ при высо- 
ком уровне Верогё Геуе! будут приведены в разд. 9.3.2. 


9.3.2 Обмен текстовой информацией между двумя 
компьютерами 


Обмен текстовыми сообщениями между двумя приложениями, работаю- 
щими на разных компьютерах, подключенных к сети, можно организовать 
с помощью компонентов МММУСЗегу и МММ5$, расположенных на странице 
ГазНМе! библиотеки. Эти компоненты могут включаться в любое приложение 
С+-Ви!Паег. Сообщения передаются компонентом МММ$е. Так что этот компо- 
нент располагается на форме приложения-клиента. Он имеет свойства Но$% 
и Рог, определяющие адрес и порт сервера, которому отправляется сообще- 
ние. Об этих свойствах было подробно рассказано в разд. 9.2. Как правило, 
порт, через который осуществляется обмен сообщениями, имеет номер 6711. 
Это значение присвоено свойству Рог по умолчанию и может оставляться без 
изменения, если только вы не надумали общаться через другой порт. О свойст- 
°вах ТипеОцф, ВерогИ.еуе! и АБоцё также было сказано в разд. 9.3.1. Свойство 
Егот Маше определяет произвольное имя клиента, отправляющего сообщение. 
Это имя в дальнейшем может воспринять сервер, и получатель поймет, кто 
прислал ему сообщение. 

Основной метод компонента — Ро${Ё%, обеспечивающий отправку сообще- 
ния. Этот метод объявлен следующим образом: 


Апз15Ег1па __ Еазса11 РозЕе1[{ (соп5Е Ап515Ег1па $М№М 4); 


Параметр $М$ содержит текст передаваемого сообщения. Метод возвра- 
щает строку “ОК”, если адресат найден, и сообщение благополучно передано. 
Так что по этому значению можно убедиться в состоявшейся передаче. Впро- 
чем, если передачи не произошло, то выполнение метода Ро заканчивается 
генерацией исключения. Так что вызов Ро5 1 целесообразно оформлять, на- 
пример, следующим образом: 

Егу 


{ 
МММ591->Ро5Е ТЕ (<текст сообщения>); 


} 
саесп (...) 


{ 


ЗВомМеззасе ("Ошибка передачи"); 


} 


Исключение генерируется при любой неудачной передаче сообщения. 
Если неудача связана с ошибочным [Р-адресом (значение свойства Но$& начи- 
нается с цифры и сервер с данным адресом не найден), то перед генерацией ис- 
ключения наступает событие ОпСоппесйопРа!ПЯ. А если был задан ОНТ. (зна- 
чение свойства Но$$ начинается с буквы и сервер с данным адресом не найден), 
то перед генерацией исключения наступает событие ОштуаП@ЯНо3$%. Оно было 
описано в разд. 9.2. В обработчик этого события можно вставить код, который 
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дает возможность клиенту изменить адрес и повторить попытку передачи со- 
общения. Для повторной попытки передачи сообщения надо в обработчике за- 
дать значение параметра Нап е9 равным %&гие. 


Рис. 9.2 Ошибочный адрес. 
Диалог, позволяющий изменить адрес. 


Можете указать новый адрес 


Посаноз 


Саисе! | 


Например, обработчик события ОптуаНаНо$& может иметь вид: 


Ап$156г1па оНозЕ; 
5Нозе = М№ММ$а91->Ноз$%; 
1Е (ТпрабОчцегу ("Ошибочный адрес", 
"Можете указать новый адрес", $ЗНоз®)) 


{ 
№МММ591->НозЕ = 5Но$е; 
Напа1еа = Егое; 


} 


Этот обработчик предъявляет пользователю диалоговое окно, показанное 
на рис. 9.2, задавая в него в качестве начального текста значение свойства 
Но$%. Если пользователь в этом окне изменил адрес, то его новое значение пе- 
редается в свойство Но$%, и заданием значения НапШе4 = фгие делается по- 
пытка нового соединения. | | 

В момент установления соединения с сервером наступает событие ОпСоп- 
песф. В момент разрыва соединения наступает событие ОпО1зеоппесф. 


Теперь остановимся на компоненте МММСЗегу, который обеспечивает 
получение сообщения на сервере. Собственно говоря, в данном контексте сер- 
вером является любое приложение, содержащее компонент МММЭСЪегу. 
Свойства этого компонента не отличаются от рассмотренных ранее для 
МММзР. Только, конечно, отсутствует свойство Егот Мате. А значение свой- 
ства Но$$ в этом компоненте ни на что не влияет. Порт, который обычно «слу- 
шает» компонент — 6711. 

Основное событие компонента — ОпМЗС. Оно происходит при успешном 
получении сообщения. Заголовок обработчика этого события имеет вид: 


У01А __Газ®са11 ТЕГоги1 ;: : МММ5 Сббегу1М$с (ТСошропепЕ *5епаекг, 
соп5зЕ Ап5$15Ег1тпа $Егом, сопзе Апг$156г1па $М5а) 


Параметр 5Егот содержит строку с именем того, от кого пришло сообще- 
ние, т.е. содержимое свойства ЕготМате компонента МММ$7. А параметр 
$М5# содержит строку сообщения, т.е. строку, переданную компонентом 
МММ55 с помощью метода Ро$& Ц. 

В момент соединения с клиентом наступает событие ОпСПепСопфа с. 
В момент разрыва соединения наступает событие ОпО1$соппес&. 

Суммируя сказанное, можно представить следующую последовательность 
событий клиента и сервера при выполнении клиентом метода Ро: 


| Происходит в приложении 


| 
‚ сервера 


Событие 
ОпСПеп Сотщафей 


ОпСоппес{ 
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Происходит в приложении 


сервера 


ОпМеззахезепа клиента 


Оп015соппесе — сервера 


Оп)15соппесв клиента 


Такая последовательность событий возникает, если соединение с сервером 
прошло успешно. Если же соединение не состоялось, то возможны два варианта: 


Свойство Но$& начинается с: |События в приложении-клиенте 


цифры — ошибочный ПР-адрес |ОпСоппеейопРаП!@а 
генерируется исключение 


буквы — ошибочный ОВТ, ОшшуаНаНо$ 


генерируется исключение 


Описанные последовательности событий возникают, если в компонентах 
МММ5й и МММ$С$егу свойства ВерогГеуе] заданы равными 0. Если же, на- 
пример, задать ВерогЕГеуе! > 0, то добавляется множество событий Оп$фафа$ 
с различными значениями параметра Э$аба$. Они позволяют в процессе отлад- 
ки приложения отследить отдельные стадии процессов соединения и передачи 
информации. При ВерогИ.еуе = 16 и успешном выполнении метода Роз ге- 
нерируются следующие событи события: 


Событие 


Опа и$ клиента 


Оп5фаф 1$ клиента 


Оп фа и$ сервера 


ОпЗ{а{ 15$ клиента 


ОпСНешСощас{ сервера — 


Опб{ащ$ клиента "Типег О” 
Оп${а{и$ клиента "\УУгце” 
Оп$фаа$ клиента "Зепашё ВиЁег” 


ОпЗ{фаи$ клиента "Т1тег Оп" 


Опа $ кл клиента “Типег ОТ” 


Оп{ашщ$ клиента "БЗепа1# ВиЁег” 


ОпЗфафи$ клиента “Тутег Оп” 


ОПМм5@ сервера _ 


Опа 1$ клиента “Типег ОР” 


| 
ОпСоппес{ клиента — 
| 
| 


ОпМеззасеЗеп@ клиента _ 


'Оп$$афа$ клиента Веаа(16) 


752 Глава 9. Организация взаимодействия приложений в сети 


Событие | 


"О1зсоппес$" 


Оп {фа щ$ клиента 


Оп{афи$ клиента 
Оп0О15соппес& сервера _ 
Оп)15соппес& клиента 

Кроме того, при запуске сервера наступает его событие Опфафи$ со значе- 
нием Эфафи$ = "Ш$епшях”. 

Приведенная последовательность возникает при удачном соединении. 
Если попытка соединения закончилась неудачей, то после первого события 
ОпЗфаёи$ со значением Э4афа$ = "Типег Оп” возникает событие Оп$фафа$ со 
значением Эфафи$ = "Т1тег ОЁ{", а затем или событие ОпСоппесНопГаП@, или 
событие ОшШптуаНЯНо$% (см. выше условия появления этих событий), после 
чего генерируется исключение. 

Как видим, при ВерогИ.еуе] > 0 событий более чем достаточно, чтобы от- 
следить процесс соединения и передачи сообщения. 

Теперь рассмотрим примеры построения приложений, обменивающихся 
текстовыми сообщениями (см. на прилагаемом к книге диске проект МММз= 
в каталоге Газ№е). В нашем примере приложение одновременно является 
и клиентом, и сервером. Таким образом, запустив подобные приложения на 
разных компьютерах сети, можно организовать обмен текстовой информацией 
между ними. 

Вид приложения во время выполнения показан на рис. 9.3. В окне Ваше имя 
пользователь указывает произвольное имя, которое увидит получатель сообще- 
ния. В окне Получатель пользователь указывает адрес компьютера, на котором 
расположено то приложение, которому направляется послание. Это может быть, 
в частности, аналогичное приложение, так как оно у нас будет являться и серве- 
ром, и клиентом. В окне Текст сообщения пользователь может написать послание. 
После того как все указанные окна заполнены, можно нажимать кнопку Пере- 
дать. Текст будет передан на компьютер получателя, и в окне Протокол диалога 
появится етрока, содержащая дату, время, имя отправителя и текст сообщения. 
Если пользователю пришло сообщение с другого компьютера, то в том же окне 
Протокол диалога появится аналогичная информация о принятом сообщении. 

Если в момент прихода сообщения окно приложения свернуто или пользова- 
тель работает с другим окном (вряд ли кто-то будет сидеть, прикованный взгля- 
дом к приложению, в ожидании нового сообщения), то раздается звук, и пикто- 
грамма приложения в полосе состояния начинает мигать. Таким образом пользо- 
ватель может узнать о новом сообщении, которое пришло на его адрес. 


“Кедиез$ С1озе Боске”. | 


Рис. 9.3 ‚7 Программа передачи сообщений и. 
Приложения во время 
выполнения 


Ваше имя: Получатель Протокоя диалога 


03.03.2004 17:24:23: Крокодил Гена 
[Чебурашка п 27.0.0.1 Привет всем !! Р 

03.03.2004 17:25:12: Чебурашка 

Привет, Гена !!! Как дела? 


Текст сообщения 


[Привет, Гена !!! Как дела? 
Передать | Очистить | Сохранить | 
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Кнопки Очистить и Сохранить позволяют соответственно очистить содержи- 
мое окна Протокол диалога или сохранить его текст в указанном файле. 

Начнем проектирование этого приложения. Перенесите на форму компо- 
ненты МММ551, МММ5С5Зегу1, три окна редактирования, три кнопки, три 
метки, компонент ВлевВЕЯЁ1 и диалог сохранения ЗауеП1а1о51. Все это можно 
расположить так, как показано на рис. 9.3. 

В окно Получатель (его имя в приведенном далее коде ЕНоз$) занесите адрес 
сервера. Для тестирования приложения с помощью локального сервера, без 
выхода в сеть, лучше задать [Р-адрес своего компьютера (121.0.0.1) или имя 
локального сервера (1юсаШо3$ или тусотрифег). Во время выполнения пользо- 
ватель сможете изменять этот адрес. В окно Ваше имя (Е\’ Во) можете занести 
свое имя. Окно Текст сообщения (ЕРо${) очистите, так как собщение имеет 
смысл задавать во время выполнения. 

Обработчик щелчка на кнопке Передать может иметь вид: 


У01А __Еаз®са11 ТЕГогм1: :ВРозЕС11сКк (ТОБ)есЕ *5епаег) 

{ 

МММз41->НозЕ = ЕНоз®->Техё; 

МММза1->ЕгопМаще = ЕМБо->Техе; 

МММ$91->РозЕТЕ (ЕРо$Е->Тех®); 

В1свЕа1т 6 2->Г1пе$->Ааа (Гогпа Рае еТ1ме ("", Мом ()} +": " + 
ЕМпо->ТехЕ); 

В1срЕа1 Е 2->Ь1пез->Ааа (ЕРозЕ->Техе); 

} 


Операторы этого обработчика заполняют свойства ЕготМаше и Но$& ком- 
понента МММ$51, а затем вызывают метод Роз Ё\ф, передавая в него сообщение 
из окна ЕРо$$. Затем в окно протокола В1еВЕЯИ2 заносится строка, содержа- 
щая дату, время, автора (имя пользователя) и текст сообщения. 

Обработчик события ОпшуаП9Но${ компонента МММ5$5 может иметь вид: 


\01А __Еаз®са11 ТЕГогм]1 : : МММ5а1Тпуа11АНоз® (Юоо1 &Напа1еа) 
{ 
Ап515Ег1па оНо$е; 
5НозЕ = М№ММ5491->Но$Е; 
1Е (ТпраеОпегу ("Ошибочный адрес", 
"Можете указать новый адрес", 5Но$т)) 
{ 
МММ$а1->Нозе = $Но$Е; 
Напа1еЯ = Егие; 
} 
} 


Этот обработчик в случае неудачного соединения предъявляет пользовате- 
лю диалоговое окно (см. рис. 9.2), в котором дается возможность исправить ад- 
рес сервера. Если вы не хотите давать пользователю такую возможность, мож- 
но ограничиться в обработчике всего одним оператором: 


5ВомМеззасве ("Неверный адрес"); 


Пользователь далее может исправить адрес непосредственно в окне приложения. 
Обработчик щелчка на кнопке Очистить может иметь следующий вид: 


у01А _ Еаз®са11 ТЕогм1 : :ВС1еагС11сКк (ТОБ]есе *5епаег) 


{ 
В1СспЕа12->С1]еах(); 


} 
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Теперь рассмотрим обработку щелчка на кнопке Сохранить: 


у01А __Еазеса11 ТРогт1 : :ВзауеС11ск (ТОБЗесь *бепаег) 


{ 
1ЁЕ (бауер1а1о91->Ехесаее ()) 
В1свЕа12->11пе5->5ауеТоЕ11е (бауер1а1о0о31->Е11еМаме); 


} 


В нем вызывается диалог сохранения с возможностью выбора только фай- 
лов в формате ВТЕ, открываемых программой М1сгозоЁ УТога. В этом диалоге 
пользователь выбирает имя файла и в случае успеха текст из Кае ВЕЧЕ? сохра- 
няется в файле. 

Мы сделали часть программы, которая касается посылки сообщений. Те- 
перь осталось дело за малым — научиться принимать сообщения. Это делается 
с помощью компонента МММ$С5$егу1. Здесь все предельно просто. У этого 
компонента, как уже говорилось выше, есть событие ОпМ$5, которое наступа- 
ет в случае прихода нового сообщения. Вставим в него операторы, позволяю- 
щие обработать и отобразить принятое сообщение: 

у0о1А __ЁЕазЕса11 ТГоги]1 : : МММ5$С5егу1М5С (ТСошропепе *5епаек, 

соп5еЕ Ап515ег1па $Еком, соп$® Апз156г1па $Мз9) 


{ 
В1срЕа12->ГЬ1пез$->Ааа (Гога РаЕеТ1ме ("", Мом ()) +": " + $Егом); 
В1срЕЧ162->1пез->Ааа ($Мза)} ; 

} 


Ваше приложение готово. Можете создать такое приложение, запустить на 
выполнение несколько экземпляров его и проверить в работе. Правда, если вы 
работаете с несколькими приложениями на одном компьютере, то возникнут 
определенные неприятности: сообщения от всех приложений будет принимать 
одно — то, которое было запущено первым. Но если вы запустите это приложе- 
ние на разных компьютерах и зададите в них соответствующие сетевые адреса, 
то сможете в полной мере обмениваться информацией. 

Теперь несколько усовершенствуем нашу полезную программу. Дело 
в том, что если пользователь работает с какими-то другими программами в мо- 
мент, когда ему приходит сообщение, он может не увидеть окно нашего прило- 
жения и не сможет отреагировать на полученное послание. А если в этот мо- 
мент приложение свернуто, то такое недоразумение случится безусловно. Для 
оповещения пользователя введем 2 сигнала: звуковой и мигание в полосе за- 
дач. Организация мигания пиктограммы в полосе задач подробно описано 
в разд. 5.2.5. Для реализации задуманного нам нужно добавить на форму ком- 
понент Т1тег1. Обработка события ОпТипег может выглядеть так: 

у0о1А __ЕазЕса11 ТГоги]: :Т1тег1Т1мег (ТОБ]есЕ *бепаекг) 


{ 
Е] азПИ1паом (Арр]11са®*1оп->Напа1е, кие); 


} 
Функция МММ5С5егу1 МЭС должна быть изменена следующим образом: 


у01а _ Еазеса11 ТЕогм1 :;: : МММ С5егу1М$С (ТСопропепЕ *5епаег, 
соп$зЕ Ап$156ег1па $Егош, сопзЕ Ап5156ег1па $М59) 

{ | 

1Е ( ! Арр11сае1оп->Асезуе ) 

{ 

Т1мег1->ЕпаЬ1еа = Егае; 

Веер(); 

} 

В1срЕа1{2->1пез->Ааа (Гогма<ПРафеТ1ме ("", Мом ()) +": " + $Егом); 
В1срЕа12->11пез->Ааа ($Мза); 
} 
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В этом коде жирным шрифтом выделены новые операторы. Теперь у нас 
при приходе сообщения раздается звук и мигает заголовок. Но ведь нам не 
нужно, чтобы заголовок мигал постоянно. Для этого нам надо добавить на 
форму еще один компонент АррИсаЯопЕуепт& $1 и в обработке его события 
ОпАсйуз{е записать оператор, прекращающий мигание: | 


\01А _ ЁЕаз®са11 ТГоги1 : :Арр11са 1опЕуепе$1Асе1уаее (ТОБ)]ес® *5бепаекг) 


{ 
Т1ме’1->Епаб1е = Еа1зе; 


} 


Завершая этот раздел, обсудим, что, собственно говоря, дают подобные 
приложения обмена текстовыми сообщениями. Наиболее очевидная область 
их использования — локальные сети. В подобных сетях известны адреса всех 
компьютеров, и легко организовать обмен информацией между ними. Слож- 
нее это делать в Интернете. Некоторые провайдеры дают своим клиентам по- 
стоянный [Р-адрес, и в этом случае обмен информацией также не вызывает 
проблем. Но если. такого постоянного адреса нет, то в действительности все 
равно при выходе в Интернет компьютеру присваивается временный адрес. 
Однако надо применять дополнительные средства (мы их не будем осуществ- 
лять), чтобы определить этот адрес и использовать его для взаимного общения 
компьютеров. Так что в подобных ситуациях, вероятно, использование рас- 
смотренных приложений не имеет смысла. 


9.3.3 Обмен файлами между двумя компьютерами 


Рассмотренные в разд. 9.3.2 компоненты МММ$е и МММ5ОЪЗегу позволя- 
ют обмениваться только текстовыми сообщениями. Передача с их помощью 
произвольных двоичных файлов в общем случае не получится из-за того, что 
некоторые байты будут восприняты как управляющие символы. 

Для обмена двоичными данными любого вида служат компоненты 
ММ5(гт и ММ56гтфЭегу. Они позволяют обмениваться потоками, а в поток 
может быть помещена любая информация, в частности, любые файлы, вклю- 
чая текстовые, аудио, видео, графические, и т.п. 

Компонент ММ помещается в клиентское приложение и по своим 
свойствам и событиям ничем не отличается от компонента МММ$е, рассмот- 
ренного ранее. И передачу этот компонент ведет в тот же порт 6711. И даже 
метод посылки сообщения Ро$Ё назван так же. Только вместо строки сообще- 
ния в этот метод передается поток — объект класса ТЭ&геат или одного из его 
потомков. Так что перед передачей сообщения надо создать объект потока и за- 
грузить в него передаваемую информацию. | 

Компонент ММ5егт5егу принимает на сервере переданный поток. Этот 
компонент аналогичен рассмотренному ранее компоненту МММ$ОЪЗегу по сво- 
им свойствам и событиям. Только заголовок обработчика события ОпМЗС, 
возникающего при приеме сообщения, выглядит иначе: 


Уу01А __Еаз®са11 ТКГогм1 : : ММ5 гибеку1М$С (ТСошропепЕ *5епаег, 
соп5Е Ап5156ег1лпа $Егош, Тоегеам *$е гм) 


Если вы сравните с приведенным в разд. 9.3.2 обработчиком этого события 
в компоненте МММ$УСЪЗегу, то увидите, что единственное отличие — это тип 
третьего параметра $ёгт. В данном случае это тип Т5&геат — базовый класс 
потоков в С++ВиПаег. 

Давайте для начала познакомиться с этими классами объектов. Базовым 
классом потоков в С++ВаПаег является Т5фгеат. У этого класса имеется ряд 
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потомков, из которых в данном разделе мы будем иметь дело с двумя: 
Т5нште${геат — поток для работы со строками, и ТЕЦе®геат — поток для 
работы с файлами. 

Во многих отношениях поток напоминает файл. Свойство Роз лоп указы- 
вает текущую позицию в потоке. Значение Ро5110п равно количеству байтов 
от начала потока. Например, задав Роз110оп = 0, можно установить текущую 
позицию на начало потока. Второе свойство класса ТЭ@геат — 512е. Это свой- 
ство указывает размер потока в байтах. Метод ЗееК подобен аналогичному ме- 
тоду в файлах и позволяет изменять текущую позицию. Он объявлен следую- 
щим образом: 


У1гЕиа1 1пЕ _ Еаз®са11 5ееКк(1пе ОЕЁЕзее, Мога Ог191п); 
Параметр ОЁ#ё$её указывает величину сдвига текущей позиции, а параметр От- 


211 определяет, точку отсчета этого сдвига. Этот параметр может принимать 
следующие значения: 


Г ————— ии 

‚ зоЕготВей1ти1т5 (Сдвиг от начала потока. Значение Обе должно быть по- 

| ложительным. 

5 зорготСигтепе Сдвиг от текущей позиции Роз11оп. Значение ОЁ$её может 


быть положительным (сдвиг к концу) или отрицательным 
| (сдвиг к началу). 


Но НИ И а 


зоЕгошЕпа Сдвиг от конца потока. Значение ОЁЁ5её должно быть отри- 
цательным. 


Я 
| 
| 
НИ ЕЕ ЕЕ 2.5. —=—=— рые —> == ЕЕ: Е 


Метод ЗееК возвращает новую позицию в потоке, т.е. новое значение свой- 
ства Роз лоп. 


Потоки создаются, как и все другие объекты, конструкторами. Их форма 
зависит от того класса-потомка ТЭфгеат, объект которого создается. Для клас- 
са Т54гте5{геат конструктор имеет вид: 


__ Еазеса11 Т5$&©г1пазекеам (сопз® Ап5156х1па Абег1па); 


Параметр АЗфгтх определяет строку, которая заносится в поток. Для класса 
ТЕЦеэ{геат конструктор имеет вид: 


__Еаз®са]11 ТЕ11]е5егеам(сопз®е Апз156г1па Е11еМаме, Мога Моае); 


Параметр ЕИеМаше указывает имя файла, для которого создается поток. 
А параметр Моде указывает режим открытия потока. Он объединяет один из 
флагов открытия файла и один из флагов доступа к потоку. Флаги открытия 
файла могут быть следующими: 


а 


| {па Сгеафе Создание нового файла. Если файл с заданным именем 
‚уже существовал, он открывается в режиме ппОреп\Угце. 


||. 
И 


_ВпОрепВеад_ | Только для чтения. 

| `риОреп\тгНе. Только для записи. При записи в файл прежнее содержи- 
‚ мое файла уничтожается. 

| о НЕ — о 


`‘пОрепКеаа\ гие | Чтение и запись (при записи прежнее содержимое не 
_| уничтожается). _ 
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Флаги доступа к потоку могут иметь значения: 


Нибвагерепу\тНе Запрет другим приложениям записывать в файл.  _ _ 
| 


тЭВаге)епуВеа4 Запрет другим приложениям читать из файла. 


#т5ВагедепуМопе Полный доступ к файлу других приложений. | 


Чтение информации из потока в буфер можно осуществлять методом 
ВеадаВоЁег: 


у014 _ Еаз®са11 ВеааВоЕЕек (\о1а *ВиЕЕек, 1пе СоппЕ); 


Метод читает Соипф байтов из потока в буфер ВиЁег. Если заданное число 
байтов Соипф прочитать невозможно, генерируется исключение ЕВеа@4Еггог. 

В потоках типа Типо геат имеется также свойство только для чтения 
Ожазигшо, обеспечивающее прямой доступ к содержимому потока. 

Метод УгЦеВийЁег: 


у01А _ Еаз®са11 Мг1ееВоаЕЕек (сопзЕ уо1а *ВаЕЁЕег, 1пе Соцп®); 


записывает в поток Соип& байтов из буфера ВиЁег. Если заданное число бай- 
тов записать невозможно, генерируется исключение Е\/гЦеЕггог. 

Переносить информацию из одного потока в другой можно методом 
СоруЕгот, который определен следующим образом: 


__ 110664 __Еаз®са11 СоруЕгком (Т5&геам* 5очгсе, __ 11664 СочпЕ); 


Параметр Зоигсе определяет поток, из которого переносится информация, 
а параметр Сопп& указывает число копируемых байтов. Если задано Соип& > 0, 
то копирование производится, начиная с текущей позиции потока Зопгее. По- 
сле копирования позиция в потоке Зопгсе смещается на Соипф байтов. Если 
же задано Соипф = 0, то перед копированием позиция в Зоигсее устанавливает- 
ся на нуль и затем копируется все содержимое потока. Функция возвращает 
число скопированных байтов. 


Вот, пожалуй, основные свойства и методы, которые потребуются для ра- 
боты с компонентами ММ5%4гт и ММ5е`тфегу. Давайте теперь займемся мо- 
дернизацией написанного в прошлом разделе приложения. Будем пробовать 
через него передавать и двоичные файлы. 

Подобное приложение (это проект М3552 в каталоге Разё Ме на диске, при- 
ложенном к книге) может иметь вид, представленный на рис. 9.4. Вспомним 
основные обозначения в прошлом приложении. Окно редактирования Получа- 
тель (его имя в приложении ЕНо$$) содержит адрес сервера, которому отправ- 
ляется сообщение или файл. Если вы тестируете приложение на своем компь- 
ютере, не выходя в сеть, то можно задать [ШР-адрес этого компьютера 
(127.0.0.1) или его имя, или “1осаШФоз". Окно редактирования Ваше имя (его 
имя в приложении Е\Во) содержит имя, по которому тот, кто получит ваше 
сообщение, сможет понять, от кого оно пришло. В окно ВаевВ ЕЁ заносятся 
приходящие текстовые сообщения. При щелчке на кнопке Передать текст (ее 
имя в приложении ВРо5${) адресату передается текст, записанный в окне Гекст 
сообщения (Мето1). При щелчке на кнопке Передать файл (ее имя в приложе- 
нии ВЕПе) открывается диалог открытия файла, в котором пользователь мо- 
жет выбрать отправляемый файл. 
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Рис. 9.4 (3 Программа передачи сообщ 
Приложение для обмена , | | 
текстовыми сообщениями Ваше имя: ‚ Получатель Протокол диалога 
ре [Крокодил Гена п 2.0.0.1 02.03.2004 20:14:25: Крокодил Гена 

и двоичными файлами Добрый вечер, Чебурашка!!! 

Текст сообщения 02.03.2004 20:15:36: Чебурашка 

Привет, Гена. А можешь переслать ` 
Сейчас перешлю. | фотографию с нашей вчерашней 
\ вечеринки? 


02.03.2004 20:16:07: Крокодил Гена 
Сейчас перешлю. 


| Передать текст | Передать оайл | Очистить | ‘Сохранить | 


Помимо описанных компонентов на форме, естественно, расположены 
компоненты ММ@гт и ММ5гтфегу, которые обеспечивают отправку и при- 
ем сообщений. 


Прежде, чем рассматривать код этого приложения, надо решить, как по- 
лучатель сможет распознавать, пришло ли ему текстовое сообщение, или дво- 
ичный файл. Сервер получает сообщение базового типа Т$%фгеат и, казалось 
бы, сложно определить, был ли тип этого потока при его отправке ТЭИтте- 
5 геат, или ТЕПефгеат. Можно предложить различные способы распознава- 
ния вида пришедшего потока, основанные на внесении в поток какой-то услов- 
ной информации. В данном приложении, давайте, реализуем эту информацию 
следующим образом. Пусть передача двоичного файла будет предваряться пе- 
редачей текстового сообщения с текстом "Передача файла". И сразу после пе- 
редачи такого текста будет передаваться отдельным потоком двоичный файл. 
Тогда сервер сможет принимать все приходящие сообщения как текстовые, и, 
получив указанный выше условный текст, настроиться на прием следующего 
потока как двоичного файла. 

Ниже приведен код данного приложения. 


епом {пТехе, пЕМаме, пВ1паг} Моае = пшТехёе; // режим приема 


У01А __Еазеса11 ТГогм1:;:ВРоз(С11ск(ТОБ]есЕ *5епаег) 
{ 
ММ5Егм1->НозЕ = ЕНозЕ->ТехЕ; 
ММ5 Е ум1->ЕгопМапе = ЕМБо->ТехЕ; 
Т5$х1лпазбгеам * 5Ег = пем Т5ег1лпазегеап (Мето1->Тех*); 
В1срЕа12->Г1пез->Ааа (Гогиа®*РафеТ1ме ("",Мом()) +": " + 
ЕМПо->Техе); 
В1срЕа1 Е 2->Ь1пез->Ааа (Мепо1->Тех{); 
Сху 
{ 
ММ5 Е гм1 ->РозЕТЕ (5356г); 
} 
саесрп (...) 
{ 
зпомМеззасде ("Ошибка передачи"); 
} 


Ехг->Егее (); 
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У0о3А __Еаз®са11 ТКогт1: :ВЕ11еС11сКкК (ТОБ)есе *5епаег) 
{ 
1Е (Орепр1а10о91->Ехесифе ()) 
{ 
Т5Ег1пабегеам * 5%г; 
ММ$Е ги] ->Нозе = ЕНо$®->Тех&; 
ММ5 Е ги1->ЕгопМаме = ЕМПо->Техс; 
гу 
{ 
ЗЕг = пем Т5Ег1пабегеам ("Передача файла"); 
ММ5 Е ги1 ->РозЕТе (56г); 
5Ег->Егее (); 
ЗЕг = пем Тбег1лпазегеам (Ех гас&Е11еМамте ( 
Орепр1а1о91->ЕГ11еМапе)); 
ММ$ Е хм1 ->РозЕТЕ (56г); 
} 
саеср (...) 
{ 
ЗПомМеззасве ("Ошибка передачи"); 
1Е (Ех) ЗЕкг->ЕРгее (); 
гебагп; 
} 
$Ех->ЕРгее (); 


: 


//передача файла 
ТЕ11ебсгеап* ЗЕ = пем ТЕ11]ебсгеам ( 
Орепр1а1о0о31->Е11еМаме, ЕтОрепВеаа); 
Егу 
{ 
ММ Е ги1 ->РозеТЕ (5Е); 
}. 
саесв (...). 
{ 
ЗПоиМеззасе ("Ошибка передачи"); 


} 
ЗЕ->Егее (); 


\01А __ЕазЕса11 ТКогм1: : ММ5& ги1 Тпуа11АНоз® (роо1 &Напа1еа) 
{ 

Ап$156г1па 5Но$е; 

ЗНо5е = №М5еги1->Но$е; 

1Е (ТораЕОчцегу ("Ошибочный адрес", 

"Можете указать новый адрес", $Ноз\)) 

{ | 
ММ5Еги1->Ноз®е = $Нозе; 
НапЧа1еа = &гое; 


} 


\01А _ Еаз®са11 ТЕогп1:; :В5ауеС11сК (ТОБр)есе *5епаег) 

{ | 

1Е (бауер1а10о391->Ехесие ()) 
К1срЕа1*2->Ь1пе5->5ауеТоЕ11е (Зауер1а1о91->Е11еМапте); 


Уу014 _ Еаз®са11 ТЕогм1::ВС1еахС11сК (ТОБ)ес®е *5епаег) 


{ 
В1сВЕА12->С1еах(); 
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Уу01А __Еаз©са11 ТГогп1: :Тлмег1Т1иег (ТОБ]есе *5епаег) 
{ 
Е] аз И1паом (Арр11сак1оп->Напа1е, гие); 


у014 __Еаз®са11 ТГоги1; :Арр11саЕ1опЕуепе з1АсЕ1туа*е ( 


ТОБ]есе *5епаег) 
{ 
Т1мег1->Епаб1е = Еа1$е; 


у01А __Еаз®са11 ТГогм1: : ММ5 гибегу1М5С (ТСотропепе *5епаег, 
сопзЕ Ап5156у1па $ЕРгош, Т5Егеам *5Егм) 


1Е (Моае == шТех®) 

{ 

Т5ег1лпазегеам * 55 = пем Т5&г1пазегеам(""); 
$55->СоруЕком (56 гм, 0); 

1Е (55->Рабабег1па == "Передача файла") 

{. 
55->Егее (); 
Моае = шЕМапе; 

} 
е15е 

{ 

В1срЕа1 2->Г1пез->ААа (Еогпа*РафеТ1ме ("", Мом ())+ 

и; "+ э<Рком); 

В1свЕа12->1пе5->ААа (55$->Рафба5ег1па); 

$5$->Егее (); 

1Е ( ! Арр11са®1оп->Асе1уе ) 

{ 


Т1иех1->Епаб1еа=егае; 


Веер (); 
} 
} 
} 
е1зе // Моае не тТехЕ 
{ 
1Е (Моае == пЕМапе) 
{ 
Т5Ег1па5Егеам * $$ = пеи Т5Ег1па$+геам(""); 


55->СоруЕгком ($6гш, 0); 

Зауер1а1о92->Е11еМатме = $5->Рафа5®г1па; 

Моае = пВ1паг; 

} 
е1зе 

{ 

// Прием двоичного файла 

Моае = пТехе; 

В1срЕа12->Г1пе$->Ааа (ГогмаЕПБафеТ1ме ("", Мом())+ 

и; "+ $зЕгом); 


1Е (Арр11са®1оп->МеззааевВох ( ("Пользователь " + $Еком + 
" присылает вам файл " + бауер1а1оа2->Е11еМаме + 
". Сохранить?").с _$6г(), "Сохранение файла", 
МВ _УЕЗМОСАМСЕТ + МВ _ТСОМОЧЕЗТТОМ) == ТРУЕ$) 


1Е (бауер1а1о92->Ехесиее ()) 

{ 

// Создание потока 

ТЕ11ебЕкеам *5Е =пем ТЕ11ебегеам (бауер1а1о92-> 
Е11еМаме.с_зег(),ЕмСгеаке); 

5Е->СоруЕгом ($Егм, 0); 

ЗЕ->Егее (); 

В1свЕа1е2->Ь1пе$->ААа ("Принятый файл сохранен в" + 
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Зауе01а1оа2->Е11еМапе); 
} // конец 5$ауер1а1од2->Ехесиее () 
} // конец приема двоичного файла 
} // конец Мое не тТехЕе 


} 


Рассмотрим приведенный код. Функция ВРо$СПеК обеспечивает переда- 
чу текстового сообщения при щелчке пользователя на кнопке Передать текст. 
После занесения в свойства ЕгошМаше и Но$ компонента ММ5%фгт]1 данных 
об отправителе и получателе, создается поток Эй` типа Т5ёгте $ {геат. В мо- 
мент создания в него заносится текст окна Мето1. Затем этот поток методом 
Роз посылается получателю. При ошибке соединения пользователю выдает- 
ся сообщение об ошибке. В любом случае, при успешной или несостоявшейся 
передаче сообщения память очищается от временного объекта Эфг. 

Функция ВЕПеСПеК обеспечивает передачу двоичного файла при щелчке 
пользователя на кнопке Передать файл. Начинается функция с открытия диа- 
лога ОрепП1а10о21, в котором пользователь выбирает передаваемый файл. За- 
тем объявляется поток Эёг типа Т5%гште{геат. После занесения в свойства 
Егот Маше и Но${ компонента ММ$5%тт1 данных об отправителе и получателе, 
следует конструкция фту ... саеВ, в рамках которой посылаются строковые со- 
общения и отлавливаются исключения, которые могут возникнуть при от- 
правке. Сначала создается поток Эфг, назначение которого — предупредить 
сервер, что далее будет передан двоичный файл. В момент создания потока У%г 
в него заносится условный текст "Передача файла”. Затем этот поток методом 
Ро$ 4 посылается получателю. После этого поток уничтожается, и создается 
заново с загруженным в него именем файла. Имя извлекается функцией 
ЕжгасЕЦеМаште из полного имени файла, содержащегося в свойстве Ореп- 
01а1051—>ЕПеМате. Поток передается пользователю методом Роз \, и затем 
уничтожается. | 

После этих подготовительных операций создается поток ЗЕ типа ТЕе- 
5(геаш, и в момент его создания в него загружается выбранный пользователем 
файл. Файл загружается в режиме «только для чтения». Созданный поток пе- 
ресылается серверу методом Роз. 

Функция ММ54гт Ипуа19Но$& является обработчиком события Оптуа- 
ПаНо$ё компонента ММЗ игт1Т. Аналогичная функция, как и функции В$ауе- 
Спек, ВЦеагСПсК, Типег1Т1 тег, АррПсайЙопЕуеп{5 1 АсНйуз{е были рассмот- 
рены в разд. 9.3, и мы на них останавливаться не будем. | 

Теперь перейдем к функции, обслуживающей серверную часть приложе- 
ния: функции ММ5%4ттФегу1М$С, которая является обработчиком события 
ОпМ$ЗС компонента ММЗи‘т5Зегу1. Это событие наступает при приеме сообще- 
ния. К функции ММ ®т5егу1 М5С обращение может быть в трех случаях: при 
приеме текстового сообщения, при приеме имени передаваемого файла, и при 
приеме самого файла. Так что в функции надо как-то различать эти три ситуа- 
ции. Это делается с помощью объявленной в приложении глобальной перемен- 
ной Моде перечислимого типа. По умолчанию эта переменная равна шТехф, что 
соответствует приему текстового сообщения. Если в этом режиме работы оказы- 
вается, что принят условный текст, свидетельствующий о последующем приеме 
информации о файле, то значение Моде задается равным шЕМате. Тогда в сле- 
дующий раз функция ММ5фгт5егу1М5С принимает и обрабатывает имя фай- 
ла, после чего задает Моде = тВтаг. При следующем обращении к ММ$%ёгт- 
эегу1 МС принимается двоичный файл, после чего задается Моде = шТехё. 
В результате функция готова к приему новой текстовой информации. 
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Итак, перейдем к рассмотрению текста функции ММ$5%4тт$егу1М$С. Это 
событие наступает при приеме сообщения. Если переменная Мо4е равна 
ш’Техё, значит, принимается текстовое сообщение. Тогда создается поток $5 
типа ТБйчи? Игеат и в него методом СоруЕгот копируется содержимое при- 
нятого потока $&гт. Если это содержимое — строка "Передача файла”, значит 
данный поток — предупреждение о последующей передаче файла. В этом слу- 
чае сообщение не фиксируется в протоколе, переменной Мо4е присваивается 
значение тЕМаше, и обработчик, подготовившись к приему файла, завершает 
работу. Если же содержимое сообщения не равно условной строке, то в прото- 
кол заносятся сведения о времени приема сообщения и о том, кто его послал. 

Если в начале обработчика ММ5гт$егу1М$С выясняется, что режим 
Моде равен тЕМаше, то создается поток $5, в него копируется строка с име- 
нем файла, и это имя заносится как начальное значение в диалог сохранения 
файла ЗауеП1а1ю72. Переменной Моде задается значение тВтаг. 

Если в начале обработчика ММ5гт5егу1М$С выясняется, что режим 
Моде не равен ни шТехф, ни тЕМате, значит, он равен шВтаг, и надо прини- 
мать бинарный файл. Тогда в ВаеВЕЗЫ1 заносится сообщение об этом, и поль- 
зователю задается вопрос о сохранении файла. Если он ответил утвердительно, 
то открывается диалог сохранения файла Зауе 1а1052, в котором он может за- 
дать имя и каталог файла. Затем создается поток ЗЕ типа ТЕЦе@геат, кото- 
рый в свою очередь создает указанный файл. В него копируется методом 
СоруЕгот содержимое принятого потока. В Ве ВЕЯЦ заносится имя сохранен- 
ного файла. 

Мы рассмотрели все функции приложения. Можете создать подобное при- 
ложение сами, внеся в него желательные вам изменения, а можете просто вы- 
полнить это приложение, содержащееся на прилагаемом к книге диске. Толь- 
ко для того, чтобы осуществить обмен информацией, надо запустить не менее 
двух экземпляров приложения. Все вопросы, связанные с этим, обсуждались 
в конце разд. 9.3. А приложение во время выполнения показано на рис. 9.4. 

В данном приложении для идентификации передаваемого файла использо- 
валось предварительное условное текстовое сообщение. Это принятое нами ус- 
ловие — простейший протокол передачи. Вы можете его усложнить. Напри- 
мер, недостатком приложений, рассмотренных в данном и предыдущем разде- 
лах, является отсутствие обратной связи. Приложение посылает файл, и не 
знает, дошел ли он до получателя. Хотелось бы, чтобы серверное приложение 
послало отправителю сообщение о принятом файле. Но сервер не знает, с како- 
го адреса пришло сообщение, так что не знает, куда посылать подтверждение. 

Эту проблему можно, например, решить так. Если клиент считает свое по- 
слание очень важным, то клиентское приложение может включить в отправ- 
ляемую строку с именем файла какой-то условный символ, например, "+", по- 
сле которого указать свой адрес. Если речь идет о локальной сети, то в разд. 
2.1.5 показано, как можно определить имя компьютера с помощью функции 
Се СотрщегМате. Серверное приложение, получив строку с именем файла, 
должно проверить, нет ли в нем символа "#”". Если есть, то надо запомнить 
имя компьютера отправителя, помещенное после этого символа, и, когда дво- 
ичный файл будет принят, оповестить об этом отправителя. 

Попробуйте сами реализовать такой несколько более сложный протокол. 
Для его осуществления достаточно добавить на форму индикатор СвесКВох, 
и в функцию ВЕПеСПсК ввести операторы, формирующие при выбранном ин- 
дикаторе соответствующим образом отправляемую строку с именем файл и до- 
бавленным в нее именем компьютера. А в функцию ММе’тзЗегу МЭС надо 
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ввести операторы, дешифрующие эту строку и посылающие при необходимо- 
сти извещение отправителю. 

Другой вариант, основанный на некотором более развернутом протоколе 
передачи, рассмотрен в примере разд. 9.5. Подобный подход можно было бы 
(и с большей эффективностью) применить и в данном разделе. 


9.4 Сокеты 


В данном разделе описывается работа с компонентами сокетов, расположен- 
ными в С++ВиПаег 6 и более ранних версиях на странице библиотеки Пиете!. В 
С+-Ви!Паег 2006 по умолчанию эти компоненты отсутствуют. Но в действитель- 
ности пакет времени проектирования 4с[30сЁе!тз100.6 21, содержащий эти компо- 
ненты, присутствует в библиотеке. Надо только его установить. Для этого надо 
выполнить команду Рго}ес& | ОрНопз, в открывшемся окне опций проекта 
(рис. 9.5) перейти на страницу РасКаез, нажать кнопку АЧОЧ и найти в каталоге 
...\Ртготат ЕЦез\Вотапа\ВО5\4.0\Вт файл ас[30сЁе1з100.6р1. После того, как 
вы нажмете в окне рис. 9.5. кнопку ОК, вы сможете увидеть в палитре компо- 
нентов в разделе Пете описанные далее компоненты. Полезно перед выходом 
из окна рис. 9.5 включить индикатор ОеГау! в левом нижнем углу, чтобы в даль- 
нейшем этот пакет подключался к проектам по умолчанию. 


| & РгодесЕ Орбопб Гое рриогипъеке 


+. С++ Сотрйег (Бсс32) 

+. Ипкег (йпКЗ2) _ `` беябп раскадез | 

+. Везоигсе Согпрйег (Бгсс32) Х “ Вонапд затре Сотропелез — — —- з] 

+ РазсаГСогпрйег (2СС32) |\. Войапд батр/е Сопго5 Везодп Тите РасКаде 

+= Тибо д5зетЫег (Ка5т32) 1 у. ВоМапЧ этпр!ебагазеЕ Сотропепе (ОВХ) 

‚ Рони$ |\ Во|апд 5ОДР СотропегЕз 

‚_ Мегыюп Ро |м ВоНапд ЗОЕ Ехрогег 1 РасКаде —: 
|  Раскадез '\. ВоНапд 5ЕапЧаг4 Сотропеп($ 
'+. БеБиддег у: Войапд \МеБ5пар Сотропегиз >| 


"КАРгодгаг Рйез\Войапа\ВС5\4.0\ВИп\ЧАвосКеЕ5100.5РЕ 


| Ветоуе о. СотропепЕ$ | 


№ ВИЗ В гопНте расКаде$ 


- Кипёте раскадез - 
ман: ЧН! адотуаЧЬ сдает: ЯБх иьхргес: 4епар: Чзпар:аэпарсоп. .. 


М оеЕацЕ | ок | Сапсе! ‚ Нар | 


Рис. 9.5. Установка в С++ВиЙаег 2006 пакета сокетов 


| 


9.4.1 Клиентский сокет 


Сокеты — это некие коммутаторы, обслуживающие соединения в сети. По 
своему назначению они разделяются на три типа: клиентские, слушающие 
и серверные. Клиентский сокет инициирует соединение, указывая имя или 
[Р-адрес удаленного сервера и порт, используемый сервером. В сервере запрос 
клиента об установлении связи получает слушающий сокет. Его задача — 


764 Г лава 9. Организация взаимодействия приложений в сети 


сформировать очередь запросов. А серверный сокет, освободившись от теку- 
щей работы, берет очередной запрос из очереди и устанавливает соединение 
с клиентским сокетом. В результате клиентский сокет получает описание сер- 
верного сокета, с которым он установил связь. 

Таким образом, сокеты позволяют организовать обмен информацией в се- 
тях, когда к одному серверу может одновременно обращаться множество кли- 
ентов. При этом может быть организован форум или чат для взаимного обмена 
информацией группы пользователей. Каждый член чата имеет соответствую- 
щее клиентское приложение, которое позволяет читать полученные сообще- 
ния и посылать собственные сообщения целенаправленно какому-то одному 
участнику чата, или всем участникам одновременно. А серверное приложение, 
работающее на каком-то одном компьютере, доступном через сеть всем участ- 
никам чата, осуществляет диспетчеризацию сообщений, направляя их нуж- 
ным адресатам. 

Функции клиентского сокета выполняет компонент СПеп{ЗосКе{ со стра- 
ницы [тегпе!. Вместо одного свойства Но$%, имевшегося у ранее рассмотренных 
компонентов, у СНеп ЗосКеф два свойства: Но$& — имя сервера, и А4@агез$ — 
ТР-адрес сервера. Для указания сервера можно задать значение только одного 
из этих свойств. Если заданы оба значения, то предпочтение отдается имени. 

В свойстве Рогё указывается номер порта, используемого для соединения 
с сервером. О понятии «порт» уже говорилось в разд. 9.2. Там же говорилось 
О ПОНЯТИИ «сетевая служба». В компоненте СПепЗосКеё имеется свойство 
Зегу1се, в котором указывается в виде строки соответствующая служба. Так 
что порт может быть указан явно в свойстве Рогф, или неявно, если установле- 
но значение службы в свойстве Зегмее. Если определены значения обоих этих 
свойств, то предпочтение отдается имени службы. 

Свойство СПеш Туре определяет, будут ли операции чтения и записи через 
открываемое соединение осуществляться синхронно или асинхронно. Если 
в свойстве СНепТуре установлено значение с М№опВ]юосЕтя, используется 
асинхронный режим чтения и записи. В этом случае приложение не ждет 
окончания соответствующей операции и продолжает свою работу. При значе- 
_ нии СПепё Туре = с В1осКшх режимы чтения и записи синхронные, т.е. выпол- 
нение клиентского приложения останавливается до окончания соответствую- 
щей операции. Для того чтобы и в этом случае не блокировать выполнение 
приложения, удобно создать отдельный поток (см. разд. 3.8), в котором будут 
осуществляться операции чтения и записи. 

Для соединения с сервером используется метод Ореп, для завершения со- 
единения — метод С]1озе. Альтернативным способом установки и разрыва со- 
единения является задание значений фгае или Ёа[$е свойству Аейуе. Впрочем, 
во время выполнения лучше применять методы Ореп и С(1озе, а свойство 
Асйуе использовать для определения, является ли в данный момент соедине- 
ние активным. А если во время проектирования установить Асйуе в фгие, то- 
гда соединение автоматически будет устанавливаться в момент начала выпол- 
нения приложения. 

После того как соединение установлено, информацию о сервере можно по- 
лучить из свойства только для чтения ЗосКеф. Это свойство является объектом 
класса ТСПеп+ \Ут5$осКеф. С помощью его свойств только для чтения Ветофе- 
АЧ@гез$, Вето&еНо${ и ВетофеРог& можно определит соответственно ГР-ад- 
рес, имя (ОВТ,) и порт сокета на другом конце соединения. Аналогичные свой- 
ства Госа1Ад4ге$$, Госа1Но$ и Госа!Рог& содержат соответствующую инфор- 
мацию о сокете клиента. Свойство КетофеАЧ4г является структурой типа 
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зосКад4г ш, поля которой содержат ту же информацию, что и свойства 
ВетофеА4@ге$$ и ВетофеРог+. Эту запись можно использовать при прямом об- 
ращении к АР! сокетов \/1п4о\з, если вам это потребуется. Для тех же целей 
может использоваться свойство Зоске Нап /е — дескриптор сокета, исполь- 
зуемый в АР[Г сокетов \/114о\$. 

Свойство Вафа является нетипизированным указателем ройфег на некото- 
рый объект, который можно связать с данным сокетом. Например, это может 
быть строка, идентифицирующая пользователя. 

Из методов объекта ЗосКеф следует, прежде всего, остановиться на мето- 
дах, осуществляющих передачу сообщения. Метод ЗепаТехё: 


10 __Еаз®са11 ЗепаТех® (сопзе Апз15Ег1па 5); 


посылает текстовое сообщение 3. Если передача сообщения прошла удачно, 
метод возвращает 0. Если осуществить передачу не удалось, то возвращается 
ненулевое значение. В этом случае передачу следует повторить через некото- 
рое время. Если во время передачи возникла ошибка, соединение разрывается, 
и генерируется исключение ЕЗосКеёЕггог. 

Рассмотренный метод Зеп4Техё позволяет передавать текстовые сообще- 
ния. Методы Зепд $ {геат и Зеп9 5 {геатТЬепОгор передают поток, в который 
можно записать любую информацию, в том числе любые двоичные файлы. Эти 
методы объявлены следующим образом: 


роо1 __Еаз®са11 5епа5геам (С1аззез: :Т5&геам* АЗегеам); 
роо1 _ ГазЕса11 5епа5 геамТПепргор (С1аз5ез: :Т5егеам* Абфгеам); 


Методы передают в открытое соединение сокета информацию, содержа- 
щуюся в потоке А$4геат. Возвращаемое значение показывает, была ли ин- 
формация успешно передана. Различие этих двух методов заключается только 
в том, что Зепа{геатТЬепОгор закрывает соединение после передачи сооб- 
щения, а Зепа 5 {геат оставляет его активным. 

При выполнении обоих методов сокет становится владельцем (Омпег) пе- 
реданного в него потока и освобождает занимаемую потоком память после кон- 
ца работы с ним. Поэтому не требуется специально освобождать память, отве- 
денную под поток. 

Имеется еще метод передачи сообщения Зепа Ви: 


1пЕ __Еаз®са11 ЗепаВчЕ (уо1а *ВиЕЁ, 1пЕ Соип®); 


Он записывает в соединение Соипф байтов из буфера Ви{. Обмен информацией 
ведется через библиотеку УтЧомз ИтбосЕ.аИ. Если в данный момент внут- 
ренний буфер этой библиотеки не может вместить требуемое количество бай- 
тов, функция ЗепаВоЁ возвращает —1. В этом случае надо через некоторое вре- 
мя повторить попытку передачи сообщения. В случае использования блокиру- 
ющего режима функция Зепа Вт возвращает действительно переданное число 
байтов. Если во время передачи сообщения возникли ошибки, соединение раз- 
рывается и генерируется исключение ЕЗоеке{Еггог. 

Для чтения переданных сообщений в объекте ЗосКеф предусмотрен ряд ме- 
тодов. Метод ВесауеТехё: 


Ап515Ег1па _ Еазеса11 ВеселуеТехь (); 
возвращает строку переданного сообщения. Метод ВесатуеВиЁ: 
115 _ Еаз®са11 ВеселуеВоЕЁ (уо1а *ВиЕЁ, 1пЕ СоцпЕ); 


читает Соипё байтов в буфер ВчЁ и возвращает число реально прочитанных 
байтов. Если ни один байт не прочитан, возвращается -1. 
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Метод ВесауеГепо 1: 


11 __Еаз©са1]1 ВесезуефепаеВ (уо1а); 


возвращает число байтов, которые могут быть прочитаны в сообщении в асин- 
хронном режиме. Возвращаемое значение можно использовать для выделения 
буфера соответствующего размера, используемого в методе ВесехуеВчЕ. 

Теперь рассмотрим события компонента СПеп{ЗосКе{. При открытии кли- 
ентом соединения происходит следующая последовательность событий: 


`Оптоокир В обработчике можно изменить какие-то параметры сокета. 
После завершения обработки события производится поиск со- 
‚ кета сервера. 


`ОпСоппесНие Наступает после того, как сокет сервера найден. Соединение 
| 
| 
| 
| 


| в этот момент еще не установлено, но в обработчике события 

уже можно узнать параметры серверного сокета. После завер- | 
‚ шения обработки события серверный сокет открывает соедине- | 
‚ ние. 


НИ ---— ИИ ООН ОНИ 


ОпСоппес! Наступает после установления соединения. Если чтение или 
‘передачу данных надо начинать сразу после установления сое-_ 
| ‘динения, это можно сделать в обработчике этого события. 


Ъ—==————щЩщ 


—==—— 


Заголовки обработчиков всех этих событий имеют вид: 


ус13 _ Еазсса11 имя (ТОБ)есе *5епаег, ТСазбомИ1п5оскее *5оскеф) 


Параметры Зепдег и босКкеё обычно представляют один и тот же объект — со- 
кет, событие которого обрабатывается. 

Событие ОпО15соппес{ происходит при закрытии соединения, когда свой- 
ство АсНуе сокета устанавливается в Ёай5е, но до того, как соединение будет 
действительно разорвано. Заголовок обработчика события аналогичен приве- 
денному выше. 

Событие ОпЕггог происходит при возникновении ошибки соединения. 

ус1а __Еаз®са11 ТЕГогш1: :С11епе5оскее1Еггкохг (ТОБ)]ес® *бепаек, 


ТСазфойИ1пбоскее *боскее, ТЕггкогЕуепЕ ЕггогЕхепь, 
10 &ЕггогСоае) 


Параметр ЗосКеф — это сокет, в котором возникли проблемы. Параметр 
ЕггогЕуепф — целое число, указывающее вид возникшей ошибки. Его возмож- 
ные значения будут указаны чуть позднее. Параметр ЕггогСо4е является ко- 
дом ошибки. Интерес представляет только одно значение — 0. Если в обработ- 
чике задать ЕггогСо4е = 0, то дальнейшей обработки ошибки не будет, и ис- 
ключение не будет генерироваться. 

Таким образом, обработчик события ОпЕггог может иметь, например, сле- 
дующий вид: 

м1 сЬ (ЕггогЕуеп®) 


{ 


сазе еебепа: ЗПомМеззасве ("Ошибка записи сообщения"); 
БгеаКк; 

сазе ееВесе1уе: ЭпочМеззаде ("Ошибка чтения сообщения"); 
ргеак; 

сазе ееСоппес®: помМеззасе ("Ошибка открытия соединения"); 
БгеаКк; 

сазе еер15соппесе: 5ПомМеззаде ("Ошибка закрытия соединения"); _ 
ргеаКк; 


сазе ееАссере: эромМеззавде ("Ошибка доступа"); 
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Бгеак; 
сазе еебсепега1: ЗПомМеззасве ("Ошибка соединения"); 


Е ЕГОЕСОВе = 0; 

Из этого кода вы можете видеть все возможные значения ЕггогЕуепф$ и их 
трактовку. Значение ееСепега1 соответствует неизвестной ошибке, отличной 
от всех перечисленных ранее. 

Оператор, задающий нулевое значение ЕггогСо4е, предотвращает после- 
дующую генерацию исключения. Если этого не делать, то открытие соедине- 
ния и передачу сообщений надо заключать в блоки фгу ... саёев, позволяющие 
реагировать на исключения. Например: 


сгу 


{ 
1Е (!С]1епЕбосКкКеЕ1->АсЕ1уе) 


С]11епё5оскКе&1->АсЕ1уе = фгие; 


} 
саесН (...} 


{ 


ЗВомМеззаае ("Невозможно установить соединение с сервером"); 

} | | 

Если не написать обработчик события ОпЕггог, или не задать в нем 
ЕггогСофе = 0, или не заключать операции открытия соединения и чтения/за- 
писи в блоки фту ...саёеВ, то пользователю будут выдаваться замечания на анг- 
лийском языке, которые его вряд ли обрадуют. 

События ОпВеа4 и Оп\У/гце наступают, когда приложение должно читать 
или записывать сообщение. Заголовок их обработчиков имеет вид: 


Уу01А _ ЕазЕса11 ТЕГогм1: :С11епебоскее1Веаа (ТОБ)есе *бепаег, 
ТСазбомИ1пбоскее *боскКеф) 


Для неблокированного сокета чтение и запись можно осуществлять с по- 
мощью рассмотренных ранее методов сокета ЗоскКеф. Например: 


Апз15Е капа 5е; 
5 = боскеЕ->ВеселуеТех® (); 


Для блокированного сокета (СПепё Туре = сВюсЕто5) чтение и запись надо 
производить с помощью создания объекта потока типа Т\тзосКе $ фгеат. 


9.4.2 Сокеты сервера 


В разд. 9.5.1 говорилось, что на сервере должны находиться сокеты двух 
типов: слушающий и исполняющий. В С+-+Ва!аег оба эти сокета реализуются 
одним компонентом ЗегуегЗосКе&, расположенным в библиотеке на странице 
[п4егпеф. Он автоматически создает экземпляр объекта ТЗегуег\У п осКе{ для 
прослушивания порта и по одному экземпляру ТЗегуегСПен \’т5осКеё для 
каждого открытого соединения с сокетом клиента. 

Компонент ЭегуегЗосКе{ имеет те же свойства Рогф и Зегу1се$, что и опи- 
санный в разд. 9.5.1 клиентский сокет СПепЗосКеё. Значения этих свойств 
должны быть согласованы со значениями соответствующих свойств клиентов. 
Вместо свойства СПеп& Туре у компонента ЗегуегЗосКе{ имеется аналогичное 
свойство ЗегуегТуре. Оно может принимать значения $МопВ]осК ше — асин- 
хронный режим чтения и записи, и $ ТЬгеаЯаВ1осКшях — блокирующий ре- 
жим. В этом случае для каждого соединения создается свой поток выполне- 
ния. Способ создания отдельных потоков зависит от значения свойства ТЬге- 
а4Сасве512е, определяющего число кэшируемых потоков. Это число следует 
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задавать только при ЭегуегТуре = 5 Тогеад9ВюсК1тх, исходя из ожидаемой за- 
грузки сервера. Если число ТигеааСасКВе$12е недостаточно, то много времени 
будет тратиться на создание новых потоков и освобождение памяти от уже от- 
работавших потоков. 

Соединение с сервером и разрыв соединения осуществляется так же, как 
в описанном в разд. 9.5.1 клиентском сокете СПеп$оскеф. Для соединения 
с сервером используется метод Ореп, для завершения соединения — метод 
С1озе. Альтернативным способом установления и разрыва соединения являет- 
ся задание значений фгие или Ё#а15е свойству Аейуе. Впрочем, это свойство 
лучше использовать для определения, является ли в данный момент соедине- 
ние активным. Если во время проектирования установить Асйуе в фёгие, тогда 
соединение автоматически будет устанавливаться в момент начала выполне- 
ния приложения. 

Метод Ореп активизирует слушающий сокет и устанавливает его свойство 
Асйуе в фгие. Если во время проектирования установить Аейуе в фгие, тогда 
сокет начнет прослушивать порт сразу после начала выполнения приложения. 
Метод С]1озе закрывает все соединения, и сокет перестает прослушивать порт. 

Слушающий сокет автоматически обслуживает запросы клиентских соке- 
тов на соединение. При каждом таком запросе генерируется событие ОпСПет{- 
Соппесф, в обработчике которого можно разместить требуемые операции. При 
разрыве соединения со стороны клиента генерируется событие ОпСПеп{- 
О15еоппесё. Оно генерируется до того момента, когда соединение будет дейст- 
вительно разорвано. Заголовки обработчиков обоих описанных событий имеют 
вид: 


У01а __Еаз®са1] имя (ТОр]есЕ *5епаег, ТСазбомМ1пбоскее *боскеф) 


Здесь параметр ЗосКеф представляет тот клиентский сокет, который 3 уста- 
навливает или разрывает соединение. 

Все активные соединения компонента ЗегуегЗосКе{ содержатся в его свой- 
стве только для чтения ЗосКеф типа ТЗегуегУЛ1тб$осКе&. Одно из основных 
свойств объекта типа ТЗегуег\/тЗосКеё — индексированный массив Соппес- 
{101$[1], содержащий все активные соединения. Число активных соединений 
можно найти в свойстве АейуеСоппесйоп$. Поскольку индексы в массиве 
Соппесйоп$ начинаются с нуля, то в массиве содержатся элементы с индекса- 
ми от 0 до АейуеСоппесйоп$ — 1, причем размещаются они в той последова- 
тельности, в которой устанавливались соединения. 

Свойства СоппесИоп$ и АсйуеСоппесИоп$ позволяют проводить итерации 
по всем активным соединениям, рассылая всем клиентам некоторое сообще- 
ние. Например, код: 


Еог (1= 0;1< ЗбегуегбоскКе&1->5боскее->АсЕ1уеСоппесЕ101$;1++) 


{ 
бЗегуег5оскее1->5оскеЕ->Соппесе1опз$ [1] ->5епаТех® (5); \ 


} 


рассылает всем клиентам сообщение, содержащееся в переменной Ъ. 

В моменты, когда серверный сокет должен прочитать сообщение, передан- 
ное ему клиентским сокетом, или послать сообщение клиентскому сокету, на- 
ступают события ОпСПешКВеа4 и ОпСПеп( \У'гЦе соответственно. Заголовки их 
обработчиков идентичны приведенному выше для событий ОпСПеп Соппес{ 
и ОпСПеп{О15соппес&. Параметр ЗосКеф в них соответствует тому сокету, с ко- 
торым производится обмен информацией. 
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При ошибке соединения наступает событие ОпСПетЕггог, ничем не отли- 
чающееся от события ОпЕггог, рассмотренного в разд. 9.5.1. Остальные собы- 
тия компонента ЗегуегэосКе мы рассмотрим в разд. 9.5.3, описывающем 
взаимодействие клиентов и сервера. 


9.4.3 Организация взаимодействия клиентов и сервера 


Теперь просуммируем все, изложенное в разд. 9.5.1 и 9.5.2, и рассмотрим 
последовательность событий, происходящих в серверном и клиентском прило- 
жениях. | 

Серверный сокет начинает слушать указанный порт в момент, когда свой- 
ство АсНуе компонента ЗегуегЗосКе{ устанавливается в.ёгие. Это происходит 
или при выполнении метода Ореп, или в момент начала выполнения приложе- 
ния, если АсЯуе установлено в фгае в процессе проектирования. Перед нача- 
лом слушания генерируется событие ОпГ45феп компонента ЗегуегЗоскеф. 
В этот момент еще не поздно изменить номер порта. 

Дальнейший обмен информацией между клиентами и сервером зависит от 
режима работы — синхронного или асинхронного. Остановимся на асинхрон- 
ном режиме, при котором свойство клиента СПеп Туре равно с МопВ1юсК шо, 
и свойство сервера ЗегуегТуре равно ${МопВ1осЕшх. 

При открытии клиентом соединения методом Ореп первым наступает со- 
бытие клиента ОпГоокКир. После завершения обработки этого события (если 
она происходит) производится поиск сервера. При этом генерируется событие 
клиента ОпСоппесИп?г. После завершения обработки этого события серверный 
сокет открывает соединение. Затем наступает событие клиента ОпУгЦе, в об- 
работчике которого можно передать на сервер какое-то сообщение, например, 
учетную информацию клиента — его имя. После этого наступает событие кли- 
ента ОпСоппес%. В его обработчике может быть предусмотрена передача или 
чтение сообщения, требуемого при регистрации соединения. 

Параллельно происходит ряд событий на сервере. В момент установки со- 
единения генерируется событие сервера ОпСбе ЗосКе{. В этот момент сервер 
создает объект типа ТЗегуегСЦПеп  \тбосКе{, который представляет сервер 
в соединении с данным клиентом. Затем генерируется событие сервера ОпСИ- 
еп \УтгЦКе. В обработчике этого события можно послать клиенту какое-то сооб- 
щение. Завершается создание соединения событием сервера ОпСЙешСоппес. 
В результате новое соединение заносится в свойство СоппесЯоп$ компонента 
ЗегуегЭосКе&. После этого наступает событие сервера ОпАссер&, в обработчике' 
которого уже можно полноценно использовать установленное соединение. 

При разрыве соединения со стороны клиента методом С]озе сначала возни- 
кает событие клиента Оп О15соппес{. Если в обработчике этого события пре- 
рвать разрыв функцией АБогф, соединение останется активным. Если разрыв 
не прерван, то далее наступает событие сервера ОпСПеп О15соппес+. В этот мо- 
мент соединение еще не удалено из свойства СоппесИоп$ компонента Зегуег- 
ЗосКеф, так что в серверном приложении можно предусмотреть какие-то дей- 
ствия, связанные с вычеркиванием соединения из списка клиентов. 

Передача сообщений клиентом или сервером осуществляется описанными 
в разд. 9.5.1 методами ЗепаТехё, Зеп@ 5 геат, Зеп9 5 {геатТВепОгор, Зепд- 
ВоЁ объекта ЗосКеф, являющегося свойством компонентов СЦПеп{ЗосКеф и Зег- 
уег5осКеё. При передаче клиентом какого-то сообщения возникает событие 
сервера ОпСПетКВеа4. Впрочем, если сервер в данный момент занят, то сооб- 
щение ставится в очередь, и событие ОпСПеп{Веа@ наступает только после 
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того, как это сообщение будет взято из очереди. При передаче сервером сооб- 
щения какому-то клиенту, в сокете этого клиента наступает событие ОпВеа4д. 

В обработчиках событий ОпСПеш{Веа4 и ОпВеа4 можно прочитать при- 
шедшее сообщение и отправить ответное сообщение серверу или другому кли- 
енту. Чтение сообщения осуществляется описанными в разд. 9.5.1 методами 
ВБесетуеТех{ или Весе1уеВо{ объекта ЗосКе, являющегося свойством компо- 
нентов СНешёЗосКе{ и ЗегуегЗосКеф. 


9.4.4 Пример организации чата 


Давайте построим пример организации чата. У нас будет сервер и клиент- 
ские приложения, которые имеются у всех участников чата. Каждый клиент 
может присвоить себе некоторое имя, под которым он будет известен участни- 
кам чата. Впрочем, при желании он может изменить это имя, разорвав связь 
с сервером и затем создав новую связь под другим именем. 

У каждого участника чата в его клиентском приложении имеется список 
всех участников, подключенных в данный момент к чату. Он может послать 
свое текстовое сообщение какому-то одному из этих участников, или сразу 
всем участникам. Таким образом, между участниками чата могут происходить 
оживленные переговоры по каким-то животрепещущим вопросам. Мы ограни- 
чимся в примере только передачей текстовых сообщений, хотя не представля- 
ет труда добавить в это приложение обмен двоичными файлами. По такому же 
принципу можно организовать обмен информацией между множеством кли- 
ентских приложений, передающих друг другу какие-то результаты расчетов 
и сообща работающих над решением какой-то сложной задачи. При этом па- 
раллельно будут использоваться вычислительные ресурсы нескольких компь- 
ютеров, что повысит эффективность работы. 

Прежде, чем программировать эту задачу, надо договориться о каком-то 
протоколе обмена сообщениями. Пусть, например, каждый клиент будет по- 
сылать свою информацию в следующем формате: 


<имя адресата><символ #><имя автора сообщения><символ #> 
<текст сообщения> 


Если имя адресата будет равно “Всем”, значит, сообщение должно быть разо- 
слано всем участникам чата. 

Сервер, получив сообщение, должен определить адресатов и разослать им 
‘сообщение, убрав из него первую часть — т.е. имя адресата. Таким образом, 
каждому клиенту сообщение будет поступать в формате: 


<имя автора сообщения><символ #><текст сообщения> 


Клиентское приложение, получив сообщение, должно показать пользова- 
телю текст этого сообщения с указанием, от кого оно пришло. 

Помимо обмена сообщениями между клиентами надо предусмотреть фор- 
маты обмена служебной информацией между клиентом и сервером. Клиент 
в момент подключения к серверу должен сообщить ему свое имя. А сервер по- 
сле подключения или отключения клиента должен разослать всем клиентам 
скорректированный список участников чата. 

Пусть служебное сообщение клиента серверу будет оформляться в формате: 


<символ #><имя клиента> 


Таким образом, сервер сможет отличить это служебное сообщение от обычного 
информационного по наличию символа # в первой позиции. Узнав имя клиен- 
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та, сервер может включить его в список участников чата, рассылаемый всем 
клиентам. 
Служебное сообщение сервера клиенту будем строить по тому же формату: 


<символ #><список участников чата> 


Ограничимся таким протоколом обмена информацией. Нетрудно было бы 
расширить его, включив в информационное сообщение дополнительную ин- 
формацию о передаваемом двоичном файле. Но не будем усложнять этим наш 
пример. 

Теперь можно перейти к проектированию клиентского и серверного при- 
ложений. Этот пример имеется на прилагаемом к книге диске (группа проек- 
тов РОРЙогит). 

Начнем с разработки сервера (проект Ррйогит в группе проектов РОРйогит 
в каталоге РАогит на приложенном к книге диске). Его форма очень проста 
(рис. 9.6), так как никаких управляющих элементов в сервере не предусмотре- 
но. На форме размещены компонент ЗегуегЗосКеё и метка Эф$айеТехф, в кото-* 
рой отображается число клиентов, подключенных в данный момент к чату. 
В метке установлены свойства Ащфо$127е = {а15е, чтобы размер метки не опреде- 
лялся длиной текста, и АНептеп+ = фаСещег, чтобы текст располагался в цен- 
тре метки. В компоненте ЗегуегЗосКеё заданы ЭегуегТуре = $МопВюеК1шьх, 
что обеспечивает асинхронный обмен информацией, и Рог = 1024. 


м: 


Рис. 9.6 -` Сервер форума 


Серверное приложение чата во время выполнения 


| $ кяментов в сети _ 


Ниже приведен текст модуля серверного приложения. 


Т5Ег1паЬ15$е *0Озег$ = пем ТбЕг1па[Г15$%; 


Уу01А _ Еаз®са11 ТКГогш1:; :ГогиСгеаее (ТОБ)]есе *5епаег). 
{ . 
Зегуег5оскее1->АсЕ1уе = &гие; 
Озегз->Ааа ("Всем"); 


у014 __Еаз6са11 ТЕогм1: : Рогирезегоу (ТОр]ес®Е *5епаег) 
| 


Озегз->Егее (); 


’ \01А __Еаз®са11 ТКГогш1: : 5егуег5оскее1С11епВеаа ( 
| ТОБ)есе *5епаег, ТСазфкопИ1пбоскее *боскеф) 
{ 
Ап5156г1па 5 = боскеЕ->Весе1луеТех* (); 
1Е (5$[1] == '#') | 
// Регистрация на сервере 
{ 
Озегз->Ааа (5.5ар5Ег1па (2,5.тепаЕВ())); 
Бог (116 1= 0;1<бегуегбоске*1->5оскее->Асе1уеСоппес&1оп$ ;1++) 
Зегуег5оскее1->5оскее->Соппес®1оп$ [1] ->5епаТехе ( 
"#"+0Озег$->Тех*); 
Сфае1сТех*1->СарЕ1оп = 
Тре Тобехг (бЗегуегбоске®1->5оскее->АсЕ1уеСоппес*1оп$) + 
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" клиентов в сети"; 


гесагп; 
} 
Ап$15Ег1па 5ЗМаме = $.5а65ег1па (0, $.Роз("#") - 1); 
// Рассылка сообщения всем или конкретному адресату 
1Е (Апз1СопрагеТех® (5Матше, "Всем") == 0) 
Бог (1106 1= 0; 1 < ЗегуегбосКе&1->5оскеЕ->АсЕ1уеСоппес*1опз; 
1++) 


{ | 
// 1Е(5егуегбоскеЕ1->5оскеЕ->СоппесЕ1опз$[1] != боскеЕ) 


ЗегуегбоскеЕ1->боскеЕ->Соппесе1оп$ [1] ->бепаТехе ( 
$.ба65Ег1па (5Маме .ГепаеВ ()+2, $.Ъепаев())); 

} 

е1 зе 

{ 

Зегуегбоскее1->5боскеЕ->СоппесЕ1опз [ 
Озегз->ТпаехоЕ (5Маме) - 1]->5епаТехе ( 
5$. Зи65Ег1па (5Мате.Тепаев () + 2, 5.ЪепаеВ())).; 


У01А __ЕазЕса11 ТГогм1 : : бегуег5осКее1С11еп*01$соппесе ( 
ТОБ]есе *5бепаег, ТСизфошМ1пбоскее *боскеф) 
106 1; 
// Определение индекса разрываемого соединения 
Бог (1= О; 1<5егуегбосКе*1->5босКкКеЕ->Ас&1уеСоппес®1о0п1$;1++) 
_ 1Е (Зегхуегбоске&1->боскКее->Соппес®1оп$[1] == боскКеф) 
Ьгеак; 
// Вычеркивание из списка имени разрываемого соединения 
Озег5->0е1ефе (1+1); 
// Рассылка клиентам исправленного списка имен 
Еог (1= 0; 1 < ЗегуегбосКе&1->боскКее->Ас&1уеСоппесЕ1оп$ ;1++) 
1Е (бегуегбоскКее1->боскее->Соппес®1о0о1п$[1] != боскКеф) 
Зегуегбоске*е1->5боскеЕ->Соппес&1оп$ [1] ->бепаТехе ("#" + 
Озегз->Техе); 
// Корректировка надписи о количестве клиентов 
Сфаф1сТех*1->Сар®1оп =Тл®Тоб56к ( 
ЗегуегбоскКее1->5оскеЕ->Ас&1уеСоппес®1оп$ - 1) + 
" клиентов в сети"; 


У01А _ ЕазЕса11 ТКогш1: : 5егуег5осКкее1С11еп Егкгох ( 
.ТОБЗесе *5епаег, ТСизеопИ1пбоскее *боскеф, 
ТЕггогЕхепе ЕггогЕуеп®, 106 &ЕггогСоае) 
{ 
зм1ЕСЬ (ЕггогЕуеп*) 


{ 


.сазе еебепа: ЗПомМеззасде ("Ошибка записи сообщения"); 
Ьгеак; 

сазе ееВесе1уе: ЗПпомМеззасде ("Ошибка чтения сообщения"); 
Бгеак; 

сазе ееСоппесс: ЗпомМез5асде ("Ошибка открытия соединения"); 
ргеак; 

сазе еер15соппес®: ЗпомМеззасде ("Ошибка закрытия соединения"); 
Ьгеак; 

сазе ееАссере: 5помМез5асде ("Ошибка доступа"); 
Ьгеак; 

сазе еебепега1: ЗПомМезз5асве ("Ошибка соединения"); 


} 


ЕггогСоае = 0; 


} 
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Рассмотрим приведенный код. В нем введена глобальная переменная Оз$ег$ 
типа Т5%&г1те1Т156, которая содержит список активных клиентов. Объект этого 
списка сразу же создается при его объявлении оператором пем. В функции 
ЕогтСгеа{е — обработчике события формы ОпСгезфе в список заносится одна 
строка с текстом “Всем”. При завершении приложения список Озег$ уничтожа- 
ется в функции ЕогтОе$@гоу — обработчике события формы Оп)ез®тоу. 

Основная функция модуля — Зегуег5осКе 1СПеп{Веа4, являющаяся об- 
работчиком события ОпСПешВеа4 компонента Зегуег5оске{& 1. Она читает пе- 
реданное сообщение клиента. Параметр ЗосКеё — это сокет клиента, передав- 
шего сообщение. Первый оператор обработчика заносит методом ВесетуеТех& 
текст сообщения в строковую переменную 5. Затем проверяется, не равен ли 
первый символ сообщения символу "#”. Если равен, то, как мы решили ранее 
при разработке протокола обмена, пришло служебное сообщение в момент ус- 
тановки соединения с новым клиентом. В этот момент новое соединение уже 
включено последним в свойство’ Эегуег5осКе{ 1—>Зоске—>СоппесНоп$, со- 
держащее список всех активных соединений. _ 

Регистрация на сервере нового клиента сводится к следующему. Имя но- 
вого клиента, содержащееся в сообщении после символа #, выделяется мето- 
дом Зи итше и заносится в конец списка имен клиентов Оз$ег$. Затем в цик- 
ле осуществляется итерация по всем соединениям, хранящимся в свойстве 
Зегуег5осКке{ 1->$ЗосКе1—>Соппес{10п$. Каждому клиенту (в том числе и толь- 
ко что присоединившемуся к чату) посылается служебное сообщение, начи- 
нающееся с символа #, после которого передается содержимое (свойство Техф) 
списка Озег$. В заключение в метке, расположенной на форме сервера, отобра- 
жается новое число активных клиентов. На этом обработка сообщения завер-‹ 
шается. 

Если выясняется, что пришедшее сообщение не служебное (первый сим- 
вол не равен #), то обработка его начинается с чтения в переменную Мате 
имени адресата — всех символов до символа #. Полученное имя сравнивается 
с шаблоном “Всем”. Если сообщение предназначено всем клиентам, то далее 
оно, усеченное на длину имени адресата, в цикле передается всем активным 
клиентам так же, как было рассмотрено выше. Если вам хочется передавать 
сообщение всем, кроме себя самого, то нужно просто разкомментировать выде- 
ленную жирным шрифтом строку. В этом случае прежде, чем переслать сооб- 
щение, будет проверяться, не является ли соединение тем самым, которое пе- 
редало сообщение. Это позволяет передать сообщение всем клиентам, кроме 
того, кто сам его послал. 

Если сообщение направлено не всем, а конкретному адресату, то в списке 
О5ег$ методом Т4ехОЁ ищется индекс этого имени. Поскольку в списке пер- 
вым идет имя “Всем”, то индекс искомого соединения в массиве Зегуег- 
ЗосКе{1.ЗосКе{.СоппесНоп$ на 1 меньше найденного индекса. Соединению 
с этим индексом и пересылается сообщение. 

Функция ЗегуегЗосКе 1СПеп{ О 15соппес{ является обработчиком события 
сервера ОпСПеп 0 15$соппес$, наступающего, если клиент разорвал соединение 
методом (С1о5е или любым другим способом — например, ‘просто закрыл кли- 
ентское приложение. При событии ОпСЦеп{О1$соппес& разрываемое соедине- 
ние еще не вычеркнуто из массива Зегуег5осКе 1—>5ЭоскКе—>Соппесйоп$. 
Поэтому поиском в этом массиве, осуществляемым первым циклом Фог, можно 
найти его индекс, сравнивая каждое соединение с разрываемым (оно передано 
в обработчик параметром ЗосКеф). После определения индекса разрываемого 
соединения его имя вычеркивается из списка имен Озег$ (напомним, что ин- 
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дексы этого списка на 1 больше индексов массива Соппес#йоп$). Затем циклом, 
аналогичным рассмотренным ранее, всем клиентам, кроме вычеркиваемого, 
рассылается новый скорректированный список имен. В заключение изменяет- 
ся надпись метки, оповещающей о числе активных клиентов. 

Функция ЗегуегЗосКе{ 1СПев( Еггог является обработчиком события Оп- 
СПешЕггог компонента ЗегуегосКе{1. Это событие и его обработка уже рас- 
сматривались в разд. 9.5.1. 


Перейдем теперь к разработке клиентского приложения (проект РСПепёв 
группе проектов РСРЙогит в каталоге РАогит на приложенном к книге дис- 
ке). Его форма во время выполнения показана на рис. 9.17. 

На форме размещен компонент СЦеп{ ЗосКеф. В его свойство АЯ@ге$$ зане- 
сено значение 127.0.0.1, озвачающее, что приложение будет отлаживаться на 
вашем компьютере, на котором будут выполняться и клиентские, и серверное 
приложение. При работе в сети в свойствах А@а@гез$ или Но$ должен быть 
указан адрес компьютера, на котором будет разворачиваться сервер. Впрочем, 
всего это можно не делать, так как мы увидим далее, что адрес сервера будет 
у нас устанавливаться программно. Номер порта установлен тот же, что в сер- 
верном приложении — 1024. Свойство СНепТуре равно се М№опВюсЕшх, что 
означает асинхронную работу. 


Рис. 9.7 '.-^ Клиент форума 
Клиентское приложение РИ | 


г аи ака зальвым 
1 


‚Окно отправляемого сообщения 


чата во время в Соединение 


Кто _ И 
[Начальник | 


Странно. а я получаю зарплату 


выполнения каждый месящ! 


Окно принятых сообщений 
Начальник: Ваши замечания по работ 
Цех 1: Нам не платили зарплату 1 ме 
Цех 2: Нам не платили зарплату 2 мес 
Цех 3: Нам не платили зарплату 3 ме 
Цех 4: Нам не платили зарплату 4 месяца 


В левом верхнем углу формы размещено окно ВаеВЕЗЧЕЫ (его имя ВаеВ- 
ЕЗНТ), предназначенное для записи передаваемого сообщения. В нижней час- 
ти формы расположено окно Вас ВЕЯЦ (его имя ВлеВЕЯЕ2), в котором будут по- 
являться переданные данному клиенту сообщения. В правом верхнем углу 
формы размещена кнопка Зреед4ВиЙоп с именем ВСоппес&. Ее назначение — 
устанавливать и разрывать соединение с сервером. В кнопке задано свойство 
СгоиршФех = 1, чтобы при нажатии на нее она устанавливалась в нажатом со- 
стоянии, и свойство АПомАПОр равно фгие, чтобы при нажатии на утоплен- 
ной кнопке она освобождалась. 

Ниже расположена панель СгоипрВох, содержащая два окна редактирова- 
ния ЕЦ, выпадающий список СошфоВох и кнопку ВиЙоп. Окно с именем 
ЕЗегуег предназначено для задания [Р-адреса сервера. В него занесено значе- 
ние 127.0.0.1, означающее локальную работу сервера на том же компьютере, 
на котором выполняется клиент. Во время выполнения пользователь может 
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заменить этот адрес адресом удаленного сервера. Окно, названное в программе 
Е\М/Во, предназначено для задания имени клиента, под которым он будет из- 
вестен остальным участникам чата. Во время выполнения перед тем, как уста- 
новить соединение с сервером, пользователь должен указать свое имя в этом 
окне. Выпадающий список, имеющий имя СВТо\М Вот, будет отображать спи- 
сок имен активных клиентов чата, а его первой строкой будет "Всем". Посы- 
лая сообщение, пользователь должен выбрать в этом списке адресата, которо- 
му направляется сообщение. Кнопка Отправить (ее имя в программе — В$еп9д) 
отправляет сообщение. 
Ниже приведен код функций данного клиентского приложения. 


у01А __ЕазЕса11 ТЕогш1: :ВСопес®С11скК (ТОБ]есеЕ *5епаег) 
{ 
1Е (ВСопес&->Вомп) 
{ 
1Е ((Ебегуег->Техе == "") || (ЕМРо->ТехЕ == "")) 
{ 
ЗРомМеззаде ("Не задан ТР или имя"); 
гебагп; 
} . 
1Е ( (10% (Ебегуег->ТехЕ[1])>=48) && (10% (Ебегуег->Тех® [1])<=57)) 
С11епЕбосКее1->Ааагезз$ = Ебегуег->Техе; 
е15е С11епебоскКеЕ1->Ноз$е = Ебегуег->Техе; 


фгу 

{ 

ТЕ (!С]1епе5оскеЕ1->АсЕзуе) 
С11епё5боскее1->Ореп (); 

} . 
саёсй (...) 
{ 


ЗРомМеззасде ("Невозможно установить соединение с сервером"); 
ВСопесе->ромп = Еа1$е; 
} 


} 
е1з5е С11епЕбосКеЕ1->С1о5е (); 


у01А __Еазеса11 ТГогм1: :С11епебоскеЕ1Соппес® (ТОБ)ес® *5епаег, 
ТСазбопИ1пбоскее *5оскеф) 


С]11епЕбоскКе*1->боскКеЕ->бепаТехе ("#"+ЕМПо->Тех*); 


у01А __ Еаз®са11 ТЕогм1 ; :С11епебоскее1Еггог (ТОБ)есе *5епаег, 
ТСизсопМ1пбоскее *боскКеф, 
ТЕггогЕуепе ЕггогЕхепе, 1п0е &ЕггогСоае) 
{ 


$м1 СВ (ЕгкохЕуепф) 


{ 


сазе еебепа: 5поиМеззасе ("Ошибка записи сообщения"); 
ргеак; 

сазе.ееКесе1уе: ЗПомМеззасде ("Ошибка чтения сообщения"); 
Бгеак; 

сазе ееСоппесь: ЗРомМе5засде ("Ошибка открытия соединения"); 
Ьгеак; 

сазе еер15зсоппес®: ЗРомМеззаае ("Ошибка закрытия соединения"); 
Ьгеак; 

сазе ееАссере: ЗРромМеззаде ("Ошибка доступа"); 
Ьгеак; 


сазе еесепега1: ЗПомМеззасде ("Ошибка соединения"); 
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|] 
|) 


ЕггогСоае 


у01А __Еаз®са11 ТЕКогм1: :С11епёбосКкее1Веаа (ТОр)]есЕ *5епаекг, 
ТСизфойИ1пбоскее *боскКеф) 

{ 

1Е (!Арр11са®1оп->АсЕ1уе) 
Т1мег1->Епаб1еЯ=Егае; 

Ап$15Ег1па 5 = боскее->Весе1уеТехе (); 

ТЕ ($[1] == "'#') 

{ 
СВТоМПоп->Теемз->ТехЕ = $.5а65ег1па (2,5.тепаеН ()-1 ); 
СВТо\Попт->ТвепТпаех = СВТо\Попм->ТЕептз->Сойп® - 1; 


гегагп; 
} 
Ап5156г1па 5ЗМате = $.ба556г1па (0, 5.Роз ("+") - 1); 
В1свЕа1*2->Ь1пе5->ААа (5Маме + ": " + | 
5. зирбЕк1па (5Маме.ТЪепаеВ ()+2, $5.ЪепаеВ())); 
} 
ннннннннннннннннннннннннн--==-==-========--=- 


У01А __ЕазЕса11 ТКогш1: :ВбепаСс11скК (ТОБ]есе *5епаег) 
{ . 
1Е (!С11епебоскКе*1->АсЕ1уе) 

{ 


ЗВомМеззаде ("Нет активных пользователей"); 
гебсагп; 


} 
1Е ( (10% (Ебегуег->Тех® [1])>=48) && (1п0Е (Ебегуег->Техе [1] )<=57)) 
С11епЕбоскеЕ1->Адагезз = Ебегуег->Техк; 
е15е С11епЕбосКкКе*1->Ноз+ = Ебегуег->Тех%; 
С11епебоскКеЕ1 ->5оскеЕ->ВесезуеЪепаеВ (СВТо\Том->Техе +"#" + 
ЕМВо->ТехЕ + "#" +В1срЕа11->Техе); 


у01А __Еазеса11 ТРГогм1: :Т1мег1Т1мег (ТОБ)]есЕ *5бепаег) 


{ 
Е] аз \М1паом (Арр]11са*1оп->Напа1е, Е гие); 


\01А __Еазса11 ТРогм1 : :Арр11са&1опЕуеп$1АсЕ1уаее (ТОБ]есЕ *5епаег) 
{ 


Т1мег]1->Епаб1еа = ЁЕа15е; 


} 


Рассмотрим основные функции приведенного кода. Функция ВСоппесёСПсЕ 
является обработчиком щелчка на кнопке ВСоппес{. Если после щелчка кнопка 
нажата (ВСоппесё—>Оомп = фгие), значит надо устанавливать соединение с сер- 
вером. Прежде, чем устанавливать соединение, в функции проверяется, заданы 
ли адрес сервера и имя клиента в окнах ЕЗегуег и Е\”Юо. Если не заданы, поль- 
зователю выдается предупреждение и соединение не устанавливается. 

Если адрес и имя заданы, то анализируется текст в окне ЕЗегуег. Если 
текст начинается с цифры, то полагается, что задан ТР-адрес сервера и соответ- 
ствующее значение заносится в свойство СПеп{$осКе{1-—> А99ге$$. В против- 
ном случае полагается, что задан ОВГ, и соответствующее значение заносится 
в свойство СПешЗосКке 1 -—>Ноз$$. После этого, если соединение надо открыть 
(свойство АсЙйуе компонента СПешЗосКе{1 равно Ё#Ёа]5е), оно открывается ме- 
тодом Ореп. При этом блок фгу ... еаеВ отлавливает исключение, связанное 
с невозможностью установить соединение. 
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Если в начале выполнения функции обнаруживается, что кнопка ВСоп- 
пес{ переключилась в ненажатое состояние, это означает разрыв соединения. 
В этом случае соединение разрывается методом СТ]озе. 

Функция СЙеп ЗосКе{1Соппес& является обработчиком события ОпСоп- 
песф компонента СНешоесКе{ 1. Это событие наступает при окончании уста- 
новки соединения. Функция посылает серверу методом СПеп$осКе1->5$ос- 
Ке+—>5Зеп4Техё служебное сообщение, содержашее символ “"#” и имя клиен- 
та, заданное в окне Е\Ьо. 

Функция СНешЗосКе1Еггог является обработчиком события ОпЕггог 
компонента СНешЗоске 1. Это событие и его обработка уже рассматривались 
в разд. 9.5.1. - 

Функция СНешЗосКе1Веа является обработчиком события ОпВеа@ 
компонента СПНеп{ЗосКе{1. В функции производится обработка полученного 
сообщения. Первый оператор обработчика активизирует таймер, который 
в свою очередь активизирует мигание пиктограммы приложения в панели за- 
дач (см. разд. 5.2.5). Это сделано для того, чтобы пользователь обращал внима- 
ние на то, что пришло новое сообщение или пришел новый пользователь, если 
приложение работает в фоновом режиме. Следующий оператор заносит текст 
сообщения, хранящийся в свойстве ЗоскКе{—>ВесехеТехф$, в строковую пере- 
менную Ъ. Затем проверяется, не равен ли первый символ сообщения символу 
"+". Если равен, то пришло служебное сообщение сервера, содержащее новый 
список имен активных клиентов. Этот список, за вычетом первого символа, за- 
носится в выпадающий список адресатов СВТо\’Вош, а индекс этого списка 
устанавливается на последнюю запись. Затем обработчик завершает работу 
оператором геигп. 

Если пришло не служебное, а информационное сообщение, то в перемен- 
ную Маше читается имя клиента, отправившего сообщение. После этого 
в окно ВаеВЕЗИН2 добавляется строка вида "имя : сообщение”. 

Функция ВЗепдаСЦсК является обработчиком щелчка на кнопке Отправить. 
В начале функции по свойству СЦПеп{$осКе{1-—>АсйИуе проверяется, является 
ли сокет активным. Если нет, то пользователю выдается предупреждение и со- 
общение не отправляется. Если же сокет активен, то, как и в функции 
ВСоппесё СПсК, заносится адрес сервера и методом Зеп4Тех{ посылается сооб- 
щение в формате, который мы рассматривали ранее. 

Остальные функции связаны с организацией мигания пиктограммы при- 
ложения в панели задач и подробно рассмотрены в разд. 5.2.5. 

Мы рассмотрели коды серверного и клиентского приложений. Можете ис- 
пытать эти приложения в работе. Для этого надо запустить из У/т4о\з один 
экземпляр сервера, несколько экземпляром клиентов и проверить возможно- 
сти чата во всех режимах. 

Нетрудно было бы расширить приложение созданного чата, включив 
в него возможность обмена файлами с помощью описанных в разд. 9.5.1 мето- 
дов Эепд $ {геат, Зеп9 5 {геатТВепОгор, ЗепаВо?. Думаю, что читатель при 
необходимости легко это сделает. 


9.4.5 Пример организации взаимодействия 
приложений — "Морской бой" 


В разд. 9.5.4 был рассмотрен пример чата, в котором обмен информацией 
между клиентами сводился просто к передаче и отображению текстов. В дан- 
ном разделе мы расширим возможности этого чата, обеспечив возможность бо- 
лее тесного общения приложений (группа проектов РСОРАогит2 в каталоге 
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Рйпогит на приложенном к книге диске). Обмен информацией по-прежнему бу- 
дет текстовый, но эта информация будет использоваться для управления при- 
‘ложениями. 

За основу возьмем игру "Морской бой". В разд. 6.7.3 уже рассматривалось 
подобное приложение. Но там обмен информации происходил через общий 
файл. А в данном разделе мы будем использовать сокеты. Задачу поставим 
так. Сервер, описанный в разд. 9.5.4, дополним возможностями, связанными 
с формированием пар игроков и поддержкой общения между ними (проект 
Ррйогит2 на приложенном к книге диске). Клиентское приложение РСПепф, 
разработанное в разд. 9.5.4, оставим без изменения. Так что пользователи, ис- 
пользующие РСЦепф, смогут общаться в чате так же, как это делали с прежним 
сервером. А для игры "Морской бой" создадим новое клиентское приложение 
(проект Р5еа\'аг2 на приложенном к книге диске), работающее с модернизи- 
рованным сервером. За основу этого клиентского приложения возьмем мо- 
дуль, описанный в разд. 6.7.3, но общение через файл заменим в нем общени- 
ем через сокеты. 

Схема организации игры выглядит следующим образом. Пользователи мо- 
гут общаться через запущенный сервер Ррйогит2 так же, как был описано 
в разд. 9.5.4. Если кто-то хочет начать игру "Морской бой", он должен запус- 
тить приложение Рбеа\’ат2.ехе. В первый момент он увидит окно приложе- 
ния, показанное на рис. 9.8. В окне [Р адрес (его имя в приведенном далее коде 
ЕЗегуег) пользователь должен указать [Р-адрес или сетевое имя компьютера, 
на котором выполняется сервер. Если сервер выполняется на том же компью- 
тере, на котором запущено клиентское приложение, можно указать адрес 
127.0.0.1. В окне Кто (Е\ Бо) надо указать произвольное имя, под которым иг- 
рок будет зарегистрирован на сервере. После того как окна будут заполнены, 
пользователь должен нажать кнопку Вызов на бой (ВСаП). 


Рис. 9.8 

Окно проекта 
Р5еа\//аг2, 
обеспечивающее 
вызов противника — о и 
на бой ие . И Кто 


` Е. И _ . [пусотриег [Чемпион 


Запрос клиента передается на сервер, который ведет списки участников 
чата и игроков. Сервер проверяет, нет ли уже в списке игрока с тем же именем. 
Если есть, то может возникнуть путаница при общении игроков. В этом случае 
сервер посылает клиенту соответствующее предупреждение, и пользователь ви- 
дит сообщение: "Указанное Вами имя уже имеется. Смените имя”. Тогда игрок 
должен изменить текст в окне Кто и повторно послать вызов на бой. 

Если сервер определил, что имя игрока уникально, он проверяет, нет ли 
зарегистрированного вызова на бой, для которого еще не появился партнер. 
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Если такого вызова нет, то пользователь видит сообщение: "Вызов послан, но 
соперника пока нет. Ждите!". При этом всем участникам чата от имени игрока 
рассылается сообщение: “Вызываю на 'Морской бой’. Принимающий вызов 
должен запустить 'Ббеа\УУаг2.ехе’". Если кто-то хочет принять вызов, он дол- 
жен запустить на своем компьютере программу ЗеаЙаг2.ехе (при отладках это 
может быть тот же самый компьютер, на котором запущено первое клиентское 
приложение). Можно было бы, конечно, предусмотреть в клиентском прило- 
жении чата соответствующую кнопку, при щелчке на которой выполнялась бы 
программа ЗеаЙ\'’аг2.ехе. Но мне не хотелось из-за такой мелочи изменять раз- 
работанное в разд. 9.5.4 клиентское приложение РСПепё. 

Когда кто-то ответил на вызов, заполнил в своем приложении требуемые 
окна и щелкнул на кнопке Вызов на бой, сервер объединяет игроков в пару. 
При этом игроку, пославшему вызов первым, посылается сообщение: “Вызов 
принял ...”, а ответившему на вызов — сообщение: “Вы играете с ...”. Вместо 
многоточий в этих сообщениях записываются имена игроков. 

На этом подготовка к матчу заканчивается. Клиентские приложения обо-. 
их игроков приобретают вид, показанный ранее на рис. 6.12 а в гл. 6. Оба иг- 
рока размещают свои корабли. Тот, кто разместил раньше, получает право 
первого хода. Когда оба соперника разместили свои корабли, начинается игра 
(рис. 6.12 6). Она практически ничем не отличается от рассмотренной 
в разд. 6.7.3. Единственное отличие — один из партнеров может закрыть свое 
приложение до окончания игры. Это расценивается как сдача, так что остав- 
шемуся игроку посылается сообщение о сдаче противника и поздравление 
с победой. 

Теперь надо разработать протокол, обеспечивающий описанные возможно- 
сти. Часть этого протокола, связанная с обслуживанием чата, уже была пред- 
ложена в разд. 9.5.4. Напомню форматы сообщений. 

Запрос на сервер о регистрации нового клиента чата имеет формат: 


#<имя клиента> 


Сообщение от клиента, переданное серверу для пересылки другому клиен- 
ту чата имеет формат: 


<имя адресата>#<имя автора>#<текст сообщения> 


Если имя адресата равно “Всем”, то сообщение должно быть передано всем 
клиентам. 

Два указанных формата применяются при передаче сообщений от клиента 
чата серверу. Сообщения от сервера клиенту чата имеют два формата. Формат 


<имя автора>#<текст сообщения> 


используется для передачи текстового сообщения. А формат 


#<список участников чата> 


используется для передачи текущего списка клиентов чата. 

Теперь дополним этот протокол форматами, передаваемыми от клиен- 
тов-игроков серверу. Запрос на сервер о регистрации нового клиента-игрока 
пусть имеет формат: 


#^<имя клиента> 


Этот формат отличается от формата регистрации клиента чата наличием сим- 


вола . Так что имена клиентов чата не должны начинаться с этого символа 
(впрочем, кому же придет в голову так себя назвать). 
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Сообщения, которые игрок пересылает на сервер для последующей переда- 
чи партнеру, пусть имеют формат: 


<имя клиента-автора>#^<текст сообщения> 


Чтобы отличить это сообщение от описанного ранее сообщения участника 
чата, надо придерживаться указанного ранее правила: имена клиентов чата не 
должны начинаться с символа ”^". Получив подобное сообщение, сервер сам 
определят имя партнера данного игрока и пересылает клиенту партнера толь- 
ко текстовое сообщение, следующее за символом “^". 

Вот собственно и весь простенький протокол обмена информацией между 
сервером и клиентами. Теперь надо договориться о формате текстовых сообще- 
ний, которые может принимать клиент-игрок. Тут будут использоваться два 


формата. Формат 


О<текст> 


будет применяться при получении от сервера строки текста, которую клиент 
просто должен отобразить в окне редактирования. А формат, по которому бу- 
дут передаваться команды клиенту, имеет вид: 


<код> <х> <у> 


Этот формат содержит три числа, записанных в текстовом виде и разделенных 
пробелами. Первое число — код команды, а два других числа — координаты 
очередного хода игрока. Обмен подобной информацией межу игроками по- 
дробно рассмотрен в разд. 6.7.3. Но в данном случае коды команд будут отли- 
чаться от принятых в разд. 6.7.3. Во-первых, нам теперь не требуется разли- 
чать команды, поступающие от первого и второго игроков: сервер сам направ- 
ляет сообщение тому клиенту, которому оно предназначено. А во-вторых, в на- 
шем клиентском приложении будут некоторые команды, отсутствовавшие ра- 
нее. Ниже приведена таблица кодов команд: | 


Значение кода 


Противник готов к игре. 


Сообщение о ходе противника. 


Сообщение “мимо” в ответ на сделанный ход. 


Сообщение ранил в ответ на сделанный ход. 
—Е___[—[д5д5———[ЫыЫ—— 
_| Сообщение “убил” в ответ на сделанный ход. 


Противник закрыл свое приложение (сдался). 


Указанное имя игрока уже есть в списке, надо задать новое имя. 


Теперь рассмотрим коды приложения. Начнем с проекта сервера. Внешне 
наш сервер не будет ничем отличаться от разработанного в разд. 9.5.4 и пока- 
занного на рис. 9.6. Но код приложения несколько сложнее приведенного ра- 
нее за счет операций с клиентами-игроками. 

Т5Ег1п1911$е *Озег$ = пем Т56ег1п91156; 


Т5Ег1п911$6 *беаМаг1 = пем Т5Ег1п9115$6; 
15611091156 *беаМаг2 = пем Т5Ег1п9115%; 


Уу01А __Еазеса11 ТРГогм1 : :5екуегбоске®1С11епВеаа ( 
ТОБ]ес® *бепаег, ТСазбомИ1пбоскее *боскеф) 


{ 
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Апз15Ег1па бМапе; 
Ап$156г1зпа 5 = боскее->ВеселуеТех® ()}; 
ТЕ (5[1] == '#') 
// Регистрация на сервере 
{ 
1Е($[2] == '^') /И/ Регистрация игрока в "Морской бой" 
{ | 
ЗМаме = $.5а65Ег1па (3,5.тепаеР ()); 
.1Е (Озегз->ТпаехоЕ ("^" + $5Маме) >= 0) 
{ // имя уже есть в списке 
бЗоскеЕ->5епаТехе ("7 0 0"); 
гебатп; 
} | 
Озегз->Ааа ("^" + $5Мапе); 
Рог (1пе 1=0; 1 < беаМаг2->Сойцп®; 1++) 
1Е (ЗеаМаг2->5&г1па$[1] == "") // Имеется непринятый вызов 


{ 
ЗеаЙаг2->5Ех1п4$[1] = Мате; 
ЗегуегбоскеЕ1->5боскее->СоппесЕ1опз [ 
Озегз->ТпаехоЕ ("^" + 5Мапе)-1]-> 
ЗепаТех* ("ОВы играете с """ + 
ЗеаМах1->5Ех1паз[1] + """."); 
бЗегуегбоскее1->5оскКее->Соппесе1оп$ [ 


Озегз->ТпаехоОЕ ("^" + беаМах1->5%г1па$[1]})-1]-> 


бепаТехф ("ОВызов принял """ + 
беаМаг2->5Ег1па9$[1] + """."); / 
ЗсаЕ1сТех+1->Саре1оп = 
Тре Тобег (бегуегбоскее1->5оскеЕ->Асе1уеСоппес®1о0п$) + 
" клиентов"; 
гебагп; 
} 
// Непринятого вызова нет 
ЗеаЙМаг1->Ааа (5Маме); // Регистрация нового вызова 
ЗеаЙаг2->Ааа (""); 
ог (1пЕ 1=0;1<5егуег5оскКе&1->5оскеЕ->АсЕ1уеСоппес®1о0п$;1++) 
{ 
1Е (Озегз->56г1па$ [1+1] [1] != '^') 
Зегуегбоскее1->5боскее->СоппесЕт1оп$ [1] ->5епаТехе ( 
ЗМаме + "#Вызываю на 'Морской бой'." 
" Принимающий вызов должен запустить 'беаМаг2.ехе'."); 
} 
} 
е]1 зе ИХ Регистрация участника чата 
{ 
Изег5->Ааа (5.5656 г1па (2,5.Тепафь ())); 
// временный список, не включающий игроков 
Т5$Ег1109Ь1$е *ТшрЬ1$Е = пем Т56г11911$%; 
ТирЬ1$6->Аз$1ап (Озегз); 
Рог (106 1=1; 1<ТтрЬ1$е->СойипЕ ;1++) 
1Е (ТтрЪ1$*->56г1п9$ [1] [1] ==\ '^') 
ТирГ1$6->ре1ефе (1); 
// рассылка нового списка 
Рог (116 1=0;1<бегуегбоскее1->боскее->АсЕ1уеСоппесе1о0оп$;1++) 
1Е (Озегз->56г1па$ [1+1] [1] != '^') // если не игрок 
Зегуегбоскее1->5оскее->СоппесЕтоп$ [1] ->5епаТехе ( 


"#"+ТпирЪ1$е->Техё); 
Че1ефе ТпрГ15$%; 


} 
ЗЕае1сТехЕ1->Саре1оп = 


То ТобеЕг (Зегуегбоскее1->босКкКее->АсЕ1уеСоппес*1о0оп$) + 


" клиентов в сети"; 
гефагп; 


} // конец регистрации 
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5.Роз ("+") - 1); 
'^') // Сообщение от игрока 


ЗМаме = $.бар5Ег1па (0, 
12 ($[$.Роз("#") + 1] = 
{ 

Еог (106 1=0; 1 < ЗеаМаг1->Сопп®; 1++) // Поиск партнера 


{ 
1Е (ЗеаМаг1->56г1п9$5[1] == СМапще) 


{ 
Зегуегбоске®1->боскее->СоппесЕ1топ$ [Озегз->ТпаехоЕ ( 
"^" + ЗеаМаг2->5Ег1па$[1])-1]->5епаТехе ( 


$. ЗирбЕг1 па (5Маме.ТепаеВ (}+3, 5.тепаеь ())); 


гебагп; 


} 


1Е (ЗеаМаг2->$5%г1п9$5[1] == ЗМапте) 


{ 
Зегуегбоскее1->боскеЕ->Соппесе1оп$ [0 5ег5->ТпаехоЕ ( 
"^" + беаМаг1->5%г1па$ [1] )-1] ->5епаТехе ( 


5.50556 г1па (5Маме.Гепаеп ()+3, $5.тепаеВ())); 


гебагп; 
} 

гегагп; 
} . 
} // Конец обработки сообщения от игрока 
// Рассылка сообщения всем или конкретному адресату 


1Е (Апз1СопрагеТехф ($Маме, "Всем") == 0) 
Еог (110% 1=0;1<бегуегбоскее1->боскее->АсЕ1уеСоппес®1о0п$;1++) 
{ 
1Е( (Зегуегбоске&1->боскКее->Соппес*1о0оп$[1] != Зоскее) && 
(Чзег5->56г1па$ [1+1] [1] != '^')) 


Зегуегбоске*1->5оскКее->СоппесЕ1оп$ [1] ->бепаТехеЕ ( 
.5.зар5ег1па (5Мате .ЪепаеВ ()+2, $5.Ъепаев())); 


} 


е1зе 

{ 

Ап$15Ег1па 51 = $5.бирбеглпа (5Маме.Гепаев() + 2, 5.1епаеВ()); 
бегуегбоскКее1->боскеЕ->СоппесЕ1оп$ [О05егз->ТпаехоЕ (5Мапе) -1] 


->бепаТехеЕ (5.ЗарбЕг1па (5Маме .Тепаер () + 2, $.1ерпаёвВ ())); 


// 
у01А __Газ®са11 ТГогш1:; : 5егуегбоскее1С11еп01$зсоппесе ( 
ТОБ]есе *бепаег, ТСазфбошИ1пбоскее *боскКеф) 


{ 


108 110; 
// Определение индекса разрываемого соединения 
1п<бегуегбоскКе*1->боскеЕ->Ас&1уеСоппес®1о0п1п$; 11п++) 


Еог (1п1=0; 
1Е (ЗегуегбоскКе*1->боскеЕ->Соппес®1оп$[1п] == боскеф) 


ргеак; 
1Е(1п < Озег$->Сойип® - 1) // Если клиент есть в списке 
{ 
// Вычеркивание из списков имен разрываемого соединения 
1Е (Озегз->56г1па$ [110+1] [1] '^') /И/ если имя игрока 


{ 
= Озег$->бЕг1па$ [110+1] .За55Ег1пча (2, 


Ап5156г1па ЗМапте 
Бог (118 1па=0; 1па < ЗеаМаг1->Сочп Е; 1па++) 


{ 


256); 


1Е (беаМаг1->5Ег1па$ [11а] == ЗМапме) 


{ 
+ 


Озег5->Ое1ефе (Ч5ег5->ТпаехоЕ ("^" 
беаМаг1->5%г1п9$ [1па])); 


"= "") 


1Е (ЗеаМаг2->56г1па$ [1па] 


{ 
Зегуегбоскее]1->5оскеЕ->СоппесЕ1оп$ [0 5егз$->Тпаехоьрд ( 
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"^" + ЗеаМаг2->5%&х1п93 [1па]) -1] ->5епаТехе ( 
"б 0 0") ; 
Озегз->ре1ефе (Озег$->ТпаехоЕ ("^" + ыы 
ЗеаМаг2->5Ег1па$ [1па])); 
} 
ЗеаМаг1->ре1ефе (1па); 
ЗеаМаг2->Пе1ефе (1па); 
Бгеак; 
} 
е1зе 1Е (ЗеаМаг2->5Ег1паз[1па] == 5Маще) 
| | 
Озегз->ре1еке (Озег$->ТпаехОЕ ("^" + 
ЗеаЙаг2->5Ег1па$ [1па])); 
1Е (ЗеаМаг1->5&г1паз$[1па] != "") 
{ 
бег\уегбоскКек1 ->5оскее->СоппесЕ1оп$ [Озегз->ТпаехоОЕ ( 
ил" + беаМаг1->5Ег1па3 [11а] )-1]->5ератехе ( 
"б 0 0") ; , 
Озег$->0е1еке (Озегз->ТпаехоЕ ("^" + 
ЗеаМаг1->5&г1паз$ [1па])); 
} 
ЗеаМаг1->Пе1ефе (1па); 
беаЙаг2->Пе1ете (1па); 
Бгеак; 
} 
} 


} // Конец обработки имени игрока 
е1зе // Имя участника чата 
{ 
// Временное сохранение списка 
Т5Ег1п91$6 *Ттр1$6е = пем Т5Ег1па113%; 
ТирЬ1$Е->А$$51ап (0зег$); 
ТирЬ1$6->ре1ефе (1п+1); 
// Рассылка клиентам исправленного списка имен 
// Временный список, не включающий игроков 
Бог (116 1=1; 1<ТмрЬ1$е->СоопЕ ;1++) 
1Е (ТмрЬ1$е->5Ег1па$ [1] [1] == '^') 
ТирЬ1$+->ре1еке (1); 
// Рассылка нового списка 
Еог (1пЕ 1=0;1<бегуегбоскКеЕ1->5осКее->АсЕ1уеСоппес®1о0п$;1++) 
1Е ( (Зегуегбоске*1->5осКее->Соппес®1оп$[1] != боскеф) && 
(Цзегз->56г1па$ [1+1] [1] 1!= '^')) 
бегуегбоске&1->боскКее->Соппес+1оп$ [1] ->бепаТехе ( 
"#"+Тирт1$6->Техе); 
Че1ефе Тпр115$%; 
// Удаление имени из списка Изег$ 
Озегз->ре1ефе (1п+1); 
} // Конец обработки участника чата 
} // Конец обработки клиента в списке 
// Корректировка надписи о количестве клиентов 
ЗЕаф1сТех*1->Сарё1оп = 
Трое Тобег (ЗегуегбосКкКе*1->5босКеё->Ас&1уеСоппес*1оп$ - 1) 
+ " клиентов"; 


‚® \У01А __Еаз&са11 ТЕГогм1 : : 5егуег5оскее1С11еп%Еггог ( 
ТОБ]есЕ *Зепаег, ТСизбопИ1пбоскее *боскКек, 
ТЕггогЕуепе ЕггогЕуепе, 1пе &ЕггогСоае) 
{ 
$м1Е СВ (ЕггогЕуеп® ) 
{ | 
сазе еебепа: ЗРомМеззааде ("Ошибка записи сообщения"); 
Бгеак; 
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сазе ееВесе1уе: ЗромМеззасде ("Ошибка чтения сообщения"); 
Бгеак; 
сазе ееСоппесе: 5помМеззаде ("Ошибка открытия соединения"); 
Бгеак; 
сазе еер15$соппесе: $ЗПомМеззаае ("Ошибка завершения соединения"); 
Бгеак; 
сазе ееАссерф: эпоиМеззасде ("Ошибка доступа"); 
БгеакК; 
сазе еебепега1: ЗПомМеззасе ("Ошибка соединения"); 
} . 
ЕггогСоае = 0; 
} 
ИНН 


Збегуегбоскее1->АсЕ1уе=егае; 
Озегз->Ааа ("Всем"); 


у01А _ Еазеса11 ТЕогп1: :Гогтрезегоу (ТОБ]есе *5епаег) 
[ | 


Озегз->Егее (); 
беаМаг1->Егее (); 
ЗеаМахг2->Егее (); 


} 


Рассмотрим приведенный код. Глобальная переменная Озег$, как и ранее 
в разд. 9.5.4, используется для хранения списка имен всех клиентов, с кото- 
рыми установлено соединение. Первая строка этого списка содержит текст 
“Всем”, означающий для клиентов чата передачу сообщения всем клиентам 
сразу. Имена клиентов-игроков в списке будут предваряться символом "^". Это 
позволит отличать клиентов чата от клиентов-игроков. Глобальные перемен- 
ные Зеа\аг{ и Зеа\/аг2 ранее в серверном приложении отсутствовали. В них 
мы будем хранить списки пар игроков. Когда поступает первая заявка на игру, 
имя игрока будет заноситься в список Зеа\”аг1, а в список Зеа\/аг2 будет за- 
носиться пустая строка. Затем, когда поступает очередная заявка, будет про- 
сматриваться список Зеа\У!аг2. Если в нем обнаружится пустая строка, то имя 
нового игрока занесется в нее. Таким образом сформируется пара для игры. 
Если в Зеа\У/’аг2 пустой строки не найдется, начнется формирование следую- 
щей пары: имя игрока занесется новой строкой в список Зеа\Уа!г1, а в список 
- Зеа\’аг2 занесется пустая строка. 

Функция Зегуегэоске 1СПет{Веа является обработчиком события Оп- 
СПетшЖВеа4 компонента ЗегуегЗосКе{ 1. Она читает в переменную $ переданное 
серверу сообщение клиента. Далее проверяется, не равен ли первый символ 
этого сообщения символу "#". Если равен, значит пришел запрос на регистра- 
цию. В этом случае проверяется, равен ли второй символ символу "^". Если ра- 
вен, то запрос пришел от клиента-игрока. Тогда имя игрока читается в пере- 
менную 5Маште. Далее проверяется методом Ш@4ехОР, нет ли уже подобного 
имени с предшествующим символом "^" в списке Озег$, т.е. не зарегистриро- 
ван ли уже игрок с тем же именем. Если подобное имя имеется в списке, то ме- 
тодом ЗосКе—>Зеп4Тех{ клиенту, приславшему запрос на регистрацию, по- 
сылается команда с кодом Т. Как был сказано ранее, эта команда сообщает, 
что клиент должен отсоединиться от сервера, изменить имя, и попытаться по- 
том зарегистрироваться повторно. .. 

Если имя регистрирующегося игрока уникально, то это имя с предшест- 
вующим символом “^" заносится в список Озег$. Далее в цикле Фог просматри- 
вается список Зеа\аг2. Если в этом списке обнаруживается пустая строка, 
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значит имеется заявка на игру, для которой еще не подобран партнер. В этом 
случае имя игрока заносится в список Зеа\Уаг2. Этому игроку посылается 
строка “Вы играете с ...”, в которую подставляется имя партнера из списка 
Зеа\’аг1. А партнеру посылается строка "Вызов принял ...”, в которую под- 
ставляется имя игрока из списка Зеа\У/аг2. После отображения на сервере но- 
вого числа клиентов сети выполнение функции завергтается, а партнеры начи- 
нают расставлять свои корабли. 

Если в списке Эеа\Уаг2 не находится пустая строка, то надо начинать фор- 
мировать пару для новой игры. Имя игрока заносится в список Зеа\Уаг1, а 
в список Эеа\М’аг2 добавляется пустая строка. В цикле Фог всем клиентам, имя 
которых в списке О зег$ не начинается с символа ^^", т.е. всем клиентам чата, 
исключая игроков, рассылаются от имени зарегистрированного игрока сооб- 
щение о вызове на бой. 

Мы рассмотрели регистрацию игроков. Регистрация участника чата сво- 
дится к занесению его имени в список О$ег$. После этого всем участникам 
чата надо разослать этот пополнившийся список. Но из него надо исключить 
имена клиентов-игроков. Для этого создается временный объект списка 
ТирГ1$%. В него методом Ап заносится содержимое списка Озег$. А затем 
из этого списка удаляются все строки, начинающиеся с символа “^", т.е. все 
игроки. После этого список рассылается всем участникам чата, и временный 
объект ТтрГ1$& уничтожается. 

Теперь посмотрим, что происходит, если принятое сервером сообщение не 
начинается с символа "#", т.е. не является заявкой на регистрацию. В этом 
случае в переменную ЗМаште заносится имя клиента, которое завершается 
в сообщении символом “#". Затем проверяется, не является ли следующий 
символ символом “^". Если является, значит, сервер принял сообщение от кли- 
ента-игрока. Тогда в цикле просматриваются списки Зеа\аг1 и Зеа\аг2 
в поисках пары, в которой играет клиент, приславший сообщение. Когда пара 
найдена, партнеру игрока пересылается сообщение, присланное клиентом, т.е. 
текст, следующий за символом “"^". Заключительная часть функции Зегуег- 
Зоске{1СПетКВеа4 обеспечивает рассылку адресатам сообтцения, присланного 
клиентом чата. Эта часть не отличается от кода, рассмотренного в разд. 9.5.4, 
так что не будем на ней останавливаться повторно. 

Функция Зегуег5осКке 1СПеп( О15соппес{ является обработчиком события 
сервера ОпСЦеп 0 1$еоппесф, наступающего, если клиент разорвал соединение 
методом (С]1о5$е или любым другим способом — например, просто закрыл кли- 
ентское приложение. При событии ОпСНеп 0 1$соппес{ разрываемое соедине- 
ние еще не вычеркнуто из массива ЗегуегЗоске 1—>ЗосКеё—>Соппес# 01$. 
Поэтому поиском в этом массиве, осуществляемым первым циклом Фог, можно 
найти его индекс, сравнивая каждое соединение с разрываемым (оно передано 
в обработчик параметром ЗосКе@). После определения индекса разрываемого 
соединения осуществляется проверка, меньше ли он максимального индекса 
в списке Озег$ минус 1. Дело в том, что, как было показано выше, если кли- 
ент-игрок указал не уникальное имя, это имя не заносится в список Озегз, 
а клиенту посылается соответствующее сообщение. После его получения кли- 
ент разрывает соединение. При этом на сервере возникнет событие ОпСПеп{- 
П15соппес&, но в списке О5ег$ соответствующей строки не будет. Так что ника- 
кое вычеркивание клиента из списка не требуется. 

Если индекс соединения соответствует строке списка Озег$, то проверяет- 
ся, не равен ли первый символ этой строки символу "^". Если равен, значит со- 
единение разрывается с клиентом-игроком. Тогда в переменную ЭМате зано- 
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сится имя удаляемого клиента. Затем в списках Зеа\Уаг1 и Зеа\аг2 ищется 
это имя. После того как оно найдено, партнеру клиента посылается команда 
с кодом 6 — сообщение об отказе партнера от дальнейшей борьбы. Затем соот- 
ветствующие строки вычеркиваются и списков Зеа\У/аг1 и Зеа\УТаг. 

Теперь рассмотрим случай, когда соединение разрывается с клиентом 
чата. В коде разд. 9.5.4 при этом клиент вычеркивался из списка Оз$ег$, и всем 
оставшимся клиентам рассылался модифицированный список участников 
чата. Но в нашем новом приложении эта задача усложняется. Нам надо уда- 
лить из рассылаемого списка клиентов-игроков, и далее разослать этот список 
только участникам чата. Но если мы удалим из списка О$ег$ строку клиента, 
разрывающего соединение, то соответствие этого списка соединениям в свой- 
стве Зегуег5осКе{ 1—>ЗоскКеё—>Соппесйоп$ потеряется. И мы уже не сможем 
понять, какое соединение соответствует клиенту-игроку, а какое клиенту 
чата. Поэтому приходится создавать временный список Ттр[л$%, заносить 
в него содержимое списка Озег$, удалять из временного списка игроков, и рас- 
сылать клиентам чата этот временный список. Только после рассылки можно 
вычеркнуть соответствую строку из списка Озегз. 

Мы рассмотрели две основные функции сервера. Функции ЗегуегЗоске 1 - 
СПещЕггог, ЕогтСге{е, ГЕогтОе$& гоу аналогичны рассмотренным в преды- 
дущих разделах. Так что останавливаться на них не имеет смысла. 


Теперь можно перейти к рассмотрению клиентского приложения, обеспе- 
чивающего игру (проект ЗеаУаг2). За основу взят модуль, подробно рассмот- 
ренный в разд. 6.7.3. Из того модуля удалены компоненты Типег (вместе с об- 
работчиком его события ОпТ!тег) и ОрепО!а]10о5, использовавшиеся для рабо- 
ты с файлом. Зато добавлен компонент клиентского сокета СПеп{ Зоскеф. До- 
бавлена также панель Рапе!2, которую вы видите справа на рис. 9.8. 

Ниже приведен код тех функций клиентского приложения, которые изме- 
нены по сравнению с разд. 6.7.3, или добавлены заново. Остальные функции 
прежнего приложения остались без изменения. 


епом {са11, $зП1рз, ма1*%, поуе} мтоае; 

ВуЕе р1ауег = 0;// номер игрока: 1 - первый, 2 `- второй 
сопзЕ №=10; // размер поля 

соп5Е К=10; // число кораблей 

ВуЕе пк=0; // число введенных кораблей и убитых противником 
ВуЕе пк2=0; // число убитых кораблей противника 

11 пк [К]={1,1,1,1,2,2,2,3,3,4}; 

Вусе 1,); | 

НАМОТЕ Н; 

Боо1 Е1гзЕРо1пЕ; 


у0о1А _ ЕазЕса11 ТЕГогм1::Гогшбрпом (ТОБ]есе *5епаег) 
{ 
ЗЕг1паСг1а1->Со1Сойп® = 
5Ег1паСсг1Аа2->Со1СочцпЕ = 
5Ег1паСсг1А1->ВомСочпЕ = 
5Ег1паСг1Аа2->ВомСоцпе = 
Бог (1=1; 1 <= №; 1++) //очистка полей 
{ 
5Ег1паСсгЕ1а1->Се115$ 
ЗЕг1паСгЕ1а1->Се115$ 
ЗЕг1паСсг1а2->Се11$ 
5Ег1па9Сг1а2->Се115$ 
Бог (1106 )=1; ) <= 
{ 


угол 
++++ 
+ ра о | 


<“. 


101 = (сраг) ((ипз1дпеа срах)'А'! + 1 -1); 
][1] = 1; | 
1) [0] = (сБаг) ((апзтфапеа сваг)'А' +1 -1); 
} [1] = 1; 

++ 


и И Или Илии, 
он 


9.4 Сокеты 787 


5$Е:11п9СгЕ1а1->Се11$[1] [7] = "-1"; 
ЗЕг1паСбг1а2->Се11$[1] [7] = "-1"; 
} 
} 
5Ег1пасг1а1->Се11$[0][0] = ""; 
ЗЕг1паСсг1а2->Се11$[0][0] =""; 
Еа1+1->Техе = "Укажите ТР-адрес сервера, свое имя, " 


"и нажмите кнопку 'Вызов на бой!"; 
1 =) =0; | 
Е1гзЕРо1пе = $гце; 
шоае = са11; 


У01А __Еаз®са11 ТГогм1: :ВСа11С11сКк (ТОБ]есЕ *5епаег) 


{ 
1Е ((Ебегуег->Техе == "") || (ЕМБо->Техе == ""\)) 


{ 
ЗпомМеззачде ("Не задан ТР или имя"); 
гебагп; 


} . 
1Е ( (1706 (Ебегуег->Тех® [1])>=48) && (11% (Ебегуег->Тех® [1]) <=57) ) 


С11епёбоскеЕ1->Ааагезз = Ебегуег->Техе; 
е1зе С11епЕбоскКеЕ1->НозЕ = Ебегуег->Тех*; 
С11епебоскее1->Ореп (); 

} 


У01Я __Еаз&са11 ТКогш1: :С11епёбоскее1Соппес+ (ТОБ)есЕ *5епаег, 
ТСизфотИ1пбоскее *5оскКеф) 


{ 
С11епЕ5оскеЕ1->5оскеё->5епаТехе ("#^" + ЕМВо->Тех®);` 
Еа1*1->ТехЕ = "Вызов послан, но соперника пока нет. Ждите!"; 


Уу01А _ Еаз®са11 ТЕогм1:; :С]11еп5оскее1Еггог (ТОБ)]ес& *5епаег, 
ТСаязбомИ1пбоскее *боскеф, ТЕггогЕуепе ЕггогЕуепф, 
106 &ЕггогСоае) 
{ 
$м1ЕСВ (ЕггогЕхепе) 


{ 


сазе еебепа: ЗПомМеззасде ("Ошибка записи сообщения"); 
Бгеак; 

сазе ееВесе1\е: ЗРомМеззаае ("Ошибка чтения сообщения"); 
ргеак; 

сазе ееСоппесф: 5РомМеззаде ("Ошибка открытия соединения"); 
ргеак; 

сазе еер1зсоппес®: 5ПомМеззачде ("Ошибка закрытия соединения"); 
Югеак; 

сазе ееАссерф: ЗПомМе$засде ("Ошибка доступа"); 
ЬгеаКк; 

сазе еебепега1: ЗпомМеззасе ("Ошибка соединения") ;. 


} 


ЕггогСоае = 0; 


} 


уо1а 5епа(ВуЕе со4е, Вуее х, Вуе у) 


{ 
Роги1->С11епёбоскКеЕ1->боскеЕ->бепаТех+ ( 
Гогп1->ЕМПпо->ТехЕ + "#^" + ТлЕТобег (соае) + 


' т + ТеТо5Зег(х) + ' ' + ТПЕТобЕгЕ (у) ); 


у01А _ Еаз®са11 ТЕГогм1 ; : ВОКС11сК (ТОБ]есе. *5епаег) 
{ 
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Рапе11->\У1$161е = Еа15е; 
1Е(р1ауег == 0) 
{ 


р1ауег = 1; 

Еа1*1->Техе = "Ваш ход будет первым, но противник еще не готов"; 
} 

е15е 


{ 
Еа11->Тех+="Ход противника"; 
} 
Зепа (1, 0, 0); 
пк = пК2 = 0; 
поае = ма1*; 


Уо1а __ аз&са11 ТГоги1 : :С11епёбоскее1Веаа (ТОБ]есЕ *5епаекг, 
й ТСазбопИ1пбоскее *5оскеф) 

{ 

РИОВР +епр; 

Вуфе соаде, х, у; 


10 9; 
Апз15Ег1па 5 = боскее->ВесетуеТехе (); 
12(5$[1] == '0') // сообщение о вызове 


{ | 
Рапе12->\У1$161е = ЕЁа1з$е; 
Еа1*1->ТехЕ = $.ба65Ег1па (2,5.Ъепаер (}-1) + 


" Введите " + ТпЕТобЗЕг (5 - шк 0 1]) +" "+ 
ТпеТобег (шк[1]) + "-клеточных корабля"; 

Тафе11->СарЕ1оп = "Введено " + ТпЕТоб%ег (шк[1]) + 

"-клеточных кораблей 0"; 

поае = $61рз$; 

гебагп; 

} 

106 11 = 5.РозЗ(" "); 

106 12 = 5.1а$0е11т1ек(" ") - 1; 


соае = ЗегТоТпЕ ($.бар5ег1па (1, 11 - 1)); 
х = ЗЕГТотТпе (5$.ба556г1па (11 + 1, 12 - 11)); 
у = ЗЕгТоТпЕ (5.барбЕгапа (12 + 1, 256)); 


$мтЕСЬ (соае) 


{ 


сазе 1: // противник готов к игре 
1Е(р1ауег == 0) р1ауег = 2; 
е15е 


{ 
пое = поуе; 
Еа1е1->Тех+*="Теперь Ваш ход"; 
} 
ЬгеакК; 
сазе 2: // пришло сообщение о ходе противника 
УЗ = 5ЕгЕ119Сг1а1->Се11$[х] [у] .ТоТпё(); 
1Е(3 >= 0)//какой-то корабль 
{ 
ЗЕг1паСсг1а1->Се11$[х] [у] = "-3"; 
шк [9]--; 
1Е (пк [о] > 0) //ранил 
{ 
бепа (4, х, у); 
Еа1{1->ТехЕ = "Противник ранил. Ход противника"; 
} // конец "ранил" 
е]1зе //убил 
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сазе 3: 


сазе 4: 


сазе 5: 


сазе 6: 


сазе 7: 


{ 


пк++; 
Зепа (5, х, у); 
1Е(пК == К) // конец игры, проигрыш 


{ 

Еа1*1->Тех®*="Конец игры. Увы, Вы проиграли."; 
пое = са11; 

ЗПомМе$засче ("Увы, Вы проиграли!!!"); 


С1о5е(); 
гесагп; 
} 
е1зе 
{ | 
ЕЗ1{1->Техе = "Противник убил. Ход противника"; 
} 
} // конец "убил" 
} // конец попадания в корабль 


е1зе // мимо 
{ . 
поае = моуе; 
5Ег1п49С6х1а1->Се11$[х] [у] = "-2"; 
бепа (3, х, у); 


Еа161->ТехЕ = "Противник промазал. Теперь Ваш ход"; 


} 

Бгеак; 

// вы промахнулись 

Еа11->Техе = 

"Вы промахнулись. Теперь ход противника"; 

ЬгеаКк; 

// вы ранили 

моае = поуе; 

Еа1*1->ТехЕ = "Вы ранили на " + 
5Е:11п9СЕ1а2->Се11$[х] [0] + 
5Ех1пасг1а2->Се11$[0] [у] + 
". Опять Ваш ход"; 


`’56г1109СЕ1А2->Се11$[х] [у] = "-3"; 


БгеаКк; 


// вы убили 
поае = поуе; 
пк2++; 
1Е(пКк2 == К) // конец игры, выигрыш 
{ 
Е91%1->Тех&="Конец игры. Вы выиграли."; 
поае = са11; 
ЗВомМеззасде ("Ура!!! Вы выиграли!!!"); 
С1о5е(); 
гебоагп; 
} 
Еа161->ТехЕ="Вы убили. Опять Ваш ход"; 
ЗЕг1паСсЕ1а2->Се113$[х] [у] = "-4"; 
ЬгеаКк; 
// противник закрыл свое приложение (сдался) 
1Е (поае < $01р$) гебагп; 
Еа161->ТехЕ= 
"Конец игры. Противник сдался. Вы выиграли."; 
ЗпомМеззасще ( 


"Ура!!! Противник сдался!!! Вы выиграли!!!"); 
_ С1о5е(); 
гебагп; 
// имя игрока уже есть в списке 
зпомМез$зачсе ( 


"Указанное Вами имя уже имеется.\пСмените имя"); 
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Еа161->ТехЕ = "Укажите ТР-адрес сервера, " 
"свое имя, и нажмите кнопку 'Вызов на бой'"; 
С11епЕбоскеЕ1->С1озе (); 


Уу01А _ Еазеса11 ТЕГогм1: : ГогмСТозе (ТОБ]есЕ *5епаег, 
ТС1о5еАсЕ1оп &АсЕ1оп) 


{ 
С11епЗосКкКеф1->С1озе (); 


} 


В глобальных переменных имеется только одно изменение по сравнению 
с разд. 6.7.3: в объявление тофе добавлено еще одно состояние приложения — 
са! (выделено жирным шрифтом). Это исходное состояние приложения на от- 
резке времени, пока пользователь не щелкнул на кнопке Вызов на бой. В про- 
шлом варианте подобное состояние просто отсутствовало. 

Функция КГогт5ЗВо\м является обработчиком события формы ОпЗВом 
и производит первоначальную настройку таблиц 5Э4гте@на. Код настройки не 
отличается от варианта, рассмотренного в разд. 6.7.3, так что комментировать 
его я не буду. Из прежнего варианта удалены все операторы, которые обеспе- 
чивали работу с файлом. Добавлен вывод в окно ЕЧЁ1 указания пользователю 
о его действиях и оператор задания режима тоде равного саП (эти операторы 
выделены жирным шрифтом). 

Функция ВСаПСПеК является обработчиком щелчка на кнопке Вызов на 
бой. В начале функции производится проверка, задал ли пользователь [Р-ад- 
рес в окне ЕБегуег и свое имя в окне Е\/ Бо. Если не задал, пользователю выда- 
ется замечание и выполнение функции прерывается. Если адрес и имя заданы, 
то анализируется текст в окне ЕЗегуег. Если текст начинается с цифры, то по- 
лагается, что задан [Р-адрес сервера и соответствующее значение заносится 
в свойство СЦет{$осКе{1—>А9@4ге$$. В противном случае полагается, что задан 
ОВТ, и соответствующее значение заносится в свойство СПеп $ осКеё 1->Но$$. 
Затем соединение с сервером открывается методом Ореп. 

Функция СПеш{$оске{1Соппес& является обработчиком события ОпСоп- 
песё сокета. Оно происходит после успешного соединения с сервером. В этой 
функции серверу посылается запрос на регистрацию: символы "#^", после ко- 
торых записывается имя игрока — содержимое окна Е\Во. Пользователю вы- 
дается сообщение о посланном вызове на бой. 

Функция СНепЗосКе{1Еггог является обработчиком события ОпЕггог со- 
кета. Эта функция уже рассматривалась в предыдущих разделах, так что не 
будем на ней останавливаться. 

Функция Зеп4 обеспечивает отправку сообщения на сервер для последую- 
щей передачи его сопернику. В прошлом варианте модуля она обеспечивала 
запись в файл трех чисел. В новом варианте она пересылает на`сервер сообще- 
ние, содержащее имя игрока (содержимое окна Е\Юо), символы “"#^" и три 
числа в текстовом виде, разделенных пробелами. 

Функция ВОКСПеК является обработчиком щелчка на кнопке Готов к игре 
(см. в гл. 6 рис. 6.12 а). Первый оператор функции, как и в прежнем варианте 
модуля, делает невидимой панель Рапае11, и под ней становится видимым поле 
противника. Остальные операторы этой функции отличаются от варианта, 
рассмотренного в разд. 6.7.3. Сначала проверяется значение переменной 
р1ауег. Это значение в момент запуска приложения равно 0. Но, как будет вид- 
но далее, при получении клиентом сообщения, что партнер расставил свои ко- 
рабли и готов к игре, это значение изменяется. Так что в момент выполнения 
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функции ВОКСПеК значение рауег = 0 свидетельствует о том, что партнер 
ее не успел расставить свои корабли. В этом случае переменной рауег зада- 
ется значение 1 (первый игрок) и пользователю выдается сообщение о необхо- 
димости подождать, пока противник закончит расстановку кораблей. Если же 
в момент выполнения функции значение р1ауег ненулевое, значит, противник 
успел расставить свои корабли раньше. Тогда пользователю выдается сообще- 
ние, что сейчас ход противника. После того как выяснено, кто ходит первым, 
с помощью описанной ранее функции Зеп@4 посылается сообщение с кодом 1, 
свидетельствующее о готовности пользователя к игре. Последние операторы 
функции, настраивающие приложение на игру, пояснялись в разд. 6.7.3. 

Функция СПеп $ осКе{ 1 Веа4, читающая сообщение, присланное с сервера, 
является, пожалуй, основной функцией приложения. Она во многом подобна 
функции Типег1'Тпег в приложении разд. 6.1.3, которая читала информацию 
из файла. Но отличается другими значениями кодов, принятыми в нашем при- 
мере. Присланное с сервера сообщение заносится в переменную Ъ. Затем ана- 
лизируется первый символ сообщения. Если он равен 0, значит, с сервера при- 
шло сообщение, что вызов на игру принят. Тогда после символа "0" в сообще- 
нии идет текст "Вы играете с...” или "Вызов принял ...”. При получении тако- 
го сообщения панель Рапе]2, занимающая правую часть формы на рис. 9.8, де- 
лается невидимой, и под ней становится видна панель, которая показана на 
рис. 6.12 а. В окно ЕЧИ1 заносится полученный с сервера текст, после которо-_ 
го следует предложение вводить корабли. Это предложение и вся процедура 
ввода кораблей подробно рассмотрены в разд. 6.7.3. 

Если первый символ сообщения, полученного с сервера, не равен “0”, то 
получена команда, состоящая из трех цифр. Эти числа читаются в переменные 
со4е, х иу. Затем оператор з\мЁвеВ анализирует код со4е. Большинство разде- 
лов сазе оператора ме обеспечивают алгоритм игры и тождественны с точ- 
ностью до значений со4е тем, которые подробно рассмотренным в разд. 6.7.3. 
Так что я остановлюсь только на новых разделах. Значение софе = 1 соответст- 
вует приходу сообщения от противника о том, что он закончил расстановку 
своих кораблей. В этом случае анализируется значение переменной рауег, об- 
суждавшейся выше. Если значение равно 0, значит, противник успел расста- 
вить свои корабли раньше. Тогда задается значение рауег = 2 — второй иг- 
рок. Если же значение рауег ненулевое, то пользователю выдается сообще- 
ние, что он может делать свой ход, и приложение переводится в режим тоуе. 

Значение со4е = 6 соответствует приходу сообщения о том, что противник 
зарыл свое приложение — сдался. Тогда пользователь получает поздравление 
с победой и приложение закрывается. Значение софе = 7 соответствует прихо- 
ду от сервера сообщения о том, что имя, под которым пользователь хочет заре- 
гистрироваться для игры, уже имеется в списке игроков. Пользователю выда- 
ется соответствующее замечание, и соединение с сервером закрывается мето- 
дом Сфозе. 

Последняя функция приведенного кода Рогш(С1озе является обработчиком 
события ОпС]о5е формы. В этом обработчике соединение с сервером закрыва- 
ется методом С]озе. 

Мы рассмотрели все особенности примера организации игры "Морской 
бой” с помощью сокетов. Опробуйте описанные приложения. Можете исполь- 
зовать их в минуты отдыха для игры с товарищами. А можете внести ряд усо- 
вершенствований. Например, на сервере можно вести протокол сыгранных 
игр, выявлять чемпионов и т.п. Нетрудно также сделать игру более красоч- 
ной, снабдить звуковыми эффектами, имитациями взрывов и т.п. Можно 
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по тем же принципам запрограммировать более сложные коллективные игры, 
начиная с подкидного дурака, и кончая преферансом, покером и др. А можно 
решать и более серьезные задачи коллективной разработки каких-то проектов. 
Словом, возможности взаимодействия приложений через сокеты очень боль- 
шие. Дело только за вашей фантазией. 


9.5 Компоненты т\егпе{ ОтесЕ (таду) 


9.5.1 Общее описание 


Начиная с С++ВиПаег 6 имеется возможность организовывать общение 
приложений в сети с помощью компонентов Пфегпе& П1гесф (ш4у) компании 
Меугопа Оез!й15$. Эти компоненты в С++Ви4ег 6 расположены в библиотеке 
на трех страницах: пау С!еп5 — клиентские компоненты шду, |пау Фегуег$ — 
серверные компоненты шау, пау М5с — множество вспомогательных компо- 
нентов. В С++ВаПаег 2006 страниц ш@4у уже 5, так как добавились страницы 
|пау |тегсерю и |пау|/О Нап4[егз. Компоненты ш4у полностью вытеснили компо- 
ненты страницы Еа5 Ме, которая исчезла. 

Впрочем, все функции, которые ранее осуществлялись компонентами 
страниц Газте! и |пете!, осуществляются более эффективно новыми компонен- 
тами ау. В табл. 9.1 показано соотношение некоторых компонентов со стра- 
ниц Газпе! и тете! в версиях, предшествующих С++ВиП4аег 2006, с новыми 
компонентами шау. 


Таблица 9.1. Соотношение компонентов тау 
и прежних компонентов страниц Ра${пе{ и щегпет 


Страницы Раз пте | Страницы Ш@у Назначение компонентов 
и Оцегпе 


Т$Зегуег5осКе&, 'Татср$егуегЭосКеф, 


Взаимодействие двух компью- 
ТСПеп осКе ТатсСРСПен{Зоске теров (клиента и сервера) с 
помощью протокола ТСР/1Р 


ТММО)ауТ!те Т19ауТите, Запрос сервера о текущем 
Т19ауТипе$егуег времени 

ТММЕсво ТТАЕсво, ТТАЕсвоЗегуег Связь с сервером эхо 

ТММЕшеег ТТаРщбег, ТТаЕщтсег5егуег | Информация о пользователе с 


поискового сервера Интернет 


ТММЕТР ТАаектр, Татнущ=мЕТР, Передача файлов с помощью 
ТаТега ЕТР5егуег протокола ЕТР 


ТММНТТР "ПанНтТтР, тТаНТТР$егуег |Обмен данными по протоколу 
НТТР 


ТММММТР — ТТаммтр, Т1амМТР$егуег 


Обмен данными с сервером 
новостей | 


ТММРОРЗ Т1ЧРОРЗ Получение электронной поч- 


ты с почтового сервера с по- 
"мощью протокола РОР3З 


Отправка электронной почты 
ОЕ ива 


ТМММТР 195 МТР 
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Страницы РЕазфпеё Страницы ш@4у Назначение компонентов 
и Пуфегпе 
'ТММООР | Чар, 140) Р$егуег Пересылка данных с исполь- 
зованием протокола ОШОР 
"ТММОРгосеввог ЧО Епсодекг, ‚ | Перекодировка двоичных 
'Т190ООесодег файлов в формат МТМЕ 


| или (ОЕМСОПОЕ 


Правда, сразу нало оговорить, что С+-+Ви!аег 2006, во-первых, не поддер- 
живает версию Шау 10, которая устанавливается по умолчанию, и во-вторых, 
даже в версии шау 9 далеко не все компоненты работают. 

Так что если вы работаете с С++Ви!Паег 2006, проверьте установку катало- 
гов библиотек для С++. Для этого выполните команду Тоо{5 | ОрНопз и перейди- 
те в вершину С++ Орнопз | Ра5 апа Опесюпез (см. рис. 9.9 а). Если вы увидите 
в окошке Зеагсй Ра текст такого типа: 


$ (Вр$) \16\Тп9у10;$ (ВО$) \ВауеВерогез\Г1Ь 


значит, у вас установлена ссылка на тау 10, и при попытке компилировать 
проекты, содержащие компоненты шау, вы увидите сообщение об ошибке. 
Оно будет гласить, что С+-+ВиПаег не поддерживает шау 10. Кроме этого, воз- 
можны сообщения об ошибках, связанных с тем, что не находятся некоторые 
заголовочные файлы. 

Чтобы избавиться от этих ошибок, нажмите кнопку с многоточием около 
окна Зеагсв Рай. Вы увидите окно, показанное на рис. 9.9 6. В нем выделены от- 
дельными строчками составляющие текста окна Феогср Рот. Выражения 
$(В0$) — это корневой каталог ...\ВШО5\4.0. Вам надо выделить строку, ссы- 
лающуюся на [146\1п4у10. В нижнем окошке появится ее текст. В нем вам надо 
изменить 10 на 9 и нажать кнопку Керсасе (Заменить). Имеющаяся ссылка заме- 
нит прежнюю. Кроме того, надо ввести в нижнем окне ссылку $(ВОЗ)\ ше- 
4е\Ттау9 и нажать кнопку Ада (Добавить). Эта ссылка добавится в список ката- 
логов. В результате после того, как вы нажмете ОК в окне 9.9 б, вы вернетесь в 
окна 9.9 а, и строка в окошке Феагсй РаШ приобретет вид: 


$ (ВОЗ) \Ь15\тТпау9; $ (ВО$) \Вауевероке$\11ь; $ (В05$) \Тпс1аае\тпау9 


Теперь ваши приложения будут ссылаться на ШШау 9. 

К сожалению, все равно не все компоненты Шш@4у станут доступны. В част- 
ности, останется недоступным большинство серверных компонентов. Надеюсь, 
что какое-нибудь очередное обновление устранит эти досадные недоработки. 
Но пока могу писать только о том, что есть в имеющейся у меня версии 
С+-+ВиПаег 2006. Так что последующее изложение в данной главе относится 
только к С++Ви|аег 6. 

Страницы библиотеки пау Сет и пау Зегуег$ содержат, в основном, пары 
компонентов, соответствующих клиентской и серверной частям приложения. 
Они обеспечивают использование протоколов ТСР/ТР, ОШР, ММТР, БМТР, 
ЕТР, НТТР, а также служб ЕСНО, ЕТМСЕБ, \УНОГ® и др. 

Типичной парой являются компоненты Т1АТСРСПеп{ и ТТаТСР5$егуег, 
использующие протокол ТСР. К, тому же, они являются базовыми для мно- 
жества других серверных и клиентских компонентов Шу. Так что далее 
рассмотрим их в данном разделе несколько подробнее. А пока просто пере- 
числю некоторые иные компоненты. Пара компонентов ТТАОЮОРСПеп 
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Рис. 9.9. Окна настройки каталогов библиотек для С++ 


и ТЧООР5$егуег поддерживает сетевой протокол ОШОР (Озег ПБафахгат 
Ргофосо!) и является базовыми классами для ряда других компонентов штду. 
Пары компонентов Т1АШауТипе и ТТа)ауТ!те$егуег, Т14РауТипе0,Р и 
Т19ауТипе оР5$егуег, Т1ТЧТ1те и ТТАаТ!тезегуег обслуживают различные 
протоколы службы времени. Клиент запрашивает, а сервер сообщает теку- 
щую дату и время. Аналогично пары компонентов ТТАЕсво, Т1АЕСНОЗегуег 
и ЧЕсво0рР, ТИЧЕсвоООР$егуег обслуживают протоколы служб откли- 
ка, используемых, как правило, для проверки работоспособности сети. Кли- 
ент посылает текстовое сообщение серверу, сервер возвращает сообщение 
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клиенту. Компоненты ТТ1АЕтеег и Т14Етеег5егуег обеспечивают протокол, 
дающий возможность запрашивать данные о присутствии в системе других 
пользователей. Компоненты ТШАСорВег и ТШАСорБегЭегуег обеспечивают 
протокол СорПег. Он поддерживает иерархическую распределенную систему 
документооборота. Компоненты ПШАаНТТР и ТНТТР5$егуег поддерживают 
сетевой протокол НТТР. Кроме того, обеспечивается поддержка аутентифи- 
кации и применения ргоху-серверов. Компоненты Т1АММТР и Т1аММТР5$ег- 
уег обеспечивают сетевой протокол ММТР, используемый в службах ново- 
стей. Клиентский компонент включает поддержку МТГМЕ-кодирования и де- 
кодирования, а также поддержку многобайтных символов и альтернативных 
кодировок. Серверный компонент позволяет создавать серверы новостей. 
Компоненты ТТАФОТО и ТОТО $егуег используются для обеспечения 
службы “цитат дня”. С помощью клиентского компонента осуществляется 
соединение с экземпляром серверного компонента для получения ежеднев- 
ной цитаты. Каждый экземпляр сервера содержит уникальную базу данных 
цитат. Компоненты ТАЕТР, Татнуая ЕТР и ТТеуа1ЕТР5$егуег обеспечи- 
вают поддержку протокола передачи файлов — ЕТР. 

Остановимся теперь подробнее на типичной паре компонентов ТТАаТтСРСИ- 
еп и ТТАТСР5$егуег, использующих протокол ТСР. 

Серверный компонент ТАТСР$егуег создает для каждого клиента, от ко- 
торого поступил запрос, отдельный поток. Запросы поступают через порт, ко- 
торый прослушивается сервером. Номер порта задается свойством Ое!аи- 
Рог{. Это свойство может быть задано во время проектирования или программ- 
но. Совокупность слушающих сокетов, используемых сервером, содержится 
в свойстве Вшатр$. Класс этого объекта ТАЗ осКе Нап е5. Объект является 
коллекцией сокетов, имеющей в свою очередь свойство Ве!аи {Рогф, в которое 
передается одноименное свойство сервера. Но помимо этого объект В1т9т55 
имеет свойство Цет$ — индексированный массив соединений типа ТША$оске{- 
Нап Ме. Благодаря этому у сервера имеется возможность слушать несколько 
портов. Впрочем, ограничимся пока более простыми средствами обмена ин- 
формацией. 

Свойство Асйуе регулирует соединения и их прослушивание. Свойство 
Тегтштае\аЦТ!пе задает в миллисекундах время ожидания закрытия со- 
единений. По умолчанию задано значение 5000 — 5 секунд. В случаях, если 
соединений много или если процедура закрытия требует ‘длительных вычисле- 
ний, это значение можно увеличить. 

Основные события компонента: ОпСоппес* — возникает при попытке ус- 
тановить соединение с сервером, ОпО15соппес{ — возникает при разрыве со- 
единения, ОпЕхесше — возникает при передаче запроса серверу. В обработчи- 
ки всех этих событий передается объект потока АТЬгеаЯ класса ТТарРеег- 
ТЬгеа4. Основное свойство этого объекта — Соппесйоп, являющееся в свою 
очередь объектом типа Т1АТСР$егуегСоппесй оп. Основное свойство этого объ- 
екта — Эегуег. Это свойство имеет ряд методов чтения и записи информации. 
Рассмотрим основные из них. — 

Прочитать текстовую строку можно функцией Веа@дТГл: 


У1гсиа1 Ап515Ег1па __Еазса11 ВеааРл (сопзе Ап$15Ег1па АТегм1пабог = "", 
сопзе 1пе АТ1тмеоче = ОХЕЕЕЕЕЕЕе); 


Оба параметра функции необязательны. Параметр АТегипафог может за- 
давать строку, содержащую один или несколько символов, появление которых 
означает конец строки. 
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Предусмотрены константы, задающие типичные символы, используемые 
для прерывания: СНАВО — нулевой символ, СВ — переход на новую строку, 
ГЕ — возврат каретки, ЕОГ, — сочетание СВ + ГЕ. Если параметр не задан, 
подразумевается значение ЕОГ.. 

Параметр АТипеоц& задает в миллисекундах время ожидания при выпол- 
нении чтения. Значение по умолчанию соответствует бесконечному ожида- 
нию. Таким образом, если речь идет о чтении обычной строки, это может быть 
оформлено так: 


Ап$156г1па $ = АТЬгеаа->Соппес®*1оп->Веа@Шлп (); 


Имеется также функция КеадЗ то: 


Ап$156г1па __Еаз®са11 Веаа5®г1па (сопзе 1п6 АВуее$); 


Она обеспечивает чтение АВуёе$ байтов. Прочитанные символы удаляются 
из буфера ш@ду. Так что последующее вызов этой функции или функции 
ВеаЧГл обеспечит чтение следующих символов. 

Следующие функции обеспечивают чтение целых чисел: 

ипз1апеа Еаз*са11 ВеаЯСага1па1 (сопзЕ Боо1 АСопуегЕ = Егие); 


10: _ Еазса11 ВеаЧТпуедег (сопзЕ Ъоо1 АСопуегЕ = + гие); 
зрогЕ __Еаз®са11 ВеаЯ$та11Тп® (сопз®Е Юоо1 АСопуегЕ = %гие); 


Необязательный параметр АСопуегф указывает, должна ли последователь- 
ность байтов, принятая в сети, преобразовываться в последовательность, при- 
нятую в приложении. По умолчанию значение АСопуег{ равно фгие — дол- 
жна. Так что чтение целого числа можно оформить, например, следующим 0б- 
разом: 


10 1 = АТЬгеаа->Соппес®*1оп-> ВеааТпеечег(); 


Следующая функция читает заданное число байтов в буфер: 


Уу01А _ Еазеса11 ВеааВаЕЕег (уо14А *АВоЕЕек, 
соп5е 1106 АВувеСоппЕ); 


Параметр АВиЁЙег является указателем на буфер, в который производится 
чтение, а параметр АВуеСоип{ определяет число читаемых байтов. При вызо- 
ве этой функции надо достоверно знать, что передано, по крайней мере, не ме- 
ньше АВуеСоппё байтов. | 

Произвольные данные можно читать функцией Веа9${геат: 


Уу01А __ Еаз®са11 Веаа5$геапм (С]1аззез: :Т5егеам* Абегеам, 
1пЕ АВубеСоспЕ = ОхЕЕЕЕЕЕЕЕ, 
соп5Е Боо1 АВеааИпе11015соппесЕ = Ёа15е); 


Функция читает данные в поток А$фгеат. Необязательный параметр 
АВуеСоип% указывает число читаемых байтов. Значение —1, принятое по 
умолчанию, означает чтение всего содержимого буфера шау. Необязательный 
параметр АВеаЯ Оп и!Шлт$соппес&, если его задать равным фгие, обеспечит чте- 
ние до тех пор, пока соединение открыто. Обычно используются значения по 
умолчанию АВуеСоип{ = -1 и АВеаа ОпиШ/5соппесе@ = #а15е. Поскольку 
первые 4 байта в буфере 4у определяют длину хранящихся данных в форма- 
те П4егпе$, то при вызове функции ВеаЯ95фгеат сначала неявным образом вы- 
зывается функция Веа4аПцехег, чтобы преобразовать это число в формат ше], 
а затем читаются оставшиеся данные из буфера шаду. 

Мы рассмотрели основные функции чтения. Имеется ряд аналогичных 
функций, обеспечивающих запись в соединение: 
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У1гЕиа1 \у01а __Еаз®са11 ИМгл\фе (Апз1$5&г1па АОцЕ); 
уо1а Газса11 Мг1евВаЕЕег (соп$е уо1А *АВаЕЕег, 
—_ 116 АВубеСойпе, 
соп5Е Боо1 АМг1Еемом = Еа15е); 
Ууо1а ЕазЕса11 Мх1КеСагЯ1па1 (ипз1апеа АУ\а1оае, 
—_ соп$Е Боо1 АСопуегЕ = ф$гае); 
\у01А __Еаз®са11 Мг1ееТпфедег (1пе АУа1ае, 
соп$Е БооР АСопуегЕ = фгае); 
У1г6ца1 \01а _ Еаз®са11 Иг1ееГл (соп5Е Ап515ег1па АОие = ""); 
Уу01А __Еаз®са11 Мг1$ебма11Тп® ($Вог® А\Уа1ае, 
сопзЕ Роо1 АСопуегЕ = $гице); 
\1Ееиа1 уо1аА _ Еаз®са11 Мг1фебегеам ( 
С1аз$ез: :Т5Зегеам* Абегеам, 
соп$Е Боо1т АА11 = &гае, 
соп5Е Роо1 АМг1ЕеВукеСоипЕ = Еа15е)}; 
\01А __Еаз©са11 Мг1Ее5ег1па$ (С1аззез: :Т5Ег1паз* АУ\а]1ае); 
У1гЕиа1 ип51дпе __ГЕазеса11 Их1{еЕ11е (Ап515&г1па АЕ11е, 
' соп5Е Юоо1 АЕпаю1еТгапзЕегЕ11е = ЁЕа1зе); 


Большинство из этих функций вряд ли требует пояснений. Функция 
\У/гЦе записывает в соединение строку, не добавляя в конце символ новой 
строки. Этим она отличается от функции УгцеГа, добавляющей в конец стро- 
ки символы ЕОГ = СВ + ГР, т.е. символы новой строки и возврата каретки. 
Параметр А\’гцеМмом функции УтгЦцеВиЁег обеспечивает при значении ёгие 
немедленную передачу данных, минуя внутренний буфер шау. Параметр ААП 
функции Угце@геат, заданный равным %&гие, обеспечивает запись, начиная 
с первой позиции потока. Обратите внимание на две последние функции. 
Функция УгЦе5Ит5$ позволяет записать, например, сразу все строки компо- 
нентов Мето и ВасВЕЯЦ. А функция УгцеЕПе обеспечивает запись целого 
файла с именем АЕ1Ше. Задание значения фгие параметру этой функции 
АЕпаеТгап{егЕПе ускоряет запись в У/114о\з МТ\2000\ХР, но исключает 
возможность управления этим процессом. | 

Конечно, я рассмотрел далеко не все свойства и методы компонента 
ТаТСР5егуег. Но этого достаточно, чтобы можно было построить сервер шау 
и посмотреть применение рассмотренных функций. Давайте рассмотрим про- 
стой пример — создание сервера, который принимает от клиента ключ и стро- 
ку, шифрует строку с помощью этого ключа и возвращает ее клиенту в зашиф- 
рованном виде. А при передаче серверу того же ключа и запшифрованной стро- 
ки он вернет клиенту строку в расшифрованном виде. 

Сначала реализуем простейший вариант, в котором ключ — всего один 
символ. Будем полагать, что клиент передает на сервер сообщение, в котором 
первый символ — ключ, а последующие символы — шифруемый или дешиф- 
руемый текст. | 

Начните новое приложение и перенесите на форму компонент 1А4ТСР$егуег 
со страницы |пау Фегуегз. В свойство ОеЁаиНРогё занесите номер порта. Напри- 
мер, 6001. Надо только следить за тем, чтобы номера портов разных служб не 
дублировали друг друга. Свойство АеЙйуе компонента 1АТСР5$егуег установите 
в гие. Настройка серверного компонента на этом закончена. Осталось написать 
обработчик его события ОпЕхеесще. Он может иметь следующий вид: 


Уу01А __Еаз®са11 ТЕокм1:;: : ТАаТСР5$егуег1Ехесике (ТТарРеегТргеаа *АТргеачд) 
{ 
Сгу 
{ 
гу 
{ 
Ап$156г1па Кеу = АТрЬгеаа->СоппесЕ1оп->ВКеаа$&г1пча (1); 
Апз156г1па 5 = АТргеаа->Соппес&1оп->ВеааТлп (); 
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ох (11 1=1; 1 <= $.Гепаей(); 1++) 
5$[1] = сраг($[1] ^ Кеу[1]); 
АТ№геаа->Соппесе1оп->Ихг1 еп ($); 


} 
саесв (...) 


{ 


зпомМез55$аде ("Ошибка передачи данных“); 
} 
__Е1па11у 
{ 


АТЬгеаа->СоппесЕ1оп->015соппесе® (); 
} 
} 


Методом Веа95{гте один символ пришедшего сообщения читается в пере- 
менную Кеу. Это ключ, который будет использоваться при шифровании. Затем 
методом Веа4Ги оставшаяся часть сообщения читается в переменную 5. Далее 
в цикле каждый символ переданной строки складывается по операции исклю- 
чающего или с ключом. Запифрованная таким образом строка возвращается 
клиенту методом УтЦеГл. После этого методом О1$еоппесй соединение разры- 
вается. Как видим, обмен информацией осуществляется предельно просто. 

Поскольку при чтении и передаче данных возможны всякие ошибки, опе- 
рации чтения и записи помещены в блок ту ... еаёев. А разрыв соединения, 
который должен производиться независимо от наличия или отсутствия оши- 
бок, помещен в раздел __ЙЯпаПу. 

Больше ничего делать не требуется. Сервер спроектирован. Можете сохра- 
нить его и откомпилировать. Теперь можно создавать клиентское приложение. 

Начните новое приложение и перенесите на форму компонент 1АТСРСПен 
со страницы тау Сет. Этот компонент обеспечивает обмен информацией со 
стороны клиента. В его свойство Рог надо занести тот же номер порта, кото- 
рый вы задали в сервере. Например, 6001. В свойство Но$# надо занести адрес 
удаленного компьютера, на котором находится сервер. Это может быть сетевое 
имя компьютера или его [Р-адрес. Если вы хотите соединяться с сервером, за- 
пущенным на вашем компьютере, можете записать "127.0.0.1” или "]оса]- 

03%”. 
| Теперь перенесите на форму окно редактирования ЕЯ, в которое.будет за- 
носиться текст, подлежащий кодированию. Перенесите еще одно окно редак- 
тирования. Назовите его, чтобы не путать с первым, ЕКеу. В этом окне пользо- 
ватель сможет задавать ключ — пока всего один символ. И перенесите на фор- 
му кнопку, в обработчик щелчка на которой запицтите код: 


у01А __ Еазса11 ТЕогм2::Ваеоп1С11сК (ТОр)]есе *5епаег) 


{ 
гу 
{ 
Еку 
{ 
Татсрс11еп  1->СоппесЕ (); 
Татсрс11еп Е 1 ->Иг1$еГл ( (Ап515Ег1па) ЕКеу->Тех® [1] + Еа1%1->Тех®); 


Еа1*1->ТехЕ = Татсрс]11епЕ1->Веаа!п (); 

} 

саеср (...) 

{ 

ЗпомМеззасде ("Ошибка соединения или передачи данных"); 


} 
__ Е1па11у 
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{ 
ТатсрС]11еп*1->015соппесЕ (); 


} 
} 


В начале обработчика методом Соппес& клиент соединяется с сервером. За- 
тем методом УтЦеГл серверу передается первый символ ключа из окна ЕКеу 
и текст строки, записанной в окне ЕЯ 1. А методом Веа9Глп полученный ответ 
сервера читается в то же окно ЕЧИ1. После этого соединение разрывается ме- 
тодом О1$соппес+. Код предусматривает перехват исключений, которые могут 
появиться во время сеанса связи с сервером, и выдачу пользователю соответст- 
вующего сообщения. 

Можете сохранить и откомпилировать клиентское приложение. Теперь 
протестируйте совместную работу сервера и клиента. Запустите серверное 
и клиентское приложения, заполните окна клиента и щелкните на кнопке. 
В окне ЕЯ 1 появится зашифрованный текст. Щелкните на кнопке еще раз. 
В окне восстановится исходный текст, который был записан в нем до первого 
щелчка. 

Можете опробовать на этом примере другие функции чтения и записи, рас- 
смотренные ранее. Например, чтение ключа в серверном приложении можно осу- 
ществить методом Веа4ВиЁег. Тогда код чтения и шифровки может иметь вид: 

саг Кеу; 

АТЬгеаа->Соппесе1оп->ВКеааВаЕЕег (&Кеу, 1); 

Ап$156г1па $5 = АТргеаа->Соппесе1оп->ВеааЁл (); 

Рог (116 1=1; 1 <= 5.Бепраев(); 1++) 

$[1] = саг (5$[1] ^ Кеу); 


Можно ключ передавать и читать как целое число. Тогда оператор клиент- 
ского приложения, вызывающий в приведенном ранее коде функцию \Ут- 
феГл, можно заменить операторами: 


Татсрс11еп*1->Иг1$ебща11Тпе (ЕКеу->Техё [1]); 
Татсрс]11еп*1->Мг1Ее1лп (Еа1{1->Тех*); 


Тут ключ записывается в виде целого числа методом УтгЦеэтаШпф, а после 

него методом УтгЦеГи записывается текст. Тогда в серверном приложении 

чтение информации и шифровку надо организовать следующим образом: 
сраг Кеу = АТЬгеаа->Соппес&1оп->ВеаЯ$та11Тп(); 

Ап$156г1па 5 = АТргеаа->СоппесЕ1оп->ВеааТлп (); 

Бог (116 1=1; 1 <= 5.Бепаев(); 1++) 

5[1] = сВаг($[1] ^ Кеу); 

Конечно, рассмотренный вариант шифровки очень примитивный. Не пред- 
ставляет труда создать программу, которая простым перебором подберет ключ 
к зашифрованному тексту. Обычно в качестве ключа используется последова- 
тельность символов. В этом случае подобрать ключ простым перебором намново 
труднее. В нашем приложении это легко сделать. В клиентском приложении пе- 
редача информации на сервер может быть осуществлена оператором: 


Татсрс11еп*1->Мг1$е1лп (ЕКеу->Техе + "\п" + Еа161->Тех®); 


Этот оператор передает информацию в виде двух строк: ключевой строки, за- 
писанной в ЕКеу, и строки, подлежащей шифровке. Чтение и использование 
этой информации на сервере может иметь вид: 


Ап515Ег1апа Кеу = АТрхеаа->СоппесЕ1оп->Веаарп (); 
Апз156г1па $ = АТргеаа->Соппес®*1оп->Веаа!п (); 
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и 


Бог (110 1=1; 1 <= 5.Ъепаер(); 1++) 

5[1] = срак($[1]) ^ Кеу[1 + (1 - 1) $ Кеу.цепа®В ()]); 
Тут ключевая строка читается в переменную Кеу, а затем при шифровке ее 
символы циклически используются для шифровки текста 5. Цикличность 
обеспечивается операцией %. 


Приведенный пример организации взаимодействия клиентов и сервера 
Гп4у показал, вероятно, что все это делается предельно просто. Конечно, есть 
определенные тонкости, в которые мы пока не будем погружаться. Но в целом 
способ организации обмена информации между сервером и клиентом, я ду- 
маю, понятен. Ну а более сложные программы на этой основе шАу можно стро- 
ить по тем же принципам, которые были рассмотрены в предыдущих разделах 
для других технологий. 


9.5.2 Обмен текстовой информацией между двумя 
компьютерами 


Воспроизведем на компонентах ТТАТСРСПет и ТТаТСР$егуег приложе- 
ние обмена текстовыми сообщениями между двумя приложениями, работаю- 
щими на разных компьютерах. Подобное приложение было рассмотрено 
в разд. 9.3.2, а вариант с компонентами шау, который мы сейчас построим, вы 
найдете на приложенном к книге диске в каталоге Г[п4у в проекте [пауМз8. 

За основу возьмем форму приложения из разд. 9.3.2, которая показана 
на рис. 9.3. Это приложение одновременно является и клиентом, и сервером. 
Таким образом, запустив подобные приложения на разных компьютерах сети, 
можно организовать обмен текстовой информацией между ними. 

Напомню, как должно работать это приложение. В окне Ваше имя (его имя 
Е\М Во) пользователь указывает произвольное имя, которое увидит получатель 
сообщения. В окне Получатель (имя ЕНо$$) пользователь указывает адрес ком- 
пьютера, на котором расположено то приложение, которому направляется по- 
слание. Это может быть, в частности, аналогичное приложение, так как оно у 
нас будет являться и сервером, и клиентом. В окне Текст сообщения (имя ЕРо${) 
пользователь может написать послание. После того, как все указанные окна 
заполнены, можно нажимать кнопку Передать (имя ВРо5${). Текст будет пере- 
дан на компьютер получателя, и в окне Протокол диалога (имя ВаеВЕ9И2) поя- 
вится строка, содержащая дату, время, имя отправителя и текст сообщения. 
Если пользователю пришло сообщение с другого компьютера, то в том же окне 
Протокол диалога появится аналогичная информация о принятом сообщении. 

Если в момент прихода сообщения окно приложения свернуто, или поль- 
зователь работает с другим окном, то раздается звук, и пиктограмма приложе- 
ния в полосе состояния начинает мигать. Таким образом пользователь может 
узнать о новом сообщении, которое пришло на его адрес. Об остальных чисто 
вспомогательных кнопках приложения говорить не будем. 

Если хотите сделать такое приложение сами, скопируйте прежний проект 
№МММз= под новым именем [п4уМ3з&, а файл модуля под именем ПО]пауМз8. 
Удалите с формы компоненты МММ$ и МММ5СЪФегу, и перенесите вместо 
них компоненты ТаТСРСПеп% и ТаТСР$егуег. Удалите обработчик события 
МММ$С5$егу1М5С, который был в прежнем проекте. 

В компоненте сервера 1АТСР5егуег1 задайте свойство Ве аи Рогё рав- 
ным, например, 6001. Тот же номер порта задайте в свойстве Рог клиента 
ТаТСРСЦПеп{ 1. Свойство Но$$ клиента можно не задавать, так как оно будет да- 
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лее задаваться программно исходя из указанного пользователем адреса. Так 
что указанной элементарной настройкой можно ограничиться. 
В обработчик события ОпСгежфе формы вставьте оператор: 


Татср5егуех1->АсЕ1\уе = +гиае; 


Он обеспечит в момент запуска приложения активизацию сервера и начало 
прослушивания порта. 

Теперь надо договориться об элементарном протоколе передачи данных. 
Можно, конечно, просто передавать некоторое текстовое сообщение, но клиен- 
ту, вероятно, будет интересно знать, от кого пришло сообщение. Поэтому да- 
вайте договоримся, что передаваемое сообщение будет состоять из двух частей: 
сначала в него будет записываться имя пославшего, а после него будет записы- 
ваться основной текст сообщения. 

Договорившись об этом, можно написать обработчик щелчка на кнопке 
Передать: 

у01А _ Еазеса11 ТГоги1:; :ВРо$®С11сК (ТОБ]есе *5епаег) 

" татСРС1епЕ1->Нов* = ЕНоз®е->Техе; 

гу 
{ 
гу 
{ 
ТАатсрРС11еп*1->Соппесе (); 
Татсрс11еп{1->Иг1$еГл (ЕМпо->Техе); 
Татсрс11еп $ 1->Иг1Фе!л (ЕРозЕ->Техе); 
В1срЕа1{2->1пез->Ааа (Гогта*ВафеТапе ("", Мом ().) +": для " + 
ЕНозе->Техе); 
В1свЕа1е2->11пез->Ааа (ЕРозЕ->Техе); 


} 
саесп (...) 


{ 


В1свЕа12->1пез->Ааа ("Ошибка соединения или передачи данных"); 
} 


} 
__Е1па11у 


{ 
Татсрс]11еп&1->р1$зсоппесе (); 


} 
} 


Первый оператор заносит в свойство Но5& компонента 1АТСРСПеп{ 1 адрес 
того, кому посылается сообщение. Этот адрес пользователь указывает в окне 
ЕНо$# (см. разд. 9.3.2). 

Вызов метода Соппес& компонента ТатТСРСПеп+{ 1 устанавливает соедине- 
ние с адресатом. Далее методом УтЦцеГи передается имя отправителя (занесе- 
но пользователем в окно Е\Во), а следующим вызовом УтгЦеГп передается 
текст сообщения, который пользователь занес в окно ЕРо$$. Остальные опера- 
торы заносят в окно протокола ВлеВЕЯН2 информацию об отправленном сооб- 
щении: момент времени, адрес, по которому сообщение передается, и текст со- 
общения. | 

Во время передачи всегда может, конечно, произойти ошибка. Поэтому в 
коде предусмотрен перехват исключения, которое может возникнуть. Заклю- 
чительный оператор, помещенный в раздел __ЙЯпаПу, в любом случае обеспе- 
чивает завершение соединения методом О1зсоппес%. 
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Клиентскую часть приложения мы завершили. Осталось написать обра- 
ботчик события ОпЕхесще серверного компонента 1АТСРЗегуег1, обеспечи- 
вающий прием сообщения. Этот обработчик может выглядеть так: 


Уу01А __ЕазЕса11 ТГоги1 : : ТаАТСР5егуех1Ехеси*е (ТТаРеегТргеаа *АТьгеаа) 


{ 
1Е (|! Арр11са®1оп->Аселуе ) 
{ 


Т1иех1->Епаю1еа = +фгае; 
Веер (); 


гу 
{ 
ху 


{ 
Ап515©г1па 5Егом = АТргеаа->Соппес®1оп->ВеааГлп (); 


Ап$15Ег1па 5 = АТргеаа->СоппесЕ1оп->Веа@1лп (); 
В1срЕа12->1пез->Ааа (Гогма*ВафеТ1ште ("", М№ом ()) +": от " +5Егом); 
К1свЕа12->Г1пез->Ааа ($); 

} 

саесп(...) 


{ 


В1свЕа1$2->11пез->Ааа (“Ошибка передачи данных”); 


} 
} 
__Е1па11у 


{ 


АТЬгеаа->СоппесЕ1оп->01зсоппесе (); 


} 

} 

Передаваемый в функцию параметр АТВгеа4 - это объект соединения, ус- 
тановленного между клиентом и сервером. С его помощью можно читать дан- 
ные, полученные от клиента, и передавать клиенту свои данные. 

Начальные операторы кода, связанные с миганием неактивного приложе- 
ния при получении им сообщения, обсуждались в разд. 9.3.2. Основные опера- 
торы, это те, которые помещены в блок гу. Первый из них читает в перемен- 
ную ЭЕгош методом Веа4Гли первую часть сообщения — имя пославшего дан- 
ное сообщение. Следующий оператор читает тем же методом в переменную $ 
основную часть сообщения. Остальные операторы заносят результат чтения 
в протокол. 

Приведенный вариант использовал при передаче сообщений два вызова 
функции УгцеГа, записывающих имя отправителя и текст сообщения в от- 
дельных строках. Можно было бы поступить иначе - и имя, и текст объединить 
в одну строку, разделив их нулевым символом. Тогда вместо двух вызовов 
функции УтцеГа в клиентской части приложения можно было бы ограни- 
читься одним: 


Татсрс11еп*1->Мг1еГл (ЕМВо->ТехЕ + '\0' + ЕРозЕ->Техё); 

В этом случае первый вызов Веа4Ги в серверной части приложения надо 
заменить следующим: | 

Ап$156г1па оггом = АТЬгеаа->СоппесЕ1оп->ВеааГл (СНАВО); 

В этом операторе в качестве аргумента в вызов функции передается кон- 
станта СНАКО — нулевой символ, так что оператор прочитает только первую 


часть сообщения. А вторую часть можно читать тем же оператором, который 
использовался в приведенном ранее примере. 


9.5 Компоненты П\егпе{ ОтесЕ (тау) 803 


Приложение готово, так что можно его испытать, запустив на выполнение 
несколько его экземпляров. Правда, если вы работаете с несколькими прило- 
жениями на одном компьютере, то возникнут определенные неприятности: со- 
общения от всех приложений будет принимать одно — то, которое было запу- 
щено первым. Но если вы запустите это приложение на разных компьютерах и 
зададите в них соответствующие сетевые адреса, то сможете в полной мере об- 
мениваться информацией. 


9.5.3 Обмен текстами и файлами 


Теперь давайте расширим возможности созданного приложения, введя в 
него возможность обмениваться не только текстовыми сообщениями, но и про-. 
извольными двоичными файлами. Это могут быть файлы текстовых докумен- 
тов, файлы аудио, видео, графические, и т.п. Одновременно расширим воз- 
можности передачи и чисто текстовых сообщений, разрешив, чтобы они были 
многострочные. 

Основные функции чтения и записи были рассмотрены в разд. 9.5.1. Би- 
нарные файлы можно записывать в соединение и читать различными комби- 
нациями этих функций. Например, для передачи файла клиент может исполь- 
зовать функцию УгцеЕ Пе: 


Татсрс11еп Е 1 ->Иг1$еЕ11е (ЕГ11еМапе); 


где ЕИеМаше — строка с полным именем файла. 

Чтение переданного таким образом файла на стороне сервера может быть 
организовано функцией Веа9 $ геат: 

ТЕ11ебсгеам *5Е = пем ТЕ11ебегеам (Е11еМапе, ЕшСгеаее); 


АТргеаа->СоппесЕ1оп->КеаА$ Е геам(5Е, -1, Еа15е); 
Е->Егее (); 


Первый оператор создает файловый поток ЗЕ с именем файла ЕПЦеМате. 
Аргумент ЁйпСгеа{е означает, что если файл с этим именем уже существовал, 
то он будет уничтожен и создан заново. Следующий оператор читает все содер- 
жимое буфера тау в поток ЗЕ. Аргумент -1 указывает, что читаться должны 
все данные, а последний аргумент #а[5е означает, что чтение завергтается, ко- 
гда прочитаны все байты. Если этот параметр задать равным фгае, то чтение 
будет продолжаться, пока не закроется соединение. 

Прием файла, по:жалуй, в большинстве случаев имеет смысл организовы- 
вать подобным образом. А вот передачу файла часто целесообразно произво- 
дить тоже с помощью потока. Например, так: 

ТЕР1]1ебЕухеам *СЕ =: пем ТЕ11ебЕегеам (Е1]еМапе, ЕпОрепвеаа) ; 


Татсрс]11еп{1->ИМг1себЕекеам(5Е, Егие, +гае); 
ЗЕ->Егее (); 


В этом коде, версятно, следует пояснить только второй и третий аргумен- 
ты в вызове метода записи потока \УгЦе&геат. Второй аргумент, установлен- 
ный в фгае, означает, что надо записывать весь поток, начиная с первой пози- 
ции. Если задать аргумент равным #а5е, то записываться будет только часть 
потока, начиная с текущей позиции. Значение последнего аргумента равное 
фгие означает, что пеэед данными будет записано число передаваемых байтов. 
Это число далее используется описанным выше методом Веа95геат. 

Теперь перейдем к построению приложения. Можно, конечно, создать его 
заново, но проще преобразовать тот проект, который был создан в разд. 9.5.2. 
Если идти по этому пути, то надо сохранить прежний проект и его модуль под 
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новым именем. На диске, приложенном к книге, это проект [14уМз&2 в ката- 
логе [пау. Окно приложения показано на рис. 9.10. Изменения по сравнения 
с прежним проектом сводятся к следующему. Добавлена кнопка Передать файл 
(имя ВЕПе). Окно редактирования, в котором ранее записывалось сообщение, 
заменено компоентом Мето1, чтобы опробовать передачу многострочных тек- 
стовых сообщений. Добавлены диалоги ОрепП1!а10$1 и ЗауеП1а1021, обеспечи- 
вающие открытие и сохранение файла. И добавлен индикатор Подтверждение 
(СвескВох1), на который пока не будем обращать внимание, так как рассмот- 
рим его позднее. 


Рис. 9.10 .‚:" Программа передачи сообщений и фай 
Приложение обмена | Ваше имя: — Получатель Протокол диалога 
текстами и фаилами [Ваня гпусотр2 Получено 21.03.2006 13:33:22: Катя 


Пришли мне 
Текст сообщения файл шпоры! 


Выснлаю - | 21.03.2006 13:33:36: Ваня 
Высылаю 


21.03.2006 13:33:44: Ваня 
Послан файл К:\Воситепб апд 


бецтоз\АИ Ц зегз\Ооситей 
\шпаргалка.дос 


Файл шпаргалка. дос получен 


Передать ыыы Передать дайл | Очистить | Сохранить. - 


М Подтверждение 


_ Прежде, чем начинать кодирование, надо уточнить протокол, по которому 
будут осуществляться передачи. Передача текстового сообщения пусть так же, 
как и раньше, состоит из двух частей: записанного отдельной строкой имени 
того, кто отправляет сообщение, и основной части, которая теперь может со- 
стоять из многих строк. Можно, конечно, читать такое сообщение по строкам, 
но это неэффективно. Поэтому договоримся, что после текстого сообщения бу- 
дем передавать нулевой символ. Тогда все сообщение можно будет прочитать 
в один прием вполоть до этого заключительного символа. 

Надо также договориться, как будет передаваться файл. Необходим при- 
знак, по которому на стороне сервера можно будет понять, пришло ли тексто- 
вое сообщение, или файл. Для этого первая строка должна быть ключевой, по- 
зволяющей разделить эти два варианта. Пусть, например, первая строка при 
передаче файла будет содержать текст “Передача файла”. По этому условному 
коду сервер поймет, что пришел файл. Следующая строка пусть содержит имя 
отправителя, следующая — имя файла, а после этого пусть идут двоичные дан- 
ные передаваемого файла. 

Теперь можно написать обработчик щелчка на кнопке Передать файл и из- 
менить написанные ранее обработчики щелчка на кнопке Передать текст (кноп- 
ка ВРо${) и события ОпЕхесше компонента Т1аТСРЗегуег1. Приведенный 
ниже обработчики щелчка на кнопке Передать текст мало отличается от преж- 
него: 


у01А __Еаз®са11 ТРГогм1: :ВРозеС11сК (ТОР)]есе *5епаег) 


{ 
Татсрс11еп Е 1->Ноз$® = ЕНозф->Техе; 
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ску й 
{ 
Егу 
{ 
Татсрс11епе1->Соппес* (); 
Татсрс11еп*1->Иг1 еп (Е\МБо->Техе); 
Татсрс11еп к 1->Иг1е!п (Мето1->Техе + '\0'); 
В1срЕа1+2->11пез->Ааа (Гогта*ПБафеТ1ме ("",Мом()) +": " + 
Е\Мо->Тех®); 
В1сьЕа1+2->1пез$->Ааа (Мепо1->Тех®); 
} 
саесп (...) 
{ 
В1срЕа1{2->11пез->Ааа ("Ошибка соединения или передачи данных"); 
} 


} 
__ Е1па11у 
{ 


ТАТСРС11еп%1->01зсоппесе (); 
} 
} 


Единственное принципиальное отличие — это нулевой символ, завершающий 
передачу текста окна Мето1. О назначении этого символа уже было сказано 


выше. 
Обработчик щелчка на кнопке Передать файл может иметь вид: 


у01А _ Еазеса11 ТЕоги1 : :ВЕ11еС11ск (ТОБ]есе *5епаег) 
{ 
1Е (Орепр1а1о0о91->Ехесиее ()) 
{ 
ТатсрРС11еп*1->Нозе = ЕНо$$->Техф; 
6гу | 
{ 
ху 


Татсрс11еп*1->Соппес® (); 

Татсрс11еп{ 1->Мг1$е1л ("Передача файла"); 
ТАатсрРС11еп&1->Иг1 ел (ЕМВо->Тех®); 
ТатсрРС11еп1->Иг1е1Тл (Ех гас®Е11еМаще (Орепр1а1о91->Е11еМапе)); 


ТР11ебфгеам *5Е = пем ТЕ11еб$геам (Орепр1а1031->Е11еМаме.с_з%г(), 
ЕтОрепБеаа); 

ТАТСРС11еп&1->Иг1+е5%геам(5Е, гие, &гие); — 

ЗЕ->Егее (); 


В1свЕа1 2->Г1пез$->Ааа (Гога БафеТ1ме ("",Мо’и ()) +": " + 
Е\МТо->Тех®); 
В1свЕа12->11пез->Ааа ("Отправлен файл " + 
Ореп01а1о31->Е11еМамеэ); 
} 
саесь (...) 
{ 
В1срЕа12->1,1пез->Ааа ("Ошибка соединения или передачи данных"); 
} 
} 
__Е1па11у 
{ 
Татсрс11еп+1->1015соппесе® (); 
} 
} 
} 
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Приведенный код, вероятно, достаточно понятен. Если пользователь вы- 
брал в диалоге файл, то открывается соединение, методами У\УтгЦцеГл записыва- 
ются начальные строки, оговоренные выше при обсуждении протокола обме- 
на, после чего рассмотренным ранее способом записывается выбранный файл. 

Обработчик события ОпЕхесше компонента 1аТСРЭегуег1 может иметь 


вид: 
У01Аа _ Еаз®са11 ТЕГогп1 ; ; ТАТСР$егуег1Ехесифе (ТТаРеегТпгеаа *АТргеаа) 


{ 
1Е ( ! Арр11са&1оп->АсЕ1уе ) 


Т1мег1->Епаб]1еа = +гце; 
Веер (); 
} 
Ап$156©г1па 5Егош, 5; 
Еху 
{ 
Е ку 
{ 
5Ггом = АТЬгеаа->Соппес*1оп-> ВеааГлп (); 
1Е (5ЕРЕгоп == "Передача файла") 
{ 
// Прием текста о передаваемом файле 
ЗЕгом = АТЬгеаа->Соппес®1оп->ВеааГл (); 
В1срЕа12->1пез->Ааа ("Получено " + ГогмаерафеТ1апе ("",Мом()) + 
"; "+ ЭРгош); 
5 = АТЬгеаа->СоппесЕ1оп->КВеаа1Тл (); 
В1срЕа12->11пез$->Ааа ("Файл " + 5); 
// Прием файла 
1Е (Арр11са®1оп->МеззасаевВох ( ("Пользователь " + $Егом + 
" присылает вам файл "+ 
5 +". Сохранить?") .с_5Ег(), 
"Сохранение файла", 
МВ_УЕЗМОСАМСЕГ + МВ ТСОМОДЧЕЗТТОМ) == ТОУЕЗ) 
{ 
Зауер1а1оа2->Е11еМате = $5; 
1Е (бауер1а1о92->Ехесисе ()) 
{ 
ТР1]1е5егеат *5Е = пем ТЕ11ебёгеам ( 
бауер1а1092->Е11еМаме.с_з6г(), ЕтмСгеафе); 
АТЬгеаа->СоппесЕ1оп->Веаа5+геам($Е, -1, Еа15е); 
ЗЕ-—->Егее (); 
В1свЕа1е2->Т1пез->Ада ("Принятый файл сохранен в" + 
Зауер1а1о92->Е1]1еМаме); 
} 
} 
// Оператор обратной связи 
АТЬгеаа->Соппес&1оп->Иг1 еп ("Файл " + $ + " получен"); 
} 
е1зе 
{ 
// Прием текстового сообщения 
5 = АТЬгеаа->СоппесЕ1оп->ВеааГл (СНАВО); 
В1срЕа12->Ъ1пез->Ааа ("Получено " + Еогма&Ра®еТ1ме ("",Мом()) + 
и; "+ ЭРгом); 
В1свЕа12->1Г1пез->Ааа (5$); 
} 
} 
саесй (...) 
{ 
В1свЕа162->11пез->Аада ("Ошибка передачи данных"); 


} 
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} 
Е1па11у 


{ 


АТ геаа->Соппес®1оп->01$соппесе (); 
} 
} 


После начальных операторов, не отличающихся от прежнего приложения, 
читается первая строка и проверяется, не равен ли ее текст оговоренному ра- 
нее ключу “Передача файла”. Если не равен, значит, пришло текстовое сооб- 
щение. Оно читается методом Веа4АГиа, в который передается константа 
СНАВО, указывающая, что чтение происходит до появления нулевого симво- 
ла. Если первая строка соответствует условному тексту, значит, передан файл. 
Тогда следующая строка читается как имя отправителя, а третья строка — как 
имя фала. После этого пользователю делается запрос, хочет ли он сохранить 
присланный файл. Если хочет, то вызывается диалог сохранения файла, соз- 
дается файловый поток, и в него методом ВеаЯгеат заносятся присланные 
данные. В конце выполняется оператор, помеченный в коде как “Оператор об- 
ратной связи”. Его можете пока не писать, а можете написать, так как он ни- 
чему не помешает. Смысл его мы рассмотрим чуть-чуть позднее. 

Приложение готово, так что можете его тестировать, запустив на компью- 
терах сети его экземпляры. 


Рассмотренные приложения обеспечивали только одностороннюю переда- 
чу данных — от клиентского к серверному компоненту. Но в ряде случаев 
пользователю может захотеться узнать, передался ли файл адресату. Давайте 
обеспечим такую простейшую обратную связь. На рис. 9.10 для этого служит 
индикатор Подтверждение. При его включении пользователь хочет получить от- 
вет, принял ли файл тот, кому он его отправил. 

Сделать это достаточно просто. В приведенный выше обработчик 
ВЕЦеСПсК после оператора 


В1срЕа12->1пез->Ааа ("Отправлен файл " + Ореп)1а1о91->Е11еМапе); 


надо вставить оператор: 


1Е (СВескВох]1->СвескКеа) 
В1срЕа12->1пез->Ааа (ТАТСРС]1]1епт1->Веаа!пт ()); 


Если индикатор СвесКВох1 включен, то вызывается метод Веа4Ги, который 
ждет ответ от сервера. Когда этот ответ будет, его результат запишется в окно 
протокола ВлевЕдИ2. 

Ожидание ответа мы организовали. Осталось обеспечить передачу ответа 
сервера. Это уже сделано в приведенном выше коде обработчика ТАаТСР$ег- 
уег1 Ехесще. В нем вы видите оператор, обеспечивающий обратную связь — 
запись методом У\УгЦеГа текста “Файл... получен”. Этот ответ вы можете ви- 
деть в окне протокола на рис. 9.10. 

Все готово, но если вы запустите экземпляры этого приложения на двух 
компьютерах в сети, то обнаружите крупный недостаток. Приведенный выше 
оператор, ожидающий ответ от сервера, блокирует выполнение приложения, 
пока адресат не управится с файлом и не решит, сохранять ли его и под каким 
именем. А если ваш адресат ушел обедать? Ваше приложение так и будет в за- 
висшем состоянии, пока он не врнется. 

Конечно, можно было бы указать в операторе чтения конечное время ожи- 
дания. Например: 
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1Е (СЛескКВох1->Стескеа)} 
В1срЕа12->Т1пез->Ааа (ТатсрРС11еп1->Веа@апт (ЕОГЬ, 30000)); 


Но ждать 30 минут ответ пользователю вряд ли захочется. 

Другой вариант решения этой проблемы — создание отдельного потока. 
При обмене очень большими файлами это разумное решение. Но для приложе- 
ний того типа, который мы создали, есть очень простое решение. Надо помес- 
тить на форму компонент ТААюНЕгее2е со страницы библиотеки шау М5с. 
Этот компонент позволяет решить все проблемы, связанные с тем, что в компо- 
нентах [шау все соединения блокирующие. Присутствие Т1ААпИЕгее?е в при- 
ложении разрешает получать и обрабатывать все сообщения \У/т@о\з на про- 
тяжении всего времени, пока функция чтения ждет данные. 

Свойство 1ШеТипеО и компонента ТШААпиЕгее2е задает интервал време- 
ни в миллисекундах, по истечении которого функции чтения шау деактивиру- 
ются. Свойство АеЙуе, установленное в &ёгие, активизирует работу компонен- 
та. Свойство АррНсанопНаз$РногИу устанавливает приоритет для сообщений 
приложения. | | 

Если значения по умолчанию всех этих свойств вас устраивают, то ника- 
кая настройка компонента не требуется. | 

Вот теперь наше приложение полностью готово и вы можете его протести- 
ровать. | 

Впрочем, нетрудно ввести, если хотите, еще одно дополнение. В построен- 
ном приложении предполагалось, что пользователи заранее настроили свои 
формы на общение друг с другом — задали в окнах Получатель (ЕНо$$) адреса 
друг друга. Но ведь может быть, что кто-то послал вопрос с другого компьюте- 
ра, а пользователь не знает, как на него ответить, так как не знает адрес отпра- 
вителя. От этой сложности можно избавиться, если включить адрес отправите- 
ля в протокол в информацию о принятом сообщении. 

Адрес можно получить с помощью характеристик соединения Соппесйоп. 
Выше мы многократно использовали методы чтения и записи соединения. Но Соп- 
песйоп имеет также свойство Вт 1х — объект класса ТА осКе Нап е. Этот 
класс имеет ряд свойств. В частности: ГР — адрес компьютера, на котором вы- 
полняется приложение, РеегГР — адрес удаленного компьютера, с которым 
было установлено соединение, Рог — порт, который используется сервером, 
РеегРог{ — порт, используемый для соединения. Из всей этой информации 
в данном случае нас интересует РеегТР. Это адрес. удаленного компьютера, ко- 
торый мы хотим включить в протокол в информацию о принятом сообщении. 
Для этого достаточно в обработчике 1АТСРЗегуег1 Ехесще изменить два оди- 
наковых оператора, заносящих информацию в протокол: 

В1спЕаЧ12->Ь1пез->Ааа ("Получено " + ЕогтакРа*еТ1те ("",Мом()) + 


"; "+ АТЬгеаа->СоппесЕ1оп->В1па1та->РеегТР + 
СИ \"" + СсЕгом + "\""); 


Жирным шрифтом выделена измененная часть оператора. 

При внесении таких изменений в код информация в окне протокола при 
получении сообщения будет иметь вид: 

Получено 22.03.2006 12:41:00: 192.168.0.2 - "Ваня" 


Так что если пользователь захочет ответить Ване, он может скопировать адрес 
из окна протокола (в приведенном примере это 192.168.0.2), перенести его 
в окно Получатель и отправить свое сообщение. 


Сетевые службы 


10.1 Службы точного времени 


В ряде случаев приложения взаимодействуют с какой-то внешней аппара- 
турой или устройствами, к которым они должны подключаться в точно фикси- 
рованные моменты времени. Подобная задача может, в частности, возникать 
в приложениях, осуществляющих управление или регистрацию данных в ре- 
альном масштабе времени. В этих случаях желательно иметь в приложении 
механизм установки точного времени. 

_ В Интернете используется несколько стандартизованных протоколов дат 
и времени и есть серверы, сообщающие пользователям точное время. Соответ- 
ственно на странице Газ Ме! библиотеки имеются компоненты ТММОауТипе 
и ММТ!те, с помощью которых приложение может получить информацию 
о дате и точном времени. 

Компонент ММВауТ!ипе получает значение даты и времени от сервера по 
стандарту, называемому «Протокол времени суток» (О)ауйше Ргофосо|, 1983, 
спецификация ВЕС 867). Это достаточно простой протокол, который дает вре- 
мя с точностью до секунды. За ним закреплен порт 13. 

В свойстве Но$$ этого компонента должен быть указан адрес сервера точ- 
ного времени или его [Ш[Р-адрес. Вы можете, например, указать адрес 
"Иште-а.013%.соу”. Или "ф0осК.азпо.пауу.тП” — адрес сервера, считающегося 
самым точным в мире и синхронизируемого по атомным часам. Учтите, что за-` 
прос компонента серверу посылается в тот момент, когда присваивается соот- 
ветствующее значение свойству Но$$. Так что задавать адрес сервера во время 
проектирования не надо. Значение этого свойства устанавливается программ- 
но в тот момент, когда требуется узнать текущее время. 

Свойство Рог& компонента ММОауТ!те по умолчанию равно 13 и это зна- 
чение не надо изменять. Свойства ТипеОц и ВерогИ.еуе! уже рассматрива- 
лись ранее в разд. 9.2. 

Результаты запроса к серверу — текущая дата и время заносятся в виде 
строки в свойство ВауТипе “4 г. Вид этой строки зависит от того, к какому сер- 
веру вы обратились. На рис. 10.1 показано тестовое приложение (проект 
РТТ1те в каталоге [птегпеё для С+-+Ви!9ег 6 на приложенном к книге диске), 
демонстрирующее пару вариантов. 

Верхняя строка соответствует серверу Ите-а.п13.500. Это сервер Нацио- 
нального института стандартов и технологий (Ма\1опа! ши жщфе о? З{апдага$ 
ап Тесвпо]о=у) СПГА. Строка, возвращаемая этим сервером, имеет формат: 


49999 УВ-МО-РА НН:ММ:$$ ТТ Г Н пзАБУ ОТС (МТ5Т) * 
Например: 
53163 04-06-07 18:10:31 50 0 0 150.3 ОТС (МтТЗт) * 


Первые 5 символов, обозначенные в формате как “44444”, — это число, 
с помощью которого, прибавив к нему 24000000, можно найти номер текущего 
дня с начала нашей эры. Вряд ли это вас заинтересует. Следующая часть стро- 
ки "УВ-МО-ОА” — это две последние цифры года, номер месяца и дня. Далее 
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Рис. 10.1 > Службы времен 


Тестовое приложение серверов точного времени Марте Но = "бие-а ван ро" 


[531 63 04-06-07 18:10:31 50 0 0 150.3 ИТС(М5Т}* 
МЫБауГте Ноз! = ЧюсК.изпо.пачу. м” 
[Моп и 0? 18:10:32 9ТС 2004 


ММТите НозЕ = "пе. п доу" 


[18:10:33 


ММТте НозЕ = "тел доу" с поправкой 


[18:10:33 


14ЧВауТипе Ноз( = "бте-а.гиз доу” 


[531 63 04-06-07 18:10:34 5000 323.9 УТС(М$Т) * 


191 те Ноз( = "бте-а. 0 доу" 


[07.06.2004 22:10:34 


м Установить время 


следует время в формате "НН:ММ:$5” — часы, минуты, секунды. Число 
"ТТ" — это закодированная информация о текущем стандарте времени СТТА и 
о числе дней до перевода времени на зимний или летний стандарты. Число "Г." 
характеризует коррекцию, которая будет сделана в текущем месяце: 1 — до- 
бавление секунды, 2 — вычитание секунды, О — коррекции не будет. Дело 
в том, что период вращения Земли не равен в точности 24 часам. Постепенно 
накапливается погрешность, которая и ликвидируется подобными коррекция- 
ми. Число "Н"” характеризует техническое состояние сервера: 0 — все нор- 
мально, 1 — возможна погрешность в 5 секунд, 2 — данные сервера недосто- 
верны. Число "шзАПУ” указывает число миллисекунд, которое советуют при- 
бавить к времени, полученному с сервера, чтобы компенсировать задержку 
в сети. Обозначение "ОТС(МЗТ)”" говорит о том, что это согласованное универ- 
сальное время (Соог1тафеа Ошуегза| Тиие — ОТС или время по Гринвичу), 
и что оно выдано Национальным институтом стандартов и технологий США. 
Звездочка в конце подтверждает точность выданного времени. 

Вторая строка на рис. 10.1 соответствует серверу юсЁ.изпо.паиу.тИ. Тут 
формат возвращаемых данных очевиден. 

Рассмотренный компонент ММРауТ!ите позволяет получить от сервера те- 
кущую дату и время. Вероятно, в большинстве случаев это излишество, учи- 
тывая, что приложение может получать те же данные со своего компьютера, 
используя функции Оафе, Типе, Мом. Мне как-то трудно представить себе си- 
туацию, когда человек (точнее, компьютер) настолько заблудился во времени, 
что не знает даже текущей даты. Наверное, чаще надо корректировать не дату, 
а время. Это можно делать с помощью компонента ММТипе. Он получает от 
сервера только точное время по протоколу ВГС 868. В качестве адреса сервера 
можно задавать "41те.11$$.соу”. Номер порта по умолчанию — 37. Строку, со- 
держащую время, можно прочитать в свойстве Типе5 г компонента. В осталь- 
ном работа с этим компонентом не отличается от описанной выше работы 
с компонентом ММРауТипе. Результат работы компонента ММТипе вы може- 
те видеть в третьей строке на рис. 10.1. 

Работая с серверами точного времени надо помнить, что они выдают время 
ОТС. О том, как перевести его в локальное время, см. в разд. 1.15.2. Об уста- 
новке времени на компьютере см. в разд. 1.15.1. 

Точность получаемого времени может существенно пострадать, если у вас 
медленная сеть Интернета. В этом случае полезно замерить моменты времени 
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до, и после обращения к серверу, и получить их разность — общее время за- 
держки. Примерно половина этого времени — это задержка получения инфор- 
мации с сервера. Так что эту задержку полезно прибавить к полученному вре- 
мени. 

Все рассмотренное выше вы можете увидеть в приведенном далее коде при- 
ложения, показанного на рис. 10.1 (это проект Р/Т1те в каталоге [тегпет для 
С-+-+Ви!а@ег 6 на приложенном к книге диске). Это фрагмент кода, относящий- 
ся к рассмотренным компонентам. 


Уу01А _ Еаз®са11 ТЕоги]1 : :Ви®$оп1С11сК (ТОр)]ес® *5епаег) 
{ 
ху 
{ 
№ММРауТ1те1->Сапсе] {); 
№МРауТ1те1->НозЕ = "6 1ще-а.п1$36е.ао\"; 
Таре1еяЕч1+1->ТехЕ = ММПауТ1пе1->ПауТ1мезе г. боарбЕг1па (2,49); 
} 
саесп (...) 
{ 


ТаБе1еяЕа1+1->ТехЕ = "Не удалось связаться с \"&1ме-а.п1$56.доу\""; 


} 


гу 

{ 

№МРауТ1ме2->Сапсе] (); 

№ММРауТ1ме2->НозЕ = "босК.изпо.пауу.т11"; 

Таре1еаЕа1+2->ТехЕ = ММРауТ1пе2->ПауТ1тезет. заре га па (1,28); 
} 

саесВ (...) 

{ 


Тафе1еЯЕа1+2->ТехЕ = "Не удалось связаться с \"$осКк.изпо.пауу.м11\""; 


} 


гу 

{ 

ММТ1пе1->Сапсе1 (); 

ТрафбеТ1ме 11, Т2; 

71 = Тате(); 

ММТ1пе1->НозЕ = "Е 1ме.п1$е.ао0%"; 

Ап$15Ег1па Т = ММТ1ме1->Т1мебег; 

Т2 = Т1ме(); 

Таре1еаЕа1*3->Техе т; 

Таре1еаЕа1*4->ТехЕ = Т1меТо5Зег (56 гТоТ1ме (Т) + 

(4очЬ1е) (Т2 - Т1) /2.); 


1Е (СРескВох1->СфескКеа) 
{ 
ЗУЗТЕМТТМЕ ЗузеепТ1те; 
СсеебузЕетТ1мте (&бузбепТ1ме); , 
бузеемТ1ме.мНоцг = ЗЕхТоТп® (Т.бар5егт1па (1,2)); 
ЗузбемТ1щте .иМ1пиЕе = 5ЕгТоТп® (Т.ЗиббЕг1па (4,2)); 
бузсемТ1те.мибесопа = 5ЗЕгТоТпЕ (Т.баб5Ег1па (7,2)) + 
ЗЕгТоТпЕ (ТтмеТобЗек ( (4оцЬ1е) 
| (Т2 - Т1) / 2.) .За55 капа (7,2)); 
ЗеебузвемТ1ме (&бузсепТ1те); 
} 
} 
саесь (...) 
{ 


Тафе1еаЕя91*3->Техе = "Не удалось связаться с \"Е1ме.п15е.чо\\""; 


} 
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В этом приложении результаты отображаются в компонентах Гаф@йедЕан. 
Перед обращением к каждому компоненту ММОауТ!ише (их в приложении 2) 
и ММТ!те соединение с сервером разрывается методом Сапсе|. Сделано это 
для того, чтбы разрешить пользователю повторно нажимать кнопку ОК. Если 
при этом не разорвать прежнее соединение, то приложение зависнет. 

Использование каждого компонента сводится к заданию в свойстве Но$$ 
адреса сервера (в этот момент происходит соединение с сервером) и чтению ре- 
зультата с помощью свойства РауТппег или Типе “г. В компонентах 
ММО)ауТ!е в окна редактирования выводится не полная строка, а некоторая 
ее часть, просто чтобы отсечь символы табуляции, имеющиеся в строках и не 
отображаемые нормально в окнах редактирования. 

При работе с компонентом ММТ!те показано, как можно учесть возмож- 
ную заметную задержку сети. Перед открытием соединения с сервером в пере- 
менной ТТ запоминается текущее время. После получения результата текущее 
время запоминается в переменной Т2. Половина разницы между Та и ТТ — это 
предполагаемая задержка, с которой дошла до компьютера строка результата. 
В окне Гафе@е4ЕЯЕЗ отображается полученная строка. А в окне Гаф@едЕа4 
отображается время с учетом поправки на задержку сети. 

Если пользователь во время выполнения включил индикатор Установить время 
(СВесЕВох1), то в структуру Зу%зетТипе типа ЗУЗТЕМИМЕ (см. разд. 1.15.1) 
функцией деЗузетТипе заносится текущее системное время компьютера. 
Затем в этой структуре заменяются значения полей, соответствующих време- 
ни. Я предполагал, что дату на компьютере изменять не требуется. В конце 
концов, дату, если требуется, проще установить средствами У/т4о\з. В за- 
ключение функцией Зе ЗузетТ те проводится коррекция системного време- 
ни на компьютере. При этом локальное время будет скорректировано автома- 
тически. 


Мы рассмотрели компоненты страницы ГазМе, обеспечивающие связь 
с серверами точного времени (напомню, что эта страница есть только в верси- 
ях, более ранних, чем С++ВиПаег 2006). Компоненты аналогичного назначе- 
ния имеются и на странице шпау С!епт5: Т@ОауТ1те и ТаТ!те (в С++ВиП4ег 2006 
компонент ТаТйте не срабатывает). Работа с ними организуется так же, как 
с рассмотренными ранее. В свойстве Но$ф задается адрес сервера. Результат 
в компоненте 14РауТ!те читается в виде строки в свойстве ВауТ1 тег. При 
обращении к этому свойству компонент соединяется с сервером и возвращает 
строку результата, не отличающуюся от той, которую возвращает рассмотрен- 
ный ранее компонент ММОауТ!пе (см. вторую снизу строку на рис. 10.1). 
В компоненте 14Т!июе результат возвращается свойством ВафеТ!те. Но в отли- 
чие от всех рассмотренных ранее компонентов этот результат имеет тип 
ТРафеТ!те (см. разд. 1.15.1). Это очень удобно, так как облегчает дальнейшие 
манипуляции с полученным значением. Свойство ВКоипаТирЬ)е!ау представ- 
ляет собой задержку получения результата в миллисекундах. Это значение ис- 
пользуется для корректировки ОафеТ!те. | 

Ниже приведен фрагмент приложения, показанного на рис. 10.1, относя- 
щийся к компонентам шау. 


ТАаРауТ1те1->НозЕ = "&1ме-а.п15%.а0\"; 
Таре11->Сар®1оп = ТарауТ1те1->ПауТ1тезег; 
Тат1те1->Нозе = "6 1ме-а.п13$е.до\м"; 


Тафе12->СарЕ1оп = ТаТ1ще1->раееТ1пе; 
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В разд. 10.1 говорилось о необходимости учитывать задержки сети при ус- 
тановке точного времени. Но задержки сети полезно знать и для правильного 
задания значений ТипеОи{ — времени ожидания ответа практически во всех 
компонентах, работающих с сетью. 

На странице Га5$!Ме! имеется специальный компонент ММЕеВо, который 
позволяет замерить задержку в сети. Компонент ММЕесВо может помочь вам 
в случаях, когда надо протестировать сеть, например, чтобы оправданно зада- 
вать свойства ТипеОи+ всех компонентов, работающих в сети. 

Компонент посылает эхо-серверу некоторую строку по протоколу ВЕС 862. 
Копия этой строки возвращается обратно и фиксируется время прохождения 
этого запроса. Номер порта по умолчанию — 7. Посылка запроса выполняется 
методом Еево: 


Ап$156г1па __ Еазеса11 Есро (Ап515&г1пд Еспо5ег1п9а); 


Параметр ЕсвВо5&гште должен содержать текст тестовой строки. При успешной 
передаче функция возвращает тот же самый текст. Если возвращаемая строка 
не совпадает с посланной, значит, сеть исказила запрос. 

До вызова метода ЕеВо компонент должен быть подключен к серверу мето- 
дом Соппес: 


ММЕСВо1->Соппесе® (); 


Соответствующий оператор можно поместить в обработчик щелчка на ка- 
кой-то кнопке или, например, в обработчике события формы ОпСгезфе. Тогда 
в обработчике события Оп)е$фгоу надо поместить оператор, разрывающий сое- 
динение: 


ММЕСВо1->)1зсоппесе (); 


Результат — число миллисекунд, потребовавшихся на получение ответа, 
содержится в свойстве только для чтения ШМарзедТ!1те. Тип этого свойства — 
ше, т.е. это действительное число, содержащее не только целую, но и дроб- 
ную части. Перевести его, если надо, в строку можно, например, функцией 
Еоа&ТоЗ{г. | 

Компонент ММЕеВо позволяет протестировать ваше соединение Интерне- 
та при связи с одним из стандартных эхо-серверов. Но это обычно не совсем то, 
что требуется. Во-первых, часто желательно тестировать не Интернет, а ло- 
кальную сеть. А если речь идет о тестировании Интернета, то обычно интерес 
представляет связь с каким-то определенным узлом. Решить подобные задачи 
позволяют компоненты шау ТаЕево и 1ТАЕСНОЗегуег, работающие по протоко- 
лу ВЕС 862. Компонент ШАЕСНОЪегуег обеспечивает построение эхо-сервера. 
Создать такой сервер очень просто (на приложенном к книге диске он реализо- 
ван в каталоге [пу в проекте ЕсйоЗегоег, включенном в группу проектов 
РСЕсйо, но только для С++Ви!аег 6, так как в С++Ви!аег 2006 этот сервер, 
как и большинство других, не работает). Начните новый проект, перенесите на 
форму компонент ТАЕСНО$егуег со страницы |пау Зегуег$, установите его 
свойство АсЙуе равным фгие, и сохраните проект под именем Есйобегиег. 
И это все! Можете, конечно, сделать на форме какую-то надпись и установить 
у формы значение свойства У1т9ом5{жще равным \м$Миипи27ей, чтобы сервер 
запускался в свернутом виде. Откомпилированное приложение сервера вы мо- 
жете запускать в любом узле вашей локальной сети или в узле Интернета. 
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Теперь давайте построим клиентское приложение (на приложенном к кни- 
ге диске оно реализовано в каталоге [п4у в проекте ЕсйоСПет{, включенном 
в группу проектов РО Есйо). Окно этого приложения во время выполнения по- 
казано на рис. 10.2. Кнопка Эрее4ВиЙоп Соединение обеспечивает установку 
и разрыв связи с сервером. В кнопке задано значение Сгопрш@аех = 1 
и АПомАШр = фгие, чтобы кнопка могда находиться как в нажатом, так 
и в отпущенном состоянии. При переходе в нажатое состояние устанавливает- 
ся соединение с сервером, который пользователь указал в окне Хост (компо- 
нент Габ@ееЧЕаЕТ). Это может быть ГР-адрес, ОВГ, или имя удаленного компь- 
ютера, на котором выполняется серверное прилжение. При отладке можно за- 
дать адрес своего компьютера 127.0.0.1, запустив на нем же предварительно 
серверное приложение. При отпускании кнопки Соединение связь с сервером 
разрывается. 


Рис. 10.2 1; Клиент ЕСбо ^^ = 
Клиент ЕсВо Хост Посыяаемый текст 


[пусотр2 | [Это текст теста | 


Полученный текст 
Соединение 
[Это текст теста 


Время ответа (мс] 


г`Компонент--`— и 
‚ © бека ` Г ныЕсво 


Щелчок на кнопке Тестировать осуществляет посылку на сервер текста, за- 
несенного пользователем в окно Посылаемый текст (Гаф@аедЕЗЕ2). Текст, вернув- 
шийся с сервера, заносится в окно Полученный текст (Габ@едЕ аи). В окно Время 
ответа (Гаф@едЕЯ4А) заносится задержка ответа в миллисекундах. 

В тестовом приложении для версии С++ВиИ4ег 6 содержится сразу два 
клиентских компонента: Т4Есево и ММЕсво. Конечно, хватило бы одного из 
них. Два компонента я включил просто для того, чтобы продемонстрировать 
работу с обоими. Группа радиокнопок Компонент (Ва41оСгоир1) в нижней час- 
ти окна позволяет пользователю выбрать тот или иной клиентский компонент. 
В приложении для С++ВиИ4ег 2006 этой группы радиокнопок нет, так как 
компонент ММЕеВо в С++ВоАаег 2006 отсутствует. 

Перенесите на форму компонент 14ЕсВо со страницы тпау Сепб, а в С++Ви!- 
ег 6 и компонент ММЕеВо со страницы ГазН\е!. Никакой настройки компо- 
нентов делать не надо, так как их свойства Но$$ будут задаваться программно. 
Компонент ММЕесВо уже был описан выше. Так что остановлюсь только на 
ТЧЕсВо. Соединение с сервером, передача на сервер текста и разрыв соедине- 
ния осуществляется, как и в компоненте ММЕесво, методами Соппес&, ЕсВо 
и Ю15соппесё соответственно. Время задержки возвращается в свойство 
ЕсвоТ1 те. Это целое число, указывающее задержку в миллисекундах. 

Ниже приведен код описанного клиентского приложения в варианте для 
С++Ви!аег 6. | 


у01Я __Еазкса11 ТЕогт1: :брееаВа*оп1С11ск (ТОБЗесе *5епаег) 


, 


{ 
1Е (брееаВаеоп1->ромп) 
{ 
Ваа1оСгочр1->Епар1еЯ = Еа15е; 
1Е (Ва41оСгоир1->Т6етТпаех == 0) 
[ | 
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ТаЕсро1->Ноз+ = ГаБе1еаЕа1{1->Техе; 
ТаЕсво1->Соппес® (); 
} 


е1 зе 

{ 

ММЕСВо1->Ноз$Е = ГаБе1еяЕа1*1->Тех&; 
ММЕСВо1->Соппес® (); 

} . 

} 


е]15е 

{ 

Ваа1оСгопир1->ЕпаЪ1еа = &гие; 

1Г (Ваа1оСгоцр1->Т+етТпаех == 0) 
ТаЕСсВо1->015зсоппес® (); 

е1 зе 
ММЕСсВо1->01$зсоппесе (); 


Уу0о1А __Еазеса11 ТЕГогш1: : Ви ®оп1С11сК (ТОБ)есе *5епаег) 


{ 

1Е (Каа1оСбгоир1->ТеепТпаех == 0) 

{ 
Таре1еаЕа13->Техе = ТАаЕсро1->Есво (Таре1еаЕа1{2->Техе); 
Табе1еаЕа1{4->Тех+ ТаЕсво1->ЕсйоТ1ме; 


} 


е]1зе 


`ветеава Е 3->Теже = №ММЕсБо1->ЕсВо (ТаБе1еаЕа1{2->Техе); 
Таое1еаЕа1{4->Техе ММЕсро1->Е1арзеаТ1те; 
} 

} 

Вряд ли этот код нуждается в дополнительных пояснениях. Отмечу толь- 
ко, что на время соединения с сервером группа радиокнопок ВаФюСгопр1 де- 
лается недоступной. Это предупреждает возможную ошибку пользователя, 
связавшегося с сервером с помощью одного клиентского компонента, а потом 
переключившего радиокнопки и тестирующего другой компонент. 

Если вы работаете с С++Ви!аег 6, запустите созданное серверное прило- 
жение на одном из компьютеров локальной сети, затем запустите клиентское 
приложение на том же или другом компьютере и протестируйте сеть. Вы уви- 
дите, что компоненты 14ЕсВо и ММЕеВо работают одинаково. Разница только 
в том, что компонент ММЕеВо возвращает значение задержки с точностью до 
долей миллисекунд. Но это, конечно, мнимая точность и доли миллисекунд 
недостоверны. Ну а если при тестировании возвращенное значение текста от- 
личается от переданного, значит, в вашей сети имеются проблемы, и их надо 
устранять. Вы можете также проверить клиентское приложение, свя. зываясь 
с каким-то сервером в Интернете. 


Еще одну возможность проверки сетевых соединений предоставляет П\фег- 
пеф Соп{го! Меззахе Ргофосо] (1СМР) — протокол управляющих сообщений Ин- 
тернета ВЕС 792. С этим протоколом работает компонент ш4у Т1ЧТетрСВепё 
со страницы |пду СШепк (в С++ВиИаег 2006 компонент не функционирует). Он 
“пингует” заданный адрес в Интернете или в локальной сети. Слово “пинг” — 
это побуквенный перевод английского слова “ршя”, которое, в свою очередь, 
является аббревиатурой от РасКеф т4егМеф Сгорег. Пинг означает отправку ад- 
ресату специального пакета (запроса 1СМР) и получение от него отклика. По 
полученным результатам можно судить о качестве соединения с адресатом. 
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Основной метод компонента ТТЧ1ТетрСПеп — Рше. Он направляет запрос 
по адресу, указанному в свойстве Но$$, и ожидает ответа. Максимальное вре- 
мя ожидания задается свойством ВесехеТ1теоц{. Порт, используемый для 
ТСМР, обычно равен 0. 

Если соединиться по указанному адресу не удалось, то генерируется ис- 
ключение, которое надо перехватить, если не хотите увидеть сообщение об 
ошибке на английском языке. Если же отправка запроса прошла успешно, то 
при получении отклика возникает событие ОпВер!у. Заголовок обработчика 
этого события имеет вид: 


у01А _ Еазфса11 ТГогм1 : : ТаТсмрС11еп1Вер1у (ТСошропепе *Аб5епаег, 
соп5Е ТВер1у5$аеаз &АВер1у5ка®аз) 


Параметр АКеру$ава$ является указателем на структуру, содержащую 
основные характеристики отклика. Тип этой структуры объявлен следующим 
образом: 


$Егасе ТВер1убба®а$ 
1пЕ ВубезВесе1уеа; 
Апз15Ег1па РгомТрАаагез$з; 
ВуЕе МздчТуре; 
Иога беацепсета; 
10$51апеа МзКоппаТг1рТ1пе; 
Вубе Т1меТоГ1уе; 
ТВер1у5ЗеаеазТурез Кер1уббабазТуре; 
}; | 
Поле ВуеВесеуе@ содержит число принятых байтов. Поле ЕгопрА@99- 
ге5$ возвращает [Р-адрес сервера, от которого пришел отклик. Таким образом, 
с помощью компонента ТТТ етрСПеп+{ вы можете определить 1Р-адрес по соот- 
ветствующему ему доменному имени или имени ОМБ компьютера в локальной 
сети. Поле МзКоппаТерТипе содержит длительность задержки получения от- 
клика. Поле ТипеТоГлуе содержит время жизни пакета в таблице маршрути- 
затора сети. Это время зависит от операционной системы компьютера, от кото- 
рого пришел ответ. Поле Зедиепсе! — это номер посылки запроса компонен- 
том ТЧТетрСНеп+{. Поле Веру фа а$Туре определяет характер пришедшего 
отклика. Тип этого поля объявлен следующим образом: 


епом ТВер1уббафазТурез {гзЕспо, гзЕггог, гзТ1иеоц®, 
гзЕггогОпгеасваЬ]е, гзЕггогТТЕхсееаеа}; 


Значения этого типа имеют следущий смысл: 


гзЕсво 


от адресата получен ответ 


гзЕггог произошла ошибка 


г5ТипеО и время ожидания (ВесеауеТ!итеоц{) истекло, а ответ не 
получен 


гзЕггогО пгеасвае адресат недоступен 


гзЕггог ГТГ Ехсее4е4 |ответ превысил время жизни пакета 


В случае любой ошибки (т.е. если значение поля Вер1уфаба$Туре не рав- 
но гзЕево), все поля структуры АВер!у3фафа$ обнуляются. 

Рассмотрим пример программы, тестирующей соединение (проект Ртё 
в каталоге Г[пау в примерах С++ВиПаег 6 на приложенном к книге диске). 
Окно этого проекта во время выполнения показано на рис. 10.3. Все одно- 
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строчные окна редактирования на форме — это компоненты Габ@ыедЕан. 
В окне Адресат (его имя в коде`Т.ЕНо${) пользователь указывает доменное имя, 
или [Р-адрес, или имя компьютера в локальной сети. В окне Время ожидания 
(ГЕТипе) он может указать значение свойства ВесауеТ!ипеоц{. По умолчанию 
время ожидания равно 10000 мс (10 секунд). Щелчком на кнопке Пинг или на- 
жатием клавиши Етщег при редактировании исходных данных запускается тес- 
тирование. Тестирование заключается в посылке десяти запросов, чтобы полу- 
чить усредненные результаты. В окно Вас ВЕЗИ в нижней части формы выво- 
дится протокол тестирования — информация о каждом полученном отклике. 
Если отклик свидетельствует об ошибке, то в протоколе отображается крас- 
ным цветом соответствующее сообщение (например, первое сообщение на 
рис. 10.3). В других окнах приложения отображаются данные, усредненные 
по результатам десяти посылок. Если минимальное значение числа получен- 
ных байтов рано нулю, значит, хотя бы на одну посылку запроса не получен 
ответ в результате ошибки. 


Рис. 10.3 Тестирование соединения 
Приложение, Зарег. Фр 
тестирующее | ЕЙ - 1260 _ 


соединение 


Р-аирак 


| те 7 


_ ДВремя ожидания истея ло до получения ответ э 
1) получено 0 байт, задержка 0 мс, время жизни пакета 0 мс, тип сообщения 0 


И) получено 72 байт, задержка 260 мс, время жизни пакета 113 мс, тип сообщения 0 
Ответ получен 

: $2) получено 72 байт, задержка 280 мс, время жизни пакета 113 мс, тип сообщения 0 

Ответ получен 

` 13) получено 72 байт, задержка 341 мс, время жизни пакета 113 мс, тип сообщения 0 

. Вре ыя ожидания ислтекпо да пелччения ствета 

- 16) получено 0 байт, задержка Омс, время я жизни пакета 0 мс, тип сообщения 0 


_* Дам та не 


Е О С О 
р ОА И НД М 
ЗИ я. 


В Е 


Ниже приведен код этого приложения. 


106 М1пВубез, МахВуфез, АуВуеез, М1лпТлте, МахТ1ие, АуТ1пе; 
Боо1 Е1гзЕ; 


У01А _ Еаз®са11 ТЕГоги1:  ВОЕЕО1С11 СК (ТОБЗесе *Зепаег) 


Е1х$Е = (ТАаТсмрС11епе1->Нозе != ТЕНоз®->Тех®); 
ТаТспрС11еп{1->Ноз6 = ТЕНоз®->Техе; о 
ТаТспрС11еп*1->ВКесе1уеТ1теоцЕ = 56 хТоТп® (ЪЕТ1ме->Тех®); 
гу 
{ 

Бог (110 1=0; 1<10; 1++) 

ТаТспирС11еп*1->Р1па(); 


Тафе1еаЕа1+*4->Техе 
ТабБе1еаЕа1*5->Техё 
Таре1еаЕа1 Е 6->ТехЕе 
ТаБе1еаЕа1*7->Техёе 


АуВуеез / 10; 
М1пВуеез; 
МахВуеез$; 
АуТ1те / 10; 
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Табе1еаЕа1{8->ТехЕ = МлпТ1ие; 
Таре1еаЕа1{9->ТехЕ = МахТ1пе; 
} 

саесв(...) 

{ 


ЗромМез$заде ("Ошибка соединения"); 


Уу01А __ЁЕа5®са11 ТГогм1: : ТАаТстрС11еп{1Вер1у (ТСошропепе *Аб5епаег, 
соп5$е ТВКер1убфафиз &АВКер1у5$а баз) 

{ 

1Е (Е1г5®) 

{ 

М1пВубез = МахВу$ез = АВер1убкабаз.ВусезВесе1туеа; 

М1пТ1ме = МахТ1ще = АКер1у5$аЕаз$.МзВоппаТгарТ1пе; 

АуВусез$ = АуТ1ме = 0; | 

В1свЕаз*1->С1еаг(); 

ЕЁ1г5Е = Еа1$е; 


} 


АуВукез$ += АВКер1Туббаеаз$.ВусезВесе1хеа; 
АУТ1те += АКер1у5$аЕо$.МзКоппаТг1рТ1пте; 


1 (АКер1убфтаеи$ .ВусезВесе1уеа < М1пВу$ез) 
М1пВусез = АВер1убкаваз.ВуеезВесе1уеа; 
1Е (АВер1убкакоаз$ .ВуЕезВесе1уеа > МахВу%еез) 
МахВуеез = АКер1убкаеа$ .ВукезВесе1уеа; 


1Е (АВер1убеаеаз .МзВоспаТг1рТлте < МлпТ1ше) 
М1пТ1ме = АВер1уб$аба$ .МзВочпаТг1рТ1те; 
1Е (АВер] убеабаз$ .МзВоппаТг1рТ1те > МахТ1те) 
МахТ1пе = АВер1убфаеаз .МзКочпаТг1рТ1те; 


Ап$156г1па 95; 
В1свЕЯ11->5е1АЕг1Бибез->Со1ог = с1Веа; 
5м1Еср (АВер1у5баки$.Кер1у5аеазТуре) 
{ 
сазе 0: 5 = "Ответ получен"; 
В1свЕа11->бе1А Е г1Бабез->Со1ог = с1В1аск; 
Таре1е4Еа1е2->ТехЕ = АВер1у56а®аз.ЕгошТрАаагезз$; 
Таре1еаЕЯ1+3->ТехЕ = АКер1убеабаз.Т1меТо11туе; 
Бгеак; 
сазе 1: 5 = "Ошибка"; 
Бгеак; 
сазе 2: $ = "Время ожидания истекло до получения ответа"; 
БгеаКк; 
сазе 3: $ = "Адресат недоступен"; 
Ьгеак; 
сазе 4: $5 = "Ответ превысил время жизни пакета"; 
Бгеак; 


} 
В1срЕа11->1пез->Ааа ($); 
В1свЕЯ11->Т1пез->Ааа (1ТпЕТоЗЕг (АВер1у5$абаз .беаиепсета) + 
") получено " + 
ТпЕТоЗег (АВер1у5$абиз .ВукезВесе1уеа) + 
" байт, задержка " + 


ТоеТозЕг (АКер1у5$аба$ .МзКоппАТг1рТ1лите) + 
" 


мс, время жизни пакета " + 
ТпЕТобег (АВер1у5фаеа$.ТлмеТоГ1уе) + 
" мс, тип сообщения " + 


ТрЕТозег (АКер1у5$афаз$ .МзаТуре)); 
Арр11са*1оп->РгосеззМеззадез(); // чтобы отобразить строку 
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У01А __Еаз®са11 ТРГогм1: : .ЕНозЕКеуро\т (ТОБ)есЕ *5епаег, 
МОВО &Кеу, ТЕ баке 5р1ЕЪф) 


{ 
1Е (Кеу == УК_ВЕТОВБМ) 
Ви Еоп1С1]1сК (бепаег); 
} 


Рассмотрим приведенный код. В нем объявлены глобальные переменные 
МтВуе5$, МахВуёе$, АуВуе$, МшТ1те, МахТ!те и АуТипе, используемые 
в дальнейшем для расчета минимальных, максимальных и средних значений 
размера пакета и времени задержки отклика. Введена также булева перемен- 
ная Ётг$%, которая служит для индикации начала работы пользователя с новым 
адресом. 

Функция ВиНоп1СПеК является обработчиком щелчка на кнопке Пинг. 
Первый оператор присваивает переменной #гз& значение фгие, если пользова- 
тель задал в окне ЬЕНо5& новый адрес. Затем в свойства компонента Т4Тетр- 
СПепё1 читаются данные, введенные пользователем, и в цикле 10 раз выпол- 
няется посылка запроса методом Рш?г. В процессе обработки откликов, как бу- 
дет показано далее, в переменных АуВуёез и АуГипе накапливается сумма 
значений размера пакета и задержки. Так что эти суммы, деленные на 10, за- 
сылаются в окна, отображающие средние значения. В другие окна передаются 
минимальные и максимальные значения, также полученные при обработке от- 
кликов. Поскольку при соединении с адресатом может быть ошибка, вызы- 
вающая генерацию исключения, использован блок {ту ... сайеВ, обеспечиваю- 
щий перехват исключения. 

Функция 1@ИетрСЦеп1Кер!у является обработчиком события ОпВер!у 
компонента 1Ч@{етрСПеп{ 1. Если Яг$$ = фгие, обрабатывается первый отклик 
после смены пользователем адресата. В этом случае переменным МтВубез$, 
МахВуёе$, МшТ!те и МахТ!пе задаются начальные значения, равные прочи- 
танным в отклике АВеру5$афа$. Переменные АуВуёез и АуТГ!те, в которых 
будут накапливаться суммы, обнуляются. Очищается окно В1е ВЕЧИ1 и пере- 
менной ЁЙг$$ф задается значение #а15$е. Следующие операторы формируют сум- 
мы, минимальные и максимальные значения соответствующих величин. За- 
тем в операторе змЁеВ формируется строка, содержащая характер полученно- 
го отклика. Предварительно цвет текста текущего абзаца в окне Васе БЕЯ] за- 
дается красным. И только в случае благополучного получения отклика он за- 
меняется черным. В этом же случае в окна заносится полученный [Р-адрес 
и время жизни пакета. 

Затем в окно Вае ВЕЧЫ1 заносится сформированная строка, а после нее — 
строка, отображающая полученные характеристики отклика. Последним опе- 
ратором вызывается метод Ргосез5Меззасе$ объекта Арр|сайНоп. Этот метод 
прерывает выполнение приложения до тех пор, пока не разгрузится очередь 
направленных ему сообщений У! ш@4о\з. Благодаря этому строки успевают. 
появиться в Вас вЕЧИ1. Если бы этого оператора не было, окно Вас ВЕЯЦ1 за- 
полнилось бы только после окончания всего процесса тестирования. 

Последняя функция приложения ГЕНо$&Кеуб)омп является обработчи- 
ком событий ОпКеудо\ут окон ЕЕНо$$ и ГЕТ!те. Назначение обработчика — 
запустить тестирование, если пользователь, работая с этими окнами, нажал 
клавишу Етщег. | 
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10.3 Кто есть кто? 


В некоторых случаях возникает задача просканировать какую-то сеть или 
какой-то домен, чтобы получить о нем информацию. Это может потребоваться, 
например, если вы хотите зарегистрировать свой сайт в какой-то зоне, и вам 
надо узнать, свободно ли задуманное имя. Или вы хотите отыскать какой-то 
домен, имя которого вы не очень хорошо помните. 

Для решения подобных задач имеется протокол М№1сКпаше или \Во!$ — 
ВЕС 954. С этим протоколом работает компонент шау Та\’,Ъот$. В его свойст- 
ве Но${ надо указать адрес сервера, имеющего сервис \!По15. По умолчанию 
в этом свойстве указан адрес "\/По1$.114егп1с.пеф”. Этот сервер обеспечивает ин- 
формацию о доменах в зонах СОМ, ОВС, МЕТ. Так что если это вас устраивает, 
то можете оставить все настройки компонента ТТА\Во1$ по умоланию. 

Основной метод компонента — УВо{5: 


Ап515&г1па __ Еаз®са11 МПотТ$ (сопзЕ Апз15Ег1па Арома1п); 


Аргументом в него заносится имя домена, функция производит соответст- 
вующий опрос сервера \У/Юо1$ и возвращает информацию в виде строки стан- 
дартизованного вида. 

На рис. 10.4 показан пример построения клиента службы \У/о1$ (на при- 
ложенном к книге диске вы найдете его в каталоге [пду в проекте И’Рогз). Сле- 
ва вверху расположено окно ЕЯ], в котором пользователь может задать 
[Р-адрес, имя сети или адрес домена. Ниже расположено окно Е912, в котором 
пользователь может указать сервер \Бо1$. По умолчанию в окно занесено 
"`\Бо1$.1егп1с.пеф”. Справа на форме расположен компонент Вале ВЕАЦ, в кото- 
ром отображаются результаты запроса. 


Рис. 10.4 ‚^ Компонент 14\ Но: 1 - служба УВо5 
Клиент службы \М/Вои5 ри ен. |Р-адрес [Остап патез пе сот апа пе дотаиз сап пом Бе теб 

_ о ‘егед 
| Сеть, до ы ыы ии папу ФИегег( сотрейид гедскагз. бо {о ВИр: /Алнлии ищетс.пе( 


[Весоттеё юг деаед могтаноп. 


| ботам Мате: ЯЕССОМ.МЕТ 
Сяужба МНО Аедзнаг. ЧЕТ\УОНК 5ОЦУТ!0М$, 1МС. 
\Мрою бегуег. ино. пенмоКзоиНоп$. сот 


— | | Аеепа УВЕ: ВЫр: /Алллих. певмоГКзоМоп$. сот 
[повете ле Мате бегуег №5.5РВ.5И 


Мате бегуег. №51.АВЕГСОМ.АУ 
Мате бегуег. М5.ВУ.МЕТ 
бцаи$: АСТ№МЕ 

Урдаеч Ба: 16-ап-2003 
Стеаноп Вае: 31-4ап-1995 
Ехриайоп ба(е: 01-1еЬ-2005 


Задав имя сети или домен и щелкнув на кнопке Найти, пользователь может 
получить соответствующую информацию в окне ВлецВЕЧЁ, включая дату созда- 
ния, обновления, список серверов и т.п. После этого пользователь может взять 
имя какого-то сервера из окна В4е ВЕН (например, "№51.ВЕГСОМ.ВО” для 
сеанса, показанного на рис. 10.4), перенести его в левое верхнее окно и полу- 
чить информацию об этом сервере. 

Весь код этого неслабого приложения сводится к двум операторам обработ- 
чика щелчка на кнопке: | 


Та\по1$1->Но$Е = Еа1е2->ТехЕ; 
В1свЕа1{1->Техе = Та\ро1$1->МНотТ$ (Еа1&1->Тех®); 


Первый оператор заносит в свойство Но$$ адрес сервера \/о1$, заданный 
пользователем в окне Е9142. А второй оператор вызывает метод \Во4[$, переда- 
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ет в него имя домена, заданное в окне ЕЗИ\1, и заносит результат в окно 
В1еВЕЗИ1. Не правда ли примитивно просто? 


10.4 Работа с протоколом ЕТР. 
10.4.1 Компонент ММЕТР 


Протокол ЕТР (спецификация ВРС 959) широко используется в Интернете 
и в локальных сетях для организации обмена файлами. Часто он использует- 
ся, когда вы копируете на свой компьютер файлы программ, найденные в Ин- 
тернете. С помощью протокола ЕТР вы можете переносить в выделенную вам 
домашнюю страницу на сервере файлы со своего компьютера. Вы можете так- 
же использовать этот протокол для обмена файлами с другими пользователя- 
ми Интернета, если у вас и у них на компьютерах установлено соответствую- 
щее программное обеспечение. 

В Интернете каждый \УМе-узел имеет свой сервер ЕТР. Только для доступа 
к каталогу сервера или части этого каталога надо указать свой идентификатор 
и пароль. На большинство серверов ЕТР можно также зайти по паролю 
"“апопутоиз”, указав в качестве своего идентификатора адрес своей электрон- 
ной почты. Правда, при таком анонимном входе содержимое сервера может 
казаться пустым. 

С+-+ВиПаег позволяет создавать свои специализированные программы, ра- 
ботающие с серверами ЕТР. Для этого в С++ВиИ4дег 6 служит компонент 
ММЕТР, расположенный на странице ГазМе!. Его свойства, которые надо за- 
дать, прежде чем соединяться с сервером ЕТР: Но5$ — адрес сервера, 
Озег Ш) — идентификатор пользователя и Раззмог@ — пароль. После этого 
можно соединяться с сервером методом Соппесф. Например, операторы 

ММЕТР1->НозЕ = ЕНоз®->Техе; 

ММЕТР1->ОзегтТр = ЕГод1п->Техе; 


ММЕТР1->РаззмогаА = ЕРЗИ->ТехЕ; 
ММЕТР1->СоппесеЕ (); 


формируют необходимые для соединения ММЕТР свойства из окон редактиро- 
вания ЕНо$$, ЕГошт и ЕРЭУ\У/ и осуществляют попытку соединиться с сервером. 
Если эта попытка будет успешной, то после соединения возникнет событие Оп- 
Соппесф, в обработчике которого можно предусмотреть какие-то действия, кото- 
рые необходимо выполнить при установке соединения. Если попытка соедине- 
ния окончилась неудачей, то в зависимости от вида ошибки возникают различ- 
ные события. Событие ОпшуаНЯНо$$, заголовок которого имеет вид: 


\01А __Еаз®са11 ТГогм1 ; : ММЕТР1 Тпуа11АНоз$%* (роо1 &Напа1еа) 


возникает, если адрес сервера ошибочный или, например, компьютер не имеет 
выхода в сеть. Если в обработчике события установить параметр Нап ед в #а]- 
зе, то будет генерироваться исключение. Если установить НапШед в фгие, то 
будет сделана еще одна попытка соединиться. Это имеет смысл, если в обра- 
ботчике делается попытка исправить ошибку. Например, следующий код дает 
возможность пользователю изменить адрес сервера: 


\01А __Еаз®са11 ТГогш1 ; : ММЕТР1Тпуа11АНоз% (роо1 &Напа1еа) 
{ 
Ап$15г1па 5$ = ММЕТР1->Но5Е; 
1Е (ТпраеОцегу ("Не существует сервера " + $5, 
"Введите, пожалуйста, правильное имя сервера:", 5)) 


{ 
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ММЕТР1->Ноз® = $ 
ММЕТР1->Соппесе® ( 
Напа1еа = +гое; 
} 

} 

При возникновении ошибки пользователю предъявляется диалоговое окно 
(рис. 10.5), в котором он может изменить адрес сервера и нажать ОК. Если 
пользователь нажмет кнопку Сапсе| , то повторной попытки соединения де- 
латься не будет. ` 


); 


Рис. 10.5 невозможно соединение с Йр.Четовб. 
Диалог задания нового адреса сервера Пе Г И 


При неверном указании идентификатора пользователя или пароля возни- 
кает событие ОпАц{ еп са НопЕа!ед. В него передается параметр НапШЩед, 
аналогичный описанному выше. Если не указан идентификатор пользователя 
или пароль, возникает событие ОпАц еп Я саНоп М№ееде4 с аналогичным пара- 
метром НапЩед. 

Окончание соединения с сервером осуществляется методом О1зсоппесф. 

В компоненте определен ряд методов, позволяющих оперировать с файла- 
ми на сервере. Метод СВапгеП!:г: 


Уу01А __ Еаз®са11 Спапдер1г (Апз15Ег1па Р1гМапе); 


изменяет текущий каталог на сервере на заданный аргументом ОМате. Ме- 
тод Ороаа: 


У01А __ Еаз®са11 Ор1оаа (Апз15Ег1па Госа1Е11е, Ап$156г1па КемофеЕ11е); 


копирует файл с компьютера пользователя на сервер. Параметр Госа!Е Пе ука- 
зывает имя копируемого файла. Если файл расположен не в текущем катало- 
ге, то должен быть указан полный путь к нему. Параметр КкетофеЕе опреде- 
ляет имя создаваемого файла на сервере. Файл копируется в текущий каталог 
сервера. Если файл с этим именем уже имеется, он заменяется копируемым 
файлом. 

Методы Свапое)!: и Ороа@ удобно использовать последовательно: снача- 
ла изменяется текущий каталог на тот, куда надо копировать файл, а затем 
файл копируется, причем его имя указывается без пути. 

Существует еще три метода, связанных с копированием файлов на сервер. 
Метод Орюоа4Аррепа: 


у01А _ Еаз®са11 Ор1оааАррепа (Ап$15Ег1п9 Госа1Е11е, 
Ап515&г1па ВемофеЕ11е); 


отличается от ОФроа4 только тем, что если файл с указанным именем уже име- 
ется на сервере, то копируемый файл добавляется в конец файла, расположен- 
ного на сервере. Метод Орюа9ЯОщадие: 


Уу01А __ЕазЕса11 Ор1оаа0п1аче (Ап$15&г1п9 Госа1Е11е); 


отличается тем, что имеет только один параметр — имя файла на компьютере 
пользователя. Если на сервере файл с таким именем уже имеется, новому фай- 
лу будет автоматически дано новое уникальное имя. 


10.4 Работа с протоколом ЕТР 823 


Метод Орюа4Везфюоге: 


Уо1Аа __ЁЕазеса11 Ор1оааВезеоге (Апз15&г1па Госа1Е11е, 
Ап$15Ег1лпа КетофеЕ11е, 1пЕ Ро$1Е1оп); 


используется для продолжения копирования файла, если предыдущая попыт- 
ка копирования прервалась до своего завершения. Метод предполагает, что 
часть файла с именем ВетоеЕ Пе уже имеется на сервере. Параметр Роз1 оп 
указывает позицию, начиная с которой продолжается копирование файла. 

В процессе копирования файла на сервер происходят события ОпРаске{- 
Зеп&. В обработчике этих событий можно отображать пользователю ход полу- 
чения файла. При этом можно использовать свойства ВуёезЗеп{ — отправлен- 
ное число байтов и ВУе$Тофа| — общее число байтов, которые должны быть 
переданы. Например, обработчик события ОпРасКке еп может содержать 
оператор: | 

Зсаби$Ваг1->5$1тр1еТех® = "передано " + ТпЕТо5ехг (ММЕТР1-> Вубезбепеё) + 

" байтов из " + ТпЕТобег (ММЕТР1->ВусезТофа1); 


Свойства Вуёез Зет и Вуе5Тофа! можно также использовать для отобра- 
жения диаграммы передачи файла с помощью компонента Ргоргез$Ваг. 


Имеется два метода копирования файла с сервера ЕТР на компьютер поль- 
зователя. Основной из них — Вомщоаа: 


уо1а __ Еазеса11 Ромип1оаа (Ап515&г1пд ВемофеЕ11е, Ап5з156г1па Госа1Е11е); 


Параметры ВешофеЕ Це и Госа1 Ее имеют тот же смысл, что и в предыдущих 
методах: имена файла на сервере и компьютере пользователя. Метод Вом]о- 
а4Везфоге: 


\01А __Еазса11 Ромп1оааВез®оге (Апз15Ег1па ВемофеЕ11е, 
Ап$156г1па Госа1Е11е); 


продолжает копирование файла, прерванное ранее по каким-то причинам. 
При этом какая-то часть файла Госа Ее уже должна находиться на компью- 
тере пользователя. Надо оговориться, что не все серверы ЕТР поддерживают 
продолжение копирования файла. 

В процессе получения файла с сервера происходят события ОпРасКкеф- 
Бесуа. В обработчике этих событий можно отображать пользователю ход по- 
лучения файла. При этом можно использовать описанные ранее свойства 
Вуе5Кесу4 — полученное число байтов и ВуёезТофа! — общее число байтов, 
которые должны быть получены. Например, обработчик события ОпРаесКке{- 
Кесу4 может содержать оператор: 


ЗсасизВаг1->$51тр1еТехе = "получено " + ТпЕТобЕг (ММЕТР1Т->ВубезВесуа) + 
" байтов из " + ТпЕТо5ег (ММЕТР1->ВубезТофа1);. 


Свойства Вуёе$Весу4 и ВуёезТофа1 можно также использовать для отобра- 
жения диаграммы передачи с помощью компонента РгоргеззВаг. 

С файлами и каталогами на сервере можно производить еще ряд операций. 
Процедура Ваефе: 


у01А __ЕазЕса11 Ре1ефе (Ап$15&г1па Е1]епапе); 
удаляет файл ЕЦепаше на сервере. Процедура ВетоуерВиг: 
у01А _ Еаз®са11 Ветоуер1г (Апз15%г1па ОР1гесбогуМаще);. 
удаляет каталог ОлгесогуМате на сервере. Процедура МаКеП!гесфогу: 


У01Я __Еаз®са11 Макер1гескогу (Ап$15%г1п9 21гесфогуМаме); 
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создает на сервере каталог ОгесвюогуМате. Во всех этих методах, если путь 
к файлу или каталогу не указан, подразумевается, что работа идет с текущим 
каталогом. 

Процедура АПосафе: 


\у01А __Еаз®са11 А11осафее (114 ЕГ11еб17е); 


выделяет на сервере память размера ЕЦе512е под новые файлы. Надо отме- 
тить, что далеко не все серверы ЕТР поддерживают эту команду. 
Процедура ВоСоттапа: 


У01А __Еазеса11 РоСоптапа (Ап515&г1п9 Сопштапа$ег); 


выполняет на сервере какую-то нестандартную команду Соттап95%хг. Это мо- 
гут быть команды, оперирующие сразу с группой файлов или иные команды, 
поддерживаемые данным сервером. 

Процедура 11$: 


у01А __Газ®са11 115% (%014); 


создает список файлов и подкаталогов текущего каталога сервера. Характер 
выполнения этой процедуры зависит от значения булева свойства РагзеГл$$. 
Если РагзеГ1$& = фгие, то список файлов и подкаталогов можно прочитать 
в свойстве ЕТРПОгесфогуГ! 13%. Это объект, содержащий в виде элементов типа 
Т5{те$ списки имен файлов (Маше[1]), их размеров (512е[1]), дат их послед- 
него изменения (Мод !Оа*е{1]) и атрибутов (АИгфи®е)). Все списки одинако- 
вой длины и последовательность расположения в них информации о файлах 
и каталогах одинакова. Например, эту информацию можно отобразить в окне 
Мето с помощью следующего оператора: 


Еог (1= 0;1 < РГогм1->ММЕТР1->ЕТРО1гесеогу11$&->паме->Соип®;1++) 


{ 
Коги1->Мемо1->Ь1пез->Аада ( 


Еогт1 ->ММЕТР1->ЕТРО1 гесвокутЪ1 з*->папше->5к1п9$[1] +" " + 
Гогм1->ММЕТР1->ЕТРО1гесфогу1156->$512е->56г1п1п9$[1] +" " + 
Гоги1 ->ММЕТР1->ЕТРР1гесфогур1$Е->Моа1 ЕРафе->56г1па$ [1] +" " + 


РГоги1->ММЕТР1->ЕТРО1хесфогу1Г 1$ ->Абег1Баке->5ег1па$ [1]); 
} 


В результате вы получите в окне Мето]1 текст вида: _ 


Ь1п 512 Фап 18 2004 а--х--х--х 

еЁёс 512 Фап 18 2004 а--х--х--х 

1пЕогма®*1опа1 512 Фап 6 1999 агихг-хг-х 
па1]1зеху.РГАО 12303 Фап 24 1998 -хми-г--г-- 
па11зег\у.РГАО.м1п 12303 Арг 21 1998 -ги-г--г-- 
оп11пе.ГАО 66265.Мау 25 1998 -гм-г--г- 


Первая часть каждой строки — имя файла или каталога (Мате[1]). Далее вы- 
водится размер в байтах (5317е[1]). Так как размер выводится как строка, то 
если вы хотите использовать размер в каких-то операциях, надо перевести 
функцией Э&ёгТоП\ значение 512е[1] в целое число. Дата, как вы видите, воз- 
вращается в виде строки с английским текстом. Так что, если вы хотите ее 
как-то использовать, надо осуществлять синтаксический разбор значения Мо- 
4!Ла ве]. Атрибуты содержат информацию о типе элемента и правах доступа 
к нему: для чтения, записи ит.п. Первый символ "4" соответствует каталогу. 
Другой способ получения информации о файлах и каталогах в процессе 
выполнения метода 11$% — использование обработчика событий Оп! $ щет. 
Эти события наступают при получении очередного элемента списка файлов 
и подкаталогов текущего каталога сервера. Заголовок обработчика имеет вид: 
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у01А __ЕГаз®са11 ТГоги1 : : ММЕТР1 115% Тем (Ап$156г1па 11$61п4а) 


Параметр Г15Япе содержит информацию об очередном элементе. Ниже 
приведена первая строка листинга. Она содержит общую информацию. Это ос- 
новное отличие от приведенного выше фрагмента списка: 


соба1 732 


При РагзеГ! 156 = {гие можно получать информацию о файлах или из свой- 
ства ЕТРОлтгесфогу[ $$, или в обработчике ОпГ1 $ Цет. А при РагеГ!.1$4 = Ёа]5е 
свойство ЕТРПО!гесфогу[Г 1$ не заполняется, так что единственный вариант — 
использование обработчика Оп! $ Ццет. 

Помимо рассмотренного метода [1$ имеется также метод №1$%$, аналогич- 
ный рассмотренному, но возвращающий только имена файлов и каталогов. 

На формат списка влияет свойство Уеп@дог. Оно должно содержать имя 
производителя сервера ЕТР. Эта информация используется компонентом при 
выборе формата вывода списка. Если имя производителя неизвестно, исполь- 
зуется имя по умолчанию ММО АОТО (численное значение 2411). В этом 
случае компонент ММЕТР пытается сам определить имя производителя. 


В случае успешного выполнения любого метода наступает событие ОпЗис- 
се55. Заголовок его обработчика имеет вид: 


У01А __Еаз®са11 ТЕогт1 : :ММЕТР1$иссезз (ТСтатуре Тгапз_Туре) 


Значение параметра Тгап$_Туре указывает тип выполненного метода или 
завершенной команды. Ниже приведен обработчик события ОпЗиссе$$, ото- 
бражающий в окне Мето1 протокол работы. Из текста этого обработчика вам 
станут понятны возможные значения Тгап$_Туре и их смысл. 


у01А _ Еаз®са11 ТЕогш1:; ; ММЕТР15ассез$ (ТСшАТуре Тгапз_Туре) 
{ 
зм1ЕсВ( Тгапз_Туре) 
{ 
сазе смаГр1$%: Мепо1->1пез->Ааа ( 
"Чтение списка файлов завершено"); 
БгеаКк; 
сазе смЯаСРапаер1г: ` Мемо1->1пез->Ааа ( 
"Текущий каталог на сервере изменен"); 
Бгеак; 
сазе спаМаКер1г: Мепо1->11пез->Ааа ( 
"Создан новый каталог на сервере"); 
| Бгеак; 
сазе стаП,е1е{е: Мето1->Т1пез->Ааа ( 
"Файл на сервере удален"); 
БгеаКк; 
сазе стАВетохуер1г: Мемо1->Ъ1пез->Ааа ( 
"Каталог на сервере удален"); 
Ьгеак; 
сазе стаВепапе: Мепо1->Ь1пез->Ааа ( 
"Файл на сервере переименован"); 
Бтеак; 
сазе стА0ОрВезфкоге: Мепо1->11пез->Ааа ( 
"Завершена прерванная ранее загрузка файла на сервера"); 
Ьгеак; 
сазе смАПомпВезфоге: Мето1->Ь1пез->Ааа ( 
"Завершена прерванная ранее загрузка файла с сервера "); 
Бгеак; 
сазе спАПомп1оаЯ: Мепо1->Ъ1пез->Ааа ( 
"Завершена загрузка файла с сервера"); 
ргеаКк; 
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сазе сма0Ор]1оаа: Мепо1->Т1пез->Ааа ( 
"Завершена загрузка файла на сервер"); 
Ьгеак; 
сазе спаАррепя: Мепо1->Ь1пез->Ааа ( 
"Завершена загрузка в конец файла на сервере"); 
Ьгеак; 
сазе ставеТп1е: Мето1->Г1пез->Аада ( 
"Связь с сервером разорвана")}; 
БтгеаКк; 
сазе спа9А]11осаке: Мепо1->Г1пе$5->Ааа ( 
"Место на сервере выделено"); 
Ьгеак; 
сазе ’смаМЬ1$%: Мето1->1пез->Ааа ( 
"Получен список имен файлов"); 
Ьгеак; 
сазе смароСотталпа: Мемто1->11пе5->Ааа (_ 
| "Выполнена команда на сервере"); 
БгеакК; 
сазе смАСиггеп®е01т: Мето1->Ь1пез->Ааа ( 
"Получен элемент текущего каталога на сервере"); 


Если выполнение метода или команды закончилось неудачей, наступает 
событие ОпРаПаге. Заголовок его обработчика имеет вид: 


У01А _ Еазеса11 ТРГогш1:; : ММЕТР1Еа11аге (Ъоо1 &Напа1еа, 
ТСпаТуре Тгапз_Туре) 


Параметр Тгап$_ Туре указывает тип невыполненной команды и может 
принимать те же значения, что и в обработчике ОпЭиесе5$. А параметр 
Нап Ще, если задать его равным фгие, предотвратит стандартную реакцию на 
ошибку — выдачу сообщения на английском языке. Обработчик события 
ОпЕааге, отображающий в окне протокола Мето1 сообщения об ошибках, 
может иметь вид: 


У01А __Еазеса11 ТГоги1: : ММЕТР1Га1]аге (роо1 &Напа1еа, 
ТСшаТуре Тгапз_Туре) 
| 
$м1Еср (Тгапз_Туре) 
{ 
сазе смаСрападер1г: Мепо1->1пез->Ааа ( 
"! Ошибка при смене каталога на сервере"); 


Бгеак; 
сазе смЯМаКер1г: Мепто1->11пез->Ааа ( 
"! Ошибка при создании нового каталога на сервере"); 
БгеаКк; 
сазе спаре1ефе: Мепо1->Т1пез->Ааа ( 
"! Ошибка при удалении файла на сервере"); 
ргеаКк; 


сазе смЯ9Вемохер1г: Мето1->11пе$->Ааа ( 
"! Ошибка при удалении каталога на сервере"); 
Ьгеак; 
сазе стаВепапе: Мето1->11пез->Ааа ( 
"! Ошибка при переименовании файла на сервере"); 
Бгеак; 
сазе сма0ОрВезеоге: Мето1->Ъ1пез->Ааа ( 
"! Ошибка при завершении прерванной ранее 
"загрузки файла на сервер"); - 
Бгеак; 
сазе смЯромпВезфоге: Мето1->Ь1пе$->Ааа ( 
"! Ошибка при завершении прерванной ранее " 
" загрузки файла с сервера"); 
ргеак; 
сазе смАромп1оаа: Мепо1->Ъ1пез->Ааа ( 
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"! Ошибка при загрузке файла с сервера"); 


ргеак; 
сазе сма0Ор1оаа: Мепо1->Т1пез->Ааа ( 
"! Ошибка при загрузке файла на сервер"); 
БгеаКк; 
сазе смаАррепа: Мепо1->Г1пез->Ааа ( 
"! Ошибка при загрузке в конец файла на сервере"); 
Ьгеак; 
сазе ставеТп1*: Мепо1->1пе$->Ааа ( 
"! Ошибка при разрыве связи с сервером"); 
Бгеак; 
сазе спмаА11оса*е: Мепо1->11пез->АчА ( 
"! Ошибка при выделении места на сервере"); 
Бгеак; 
сазе смаь1$%: Мепо1->11пез->Ааа ( 
"! Ошибка при чтении списка файлов"); 
Бгеак; 
сазе смамь15%: Мепо1->11пез$->ААа ( 
"! Ошибка при получении списка имен файлов"); 
Ьгеак; | 


сазе смАароСопмтаптЯ: Мепо1->Ъ1пез->Ааа ( 
"! Ошибка при выполнении команды на сервере"); 
Бгеак; 
сазе спаСаггепеО1г: Мето1->11пез->Ааа ( 
"! Ошибка при получении текущего каталога на сервере"); 


} 
Напа]еа = Егое; 


} 


10.4.2 Пример работы с сервером ЕТР 


Теперь рассмотрим пример, использующий многие из рассмотренных 
свойств, методов и событий. Только учтите, что для тестирования этого приме- 
ра вы должны иметь соответствующий доступ на сервер ЕТР. В противном слу- 
чае операции записи на сервер, удаления файлов на нем и т.п. закончатся не- 
удачей. | 

Пример построим на основе компонента ММЕТР, так что его можно реали- 
зовать только в С++Ви!аег 6. Пусть наш пример (проект РЕТР в каталоге ЕТР 
на приложенном к книге диске) включает две формы. Первая из них 
(рис. 10.6) является главной. Она обеспечивает соединение с сервером КТР 
и содержит поле Мето, в которое заносится протокол сеанса связи с сервером. 
Кнопка Соединение имеет тип Т5реедВиЙоп и имя ЭВСоппесф. Ее свойство 
АПомАПОр установлено в фгие, а в свойстве Сгоир тех задано значение 1. 
Это обеспечивает возможность кнопки фиксировать нажатое и отпущенное со- 


Основная форма приложения алые А 
[(р.детоз.зи Получен элемент текущего каталога на сервере . 

И О Получен элемент текущего каталога на сервере =. 

Имя пользователя Получен элемент текущего каталога на сервере `’ 


ия Получен элемент текущего каталога на сервере ^ 
апопутоиз Получен элемент текущего каталога на сервере ^ 


‚ Пароль ^^ 2 Получен элемент текущего каталога на сервере = 
Получен элемент текущего каталога на сервере 

[сет розги | Получен злемент текущего каталога на сервере - 
‚Получен элемент текущего каталога на сервере 


Получен элемент текущего каталога на сервере | 
Соединение [Чтение списка Файлов завершено 
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стояния. При нажатии кнопки обеспечивается соединение с сервером, и пока 
соединение действует, кнопка остается нажатой. Если пользователь щелкает 
на нажатой кнопке, она отпускается, и соединение разрывается. 

При соединении с сервером в свойства Но$$, Озег О и Разз\ога компонен- 
та ММЕТР, помещенного на форме, заносятся значения, содержащиеся соот- 
ветственно в окнах редактирования Сервер (имя окна — ЕНо$%), Пользователь 
(имя ЕГойт) и Пароль (имя ЕРЗУ)). В окне Пользователь можно задать имя 
"апопутиз", принимаемое большинством серверов, но не дающее право что-то 
на сервере изменять. В окно Пароль обычно можно занести некоторый текст, 
напоминающий адрес электронной почты. А в окне Сервер надо указать дос- 
тупный пользователю сервер. 

В окно Протокол (имя Мето1.) в процессе работы заносятся сведения о вы- 
полненных командах и о командах, при выполнении которых произошли 
ошибки. Полоса состояния внизу окна формы отображает более краткую ин- 
формацию о последней команде. 

Помимо перечисленных компонентов на форме имеется компонент главно- 
го меню МатМепи. Меню содержит только один раздел Файлы, который дела- 
ет видимой вторую форму приложения (см. рис. 10.7), если она до этого не 
была видна. 


Рис. 10.7 
Форма приложения, содержащая 
деревья файловой системы 


| Дерево файлов - 
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8 -@ СЗНагр 
8} © ОАТАВАЗЕ | 
#-@ Берн’ ы 


0$ 
гесот 
зипнпеемаге 


_ООО=О2 


мер: 9: Дата 3012109 — 


Размер: 0; Дата 29.10;:2003 15:10:18 


Эта форма содержит две панели, между которыми помещен компонент 
ЭрИЦег. Это позволяет пользователю сдвигать границу, разделяющую панели. 
Вверху каждой панели помещена метка, поясняющая назначение панели: 
"Сервер ЕТР"” на левой панели, отображающей дерево файлов на сервере, 
и "Компьютер" на правой панели, отображающей дерево файлов на компьюте- 
ре пользователя. Внизу каждой панели размещена панель состояния (имя ле- 
вой панели состояния — ЗВЕТР, правой — ЭВСотр). Основную часть каждой 
панели занимают компоненты Тгее\У1е\му, отображающие деревья файлов. Ком- 
понент на левой панели, относящийся к серверу ЕТР, имеет имя ТУЕТР. Ком- 
понент на правой панели, отображающий дерево файлов компьютера пользо- 
вателя, имеет имя ТУСотр. К элементам присоединены компоненты контек- 
стного меню РорирМепи. Меню компонента ТУЕТР имеет три раздела: Копи- 
ровать (быстрые клавиши С!-С, имя раздела — МСору1), Вставить (быстрые 
клавиши Сн|-\, имя раздела — МРазе1.) и Удалить (имя раздела — МОе1). Ме- 
ню компонента ТУСошр имеет два раздела: Копировать (быстрые клавиши 
СН-С, имя раздела — МСору2) и Встовить (быстрые клавиши Сн|-\, имя разде- 
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ла — МРазе2). На форме расположен также компонент Ипаге1!.1$&1, на кото- 
рый ссылаются своими свойствами Птарез компоненты ТУЕТР и ТУСотр. 
В компоненте ПпахеТ 1541 хранятся пиктограммы, используемые для узлов де- 
ревьев: закрытая папка (индекс 0), открытая папка (индекс 1), документ (ин- 
декс 2), диск (индекс 3). 

Пользователь может работать со вспомогательной формой рис. 10.7 сле- 
дующим образом. Сворачивание и развертывание узлов дерева производится 
обычным образом. Если требуется скопировать файл со своего компьютера на 
сервер ЕТР, то надо выполнить следующие действия: 


выделить в правой панели узел дерева, соответствующий копируемому 
узлу; 

и целкнуть правой кнопки мыши и в контекстном меню выбрать раздел Ко- 
пировать; 


и выделить в левой панели узел дерева, соответствующий папке на сервере, 
в которую копируется файл; 


и щелкнуть правой кнопки мыши и в контекстном меню выбрать раздел 
Вставить. 


Если требуется скопировать файл с сервера ЕТР на свой компьютер, надо 
выполнить следующие действия: 


и выделить в левой панели узел дерева на сервере, соответствующий копи- 
руемому узлу; 

и щелкнуть правой кнопки мыши и в контекстном меню выбрать раздел Ко- 
пировать; 


и выделить в правой панели узел дерева, соответствующий папке, в которую 
копируется файл; 

и тцелкнуть правой кнопки мыши и в контекстном меню выбрать раздел 
Вставить. 


Удаление файла на сервере производится выделением соответствующего 
узла, щелчком правой кнопки мыши и выбором в контекстном меню раздела 
Удалить. 


Ниже приведен код заголовочного файла главной формы данного прило- 
жения. 


с1аз$ ТЕоги1 : риуЪ11с ТЕогм 


{ 
}; . 


5ЕхасЕе ТТпЕ 


{ 
Ап$156х1па 1512е, ТЗАЕСкг, Г5Рафе, $01г; 
Мога ТАЕЕЕ; 

ТрРаееТ1ме Тра*ее; 


}; 


суреаеЕ ТтТпЕ *ТРТПЕ; // тип указателя на структуру 
// характеристик узла 
Ап$156г1па Р11еТтТУСошр, Е11еТУЕТР; // имена копируемых узлов 


Далее приведен файл реализации главной формы. 


#1п0с1паАе "ОЕТР.В" 
#10с11ае "ОЕТР2.р" 
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уо1а __Еаз®са11 ТЕогм]1: : $5ВСоппесеС11ск (ТОБ)есе *5епаег) 
{ 
1Е (5ВСоппес&->ромп) 
1Е (!ММЕТР1->Соппескея) 
{ 
ММЕТР1->Ноз& = ЕНозЕ->ТехЕ; 
’ ММЕТР1Т->ОзекТО = ЕГод1п->Техе; 
ММЕТР1->Раззмога = ЕРЗМ->ТехЕ; 


5сгееп->Сигзог = сгНочгС1а$$; 

ЗсабизВаг1->51тр1еТехе = "Идет соединение с сервером"; 
ММЕТР1->Соппес® (); 

ЗЕаЕазВаг1->$1тр1еТехе = ""; 


Зсгееп->Сагзог = сгреЁац]1*; 


} | 
е1зе 1Е (ММЕТР1->СоппесЕеа)} ММЕТР1->015соппесе (); 


у01А __Еаз6са11 ТГоги1:: ; ММЕТР1 Тпуа11АНоз& (роо1 &Напа1еа) 

{ 

Ап515ег1па 5; 

5 = ММЕТР1->Нозе; 

1Е (ТпраоеОцегу ("Невозможно соединение с " + $5, 
"Введите, пожалуйста, правильное имя сервера ", 5)) 
{ . 
ММЕТР1->Ноз® = $ 
ММЕТР1->СоппесеЕ ( 
Напа1еа = %гие; 
} 
е1 зе 

{ 

бсгееп->Сиагзог = сгреЕац1{; 
5ВСоппес&->ромп = Еа15$е; 
АБогЕ (); 


); 


01а _ Еа5$са11 ТКоги\1 : : ММЕТР1А Пепе 1са®1опГа11еа ( 
роо1 &Напа1еа) 


ЗПпомМе$засде ("Ошибочное имя пользователя или пароль"); 
5ВСоппес®->ромп = Еа15е; 


\у014 __Еаз®са11 ТГогм1: : ММЕТР1Соппес*1опКа11еа (ТОБ)есЕ *5епаекг) 
{ 


опомМеззаде ("Ошибка соединения"); 


бсгееп->Сигзог = сгреЁРай1*; 

5ВСоппесЕ->ромп = Еа1зе; 

АБоге® (); 

} 
ИНН ------------ 


Мепо1->С1еаг(); 

Мепо1->11пез->Ааа ("Связь с сервером установлена"); 
РЕ1]ез->ТУЕТР->богЕТуре = Сомс®г1$::$ЕМопе; 
РЕ1]1ез->ТУЕТР->Т+епйз->С1еаг(); 

Зсгееп->Сиагзог = сгНочгС1а$$; 

ММЕТР1->115$Е(); 
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\01Аа __ Ёаз®са11 ТРогт1 : : ММЕТР1 $ ассез$ (ТСмаТуре Тгапз_Туре) 
{ 
5и1 ср ( Тгапз_Туре) 
{ 
сазе спаГ1$%: ЕРЕ1]1ез->Еогир1гЕТР (); 
Мето1->Т1пез->Ааа ("Чтение списка " 
"файлов завершено"); 
1Е (!ЕЕ11е5$->\У1$151е) ЕЕ11ез->бром (); 
ЬБгеак; 
сазе смаСРрапдер1г: Мето1->11пез->Ааа ( 
"Текущий каталог на сервере изменен"); 


Бгеак; 
сазе спаМакер1г: Мепо1->Г1пез->Ааа ( 
"Создан новый каталог на сервере"); 
ргеак; 
сазе смаре1ефе: Мепо1->Г1пе$->Ааа ( 
"Файл на сервере удален"); 
БгеакК; 


сазе спаВепохе01у: Мепо1->11пез->Ааа ( 
"Каталог на сервере удален"); 


Ьгеак; 
сазе спаВепапе: Мепо1->11пез->Ааа ( 
"Файл на сервере переименован"); 
Ьгеак; 


сазе спа0рВезеоге: Мето1->11пез->Ааа ( 
"Завершена прерванная ранее загрузка файла на сервера"); 
ЬБгеак; 
сазе смаромпВезеоге: Мето1->Ь1пез->Ааа ( 
"Завершена прерванная ранее загрузка файла с сервера"); 
Бгеак; 
сазе смЯ9омп1оаа: Мепто1->11пез$->Ааа ( 
"Завершена загрузка файла с сервера"); 
| Бгеак; 
сазе стма0Ор1оаа: Мепо1->1пез->Ааа ( 
"Завершена загрузка файла на сервер"); 
Бгеак; 
сазе смаАррепа: Мепо1->11пез$->АЧа ( 
"Завершена загрузка в конец файла на сервере"); 
Бгеак; 
сазе смавеТп1ф: Мепо1->1пез->Ааа ( 
"Связь с сервером разорвана"); 
Бгеак; 
сазе спаА11осафе: Мемо1->11пез->Ааа ( | 
"Место на сервере выделено"); 


Ьгеак; 
сазе спамь1$$: Мепо1->11пез$->Ааа ( 
"Получен список имен файлов"); 
Ьгеак; 


сазе смароСоттапа: Мето1->1пез->Аада ( 
| "Выполнена команда на сервере"); 
БгеаКк; 
сазе спмаСаггепеО1г: Мепо1->Ъ1пез$->Ааа ( 
"Получен элемент текущего каталога на сервере"); 


У01А __ЁЕаз®са11 ТКогм1 : : ММЕТР1Еа11оге (роо1 &Напа1еа, 
ТСаАаТуре Тгапз_Туре) 


{ 
3м1Есп (Тгапз Туре) 


{ 


сазе смаСВапдер1г: Мето1->11пез->Ааа ( 
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"! Ошибка при смене каталога на сервере"); 


Бгеак; 
сазе смаМакер1т: Мето1->Г1пез->Ааа ( 
"! Ошибка при создании нового каталога на сервере"); 
Ьгеак; 
сазе смаре1ефе: Мепо1->11пез->Ааа ( 
"! Ошибка при удалении файла на сервере"); 
Бгеак; 


сазе сшаВетохер1к: Мето1->11пез->Аада ( 
"! Ошибка при удалении каталога на сервере"); 
Ъгеак; 
сазе смаВепаме : Мепо1->11пез->Ааа ( 
"! Ошибка при переименовании файла на сервере"); 
Бгеак; 
сазе смаОрВезфоге: Мемо1->Ъ1пез->Ааа ( 
"! Ошибка при завершении прерванной ранее " 
"загрузки файла на сервер"); 
Ьгеак; 
сазе сшаромпВезеоге: Мето1->11пез->Ааа ( 
"! Ошибка при завершении прерванной ранее " 
" загрузки файла с сервера"); 
Бгеак; 
сазе смаромп1оаа: Мето1->1пез->АЗА ( 
"! Ошибка при загрузке файла с сервера"); 
Бгеак; 
сазе сма0р1оаа: Мето1->Г1пез->Ааа ( 
"! Ошибка при загрузке файла на сервер"); 
Ьгеак; | 
сазе смаАррепа: Мепо1->.1пез->Ааа ( 
"! Ошибка при загрузке в конец файла на сервере"); 
ргеак; | 
сазе ставеТп1е: Мето1->11пез->Ааа ( 
"! Ошибка при разрыве связи с сервером"}; 
Бгеак; 
сазе спаА11осафе: Мето1->11пез->АаЗа ( 
"! Ошибка при выделении места на сервере"); 
ЪгеаК; 
сазе спа113%: Мето1->11пез->Ааа ( 
"! Ошибка при чтении списка файлов"); 
Бгеак; | 
сазе спамг13%: Мепо1->1пез->Ааа ( 
"! Ошибка при получении списка имен файлов"); 
Бгеак; 
сазе смароСомтапа: Мепто1->11пез->Ааа ( 
"! Ошибка при выполнении команды на сервере"); 
Бгеак; 
сазе смаСиггепе01г: Мето1->1пез->Ааа ( 
"! Ошибка при получении текущего каталога на сервере"); 
} 
Напа1еа = +гие; 


%у01А _ Еазфса11 ТГоги1:; :№1С11сК (ТОр]есе *5епаег) 


{ 
ЕЕ1]ез->5ром (); 


У01А _ Еазеса11 ТРГогш1: :; ММЕТР1РасКе®5епе (ТОБ]есЕ *5епаег) 
{ 
ЗЕаба5Ваг1->51тр1еТехЕ = "передано " + ТпЕТобег (ММЕТР1-> Вубезбепь)+ 
" байтов из " + ТлаЕТоЗеЕг (ММЕТР1->ВусезТофа1); 
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\01А __Еаз©са11 ТЕогм1: : ММЕТР1Раске®Весуа (ТОр]есе *бепаек) 


{ , 
СсакизВаг1->51тр1еТехЕ = "получено " + ТпЕТобскг (ММЕТР1->ВусезВесуа) + 
" байтов из " + ТмЕТо5ег (ММЕТР1->ВубезТо®а1); 


} 


Рассмотрим подробнее приведенный текст. В заголовочном файле объяв- 
лена структура ТП и тип указателя на такую структуру ТРшЁ. Структура ти- 
па ТШ присоединяется как объект к узлу, отображающему файл или папку, 
и содержит характеристики узла. Поле 1$12е — строка, содержащая размер 
файла в байтах. Поле 1ЗАЙИЙг — строка атрибутов файла на сервере ЕТР. Ранее 
было показано, в каком виде получаются атрибуты файла с сервера ЕТР. Це- 
лое поле ТАЙйг содержит атрибуты файла или папки на компьютере пользова- 
теля. Поле 13Дафе — строка, содержащая дату создания или обновления фай- 
ла в том виде, в каком она поступает с сервера ЕТР. Поле Ша типа 
Таэ{еТ!те содержит дату и время создания или обновления файла на компью- 
тере пользователя. Поле 5001г содержит имя файла с полным путем к нему. 
Различие этих строк применительно к файлам сервера КТР и компьютера 
пользователя заключается в том, что для файлов ЕТР элементы пути разделя- 
ются обратными слэшами "\”, а для файлов компьютера пользователя обыч- 
ными слэшами "/”. 

Вводятся также две глобальные переменные ЕЙетУСотр и ЕЦеТУЕТР, 
в которых хранится имя копируемого файла (в переменной ЕИеТУЕТР при ко- 
пировании с сервера и в переменной ЕИеТУСотр при копировании на сервер). 

В файле реализации вводится переменная РЁ — указатель на описанную 
выше структуру. Перейдем к рассмотрению отдельных процедур. 

Функция ЭВСоппес&СПеК является обработчиком щелчка на кнопке Со- 
единение. Если эта кнопка фиксируется в нажатом состоянии, то в свойства 
Но$, ОзегФ и Раззуог компонента ММЕТР1 заносятся тексты, введенные 
пользователем в окна редактирования ЕНо$%, ЕГосш и ЕРЗУ,, после чего ме- 
тодом Соппесф осуществляется соединение с сервером. Если при щелчке на 
кнопке Соединение она оказывается не нажатой, то методом 0О15$соппес& осуще- 
ствляется разрыв соединения с сервером. 

Функции ММЕТР ИпуаПаНо$, ММЕТР1АиШепйсанопРаЦе4 и ММЕТР1- 
СоппесйопЕаПе4 являются обработчиками ошибок соединения. Пользователю 
выдаются сообщения об ошибке, и конопка 5ВСоппес& переводится в ненажа- 
тое состояние. Кроме того, при неверном адресе сервера в обработчике 
ММЕТРИпуаПаНо$& пользователю показывается диалоговое окно, приведен- 
ное выше на рис. 10.5. В нем пользователь может исправить ошибочный адрес. 
Если он отказался от исправления, процесс соединения прерывается процеду- 
рой АБогф, чтобы избежать стандартного сообщения на английском языке. 
Предварительно задается форма курсора по умолчанию (в процессе соедине- 
ния, как будет видно далее, курсору задается форма песочных часов) и отпус- 
кается кнопка ЭВСоппесё. Аналогичные действия осуществляются в функции 
ММЕТР1СоппесйопРЕа|е4. 

Если соединение с сервером прошло успешно, вызывается функция 
ММЕТР1Соппес& — обработчик события ОпСоппес+. В ней заносится соответ- 
ствующее сообщение в окно протокола Мето1, очищается дерево в компонен- 
те ТУЕТР, устанавливается форма курсора в виде песочных часов и вызывает- 
ся метод 141$. | 

Функция ММЕТР1$иссе$$ является обработчиком события ОпЗисеез$$, на- 
ступающего при успешном выполнении любого метода компонента ММЕТРУ1. 
Если окончился метод 11$% (параметр Тгап$_Туре равен ст@1Т.1$%), то вызыва- 
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ется рассмотренная далее процедура ГогтРагЕТР, формирующая дерево, за- 
тем делается соответствующее сообщение в протоколе, и вспомогательная фор- 
ма ЕЕПез$ делается видимой, если ранее она была невидима. Остальные эле- 
менты структуры $мЁ ев, соответствующие завершению других команд, были 
рассмотрены ранее. | 

Функция ММЕТР1Еааге является обработчиком события ОпРаЦаге, на- 
ступающего при ошибке выполнении любого метода компонента ММЕТ1. Эта 
процедура была рассмотрена ранее. Функция М1СПеК является обработчиком 
щелчка на разделе меню Файлы. Функции ММЕТР1РаскеВесу4 и ММЕТР1- 
Раске еп являются обработчиками событий ОпРасКеВесу4 и ОвРаске- 
Зепф, наступающих в процессе копирования файлов, и также были рассмотре- 
ны ранее. 

Мы обсудили код модуля главной формы приложения. Теперь рассмотрим 
код модуля О(ОЕТР2 вспомогательной формы. 

В описании класса вспомогательной формы объявлена функция Еогт- 
ПГЕТР: 


с1азз ТЕЕ1]е$ : риб11с ТЕРогм 
{ 


руаБ11с: // Пзег аес]1агаЕтоп$ 


Уу01А __Газ®са11 Гогтр1кЕЕТР(); 
}; 


Ниже приведен код файла реализации вспомогательной формы: 


#1пс1аае "ОЕТР2.В" 
#1пс1иАе "ОЕТР.В" 


ТЕЕ11е5$ *ЕЕ11ез; 
ТРТрЕ РТПЁ; 
ТТкееМоае *ЕхрапаеаМ№оае ; // развернувшийся узел 


\01А __Еаз®са11 ТЕЕ11ез; : КогирлкЕТР () 
{ | 
106 1; 
ТТгееМ\№оае *М; 
// Формирование списка папок и файлов текущего каталога ЕТР 
ЕЕ11ез->ТУЕТР->5огЕеТуре = Сошс®г15 : : $ЕМ№опе; 
Бог (1= 0;1<КГогп1->ММЕТР1Т->ЕТРО1гесвогу1$6->патме->Сошпе;1++) 
{ 
РТпЕ = пем ТТПЕ; 
РТпЕ->1512е = РГогт1->ММЕТР1->ЕТРР1гескоку13%-> 
5$512е->5Ег1па$ [1]; 
Роги1->ММЕТР1->ЕТРР1гес®огу113&-> 
Моа1 ЕРа*е->5$%&г1паз [1]; 
Гогм1 ->ММЕТР1->ЕТРО1гесвогу[1$5е-> 
Абсхарабе->56г1па$ [1]; 
РТп=->5$01х = ЕГогм1->ММЕТР1->СаггепО1г + '/'! + 
Когг1->ММЕТР1->ЕТРО1гесфогу115->паме->5%г1п9$ [1]; 
№ = ГЕ11ез5->ТУЕТР->ТЕетмз->АааСср11а06)ес* (Ехрапаеамоае, 
Гоги1 ->ММЕТР1Т->ЕТРО1гесфогу1Ъ1$&->паме->5ег1па$ [1], РТПЕ); 
1Е (Еоги1->ММЕТР1->ЕТРР1гес®огу1т1$6-> 
АсЕг1рабе->5Ег1паз [1] [1] == 'а') // если папка 


РТпЕ->Т5раЕе 


РТпЕ->ТЗАЕЕГ 


{ 
№->ГпаздеТпаех = 0; 
М№->5бе1есфеаТпаех = 0; 
РЕ1 ]ез->ТУЕРТР->Тфепнз->Ааасв11а(№,"???"); 


} 
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е] зе 
{ 
№->ТмадеТлаех = 2; 
№->5е1ескеаТпаех = 2; 
} 
}//конец Еог 
Зсгееп->Сигзог = сгО,еЁЕац1*; 
КЕ1]1ез$->ТУЕТР->богЕТуре =Сомс®г1$:: $зЕВоеН; 


Уу01А __Еаз®са1] ТЕЕ11ез: : ГогаСгеа*е (ТОБ)]ес® *5епаег) 
{ 
сваг 1; 
ТТгеем№оае * М; 
ТТпЕ *РТлЕ; 
Бог (1= 'А'!;1 <= '0';1++) 
1Е (01гесфогуЕх1 56$ (Апз156у1па (1) + ":\\"))) 
{ 
РТпЕ = пем Т1ТтЕ; 
РТпЕ->1517е = ТпЕТо5ег (021$5К51ге (108(1) - 1106('а') +1) - 
21 зКЕгее (110% (1) - 1пе('а') + 1)); 
РТпЕ->ТРаке = 0; 
РТпЕ->ТЗАЕЕГ = "диск"; 
РТпЕ->ТАСфг = ЕаУо1ощетр; 
РТпЕ->$501г = Ап$156г1па (1)+":"; 
№ = ТУСопр->Гем$->Аааор)есе (МОЪЬ, 1, РЕ); 
№->ТпадеТпаех = 3; 
№->5е1ескеаТпаех = 3; 
ТУСопшр->Тфет$->Ааасв11а (№М,"???"); 


Уу01А _ Еаз6са11 ТЕЕ11е$: : ТУСопрЕхрапа1тча (ТОБ)есе *бепаег, 
ТТгее\№оае *Моае, Боо1 &А1]омЕхрап$1оп) 
| | 
ТРТПЕ РТШЕ; 
ТбеагсПВес зг; 
ТТгееМ№оае* М; 
1Е (!М№оае->НазСв11агеп) хкебагп; 
1Е (М№оае->ТмадеТптаех == 0) 
{ 
М№оае->ТтадеТпаех = 1; 
М№оае->5е1ессеаТпаех = 1; 
} 
1Е (Моае->деёЕ1гз*Ср11а()->Техе != "???") гевигп; 
бсгееп->Сиг5ог = стНочгЕС1а$$; 
ТУСомр->5богЕТуре = Сомс®г1$: : $ЕМопе; 
№Моае->де*Е1гзЕСр11аА ()->ре1еёе(); 
1Е (Р1паЕ1г$56 ( (ТРТпЕ (Моае->ПРафа) ->5$01г + "\\*.*") .с_5%г(), 
(ЕаАпуЕ11е | Еар1гескогу), зг) == 0) 
{ 
1Е (5$г.Мате[1] != '.') 
{ 
РТпЕ= пем ТТПЕ; 
РТпЕ->1$12е = ТпЕТоЗЕг ($г.517е); 
РТпЕ->ТРафе = Е11ерафеТорасеТ1ще (зг.Т1ме); 
РТпЕ->ТАЕСЕЕ = $Е.АБбЕг; 
РТпЕ->501г = ТРТЛЕ (М№оае->рафа) ->$01г + '\\'! + зг.Мапе; 
№ = ТУСопр->ТЕетз->Ааасв11а05}]есе (Мо4е, зг.Мате,РТпЕЁ); 
1Е((3:.Абег & Еа)01гесеогу) >О0) 
{ 
№->ТГпадеТпаех = 0; 
М№->бе1есфеаТпаех = 0; 
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ТУСопр->Теемз->Ааасв11а (№,"???"); 
} 
е1 зе 
{ 
№->ТмадеТпаех = 2; 
№->бе1есфеаТпаех = 2; 
} 
} 

\ур11е (Р1паМехе (5х) == 0) 
1Е (5зг.Маме[1] != '.') 
{ 

РТпЕ = пем ТЕ; 
РТпЕ->1Т517е = ТлЕТобекг (5х. 512е); 
РТпЕ->1ТПафе = Е11ерафеТораЕеТ1те (5:.Т1пе); 
РТпЕ->ТАЕЕГ = $г.АССг; 
РТпЕ->501г = ТРТТЕ (№оае- >раха) ->$50+г + '\\' + 5Е.Мапе + '\\'; 
№ = ТУСопр->ТЕепз->Ааасв11а05)ес® (М№о4е, зг.Матме, РТпЕ) ; 
1Е((5г.АБЕг & Еар1гесбогу) > 0) 
{ 
№->ТмадеТпаех = 0; 
№->5е1есееаТпаех = 0; 
ТУСопр->Теепз->АЧЯСЬ11а (М, "???"); 
} 
е]1зе 
{ 
№->ТмадеТпаех = 2; 
№->5е1есееаТпаех = 2; 
} 
} 
Р1паС1о$е ($г); 
осгееп->Сагзог = сгреЁачц1*; 
ТУСошр->богЕТуре = Сомсег13;::5ЕВо%®р; 


Уо1а __ Еаз®са11 ТЕЕ11ез:; : ТУЕТРЕхрапа1па (ТОБ]есЕ *5епаег, 
ТТгееМоае . *М№оае,Боо1 &А11омЕхрап$1оп) 

{ 

1Е (!М№оае->НазСр11агеп) гебагп; 

№оае->ТпадеТпаех = 1; 

1Е (М№оае->дееЕ1гзЕСр11а()->Техе != "???") гебагп; 
ТУЕТР->5огЕТуре = Сомс®г1$: :$ЕМопе; 
М№оае->деЕР1гзЕСр11а() ->ре1еке();: 

5сгееп->Сигзог = сгНочгЕС1а$$; 
Гоги1->ММЕТР1->СРапдер1г (ТРТПЕ (№оае- >Рата) ->501:); 
ЕхрапаеЯМ№оае = М№ае; 

РКогм1 ->ММЕТР1->Г1$е(); 


Уу01А _ Еазеса11 ТЕЕ11ез: : ТУСошрСВапде (ТОБ)есе *5епаекг, 
ТТгееМоае *Моае) 


З5ВСошр->51тр1еТехе = "Размер: " + ТРТПЕ (Моае->рафа) ->1512е + 
"; Дата " +БафеТт1меТоб*кг (ТРТпЕ (М№оае->рафа) ->ТРафе); 


\у01А _ Еазеса11 ТЕР11ез: : ТУЕТРСрапде (ТОБ]есе *5епаег, 
ТТгееМоае *М№ае) 
{ 
ЗВЕТР->51тр1еТехЕ = "Размер: " + ТРТШЕ (М№оае->Пава) ->1512е + 
"; Дата’" +ПавеТтТз1пеТобех (ТРТпЕ (№оае->рафа) ->ТПа®е); 
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Уу014 __ЕазЕса11 ТЕЕ11ез: : ТУСотрСопраге (ТОр)]есе *5епаек, 
ТТгееМ№оае *М№@ае1,ТТгееМ№оае *М№ае2, 1пе Пака, 1п6е &Сопраге) 


{ 
& (Моае2->Тмадетпаех == 2)) 


1Е ((М№оае1->ТмадеТпаех < 2) 
Сопраге = -1; 
е1зе 1Е ( (М№оае2->ТмадеТпаех < 2) & (М№оае1->ТпадеТпаех == 2)) 


Сопраге = 1; 
Ап51СопрагеТехе (М№оде1->Техе, Мо4е2->Техе); 


е1зе Соптраге = 


:: ТУЕТРСо1]арз1па (ТОБ)]есЕе *5епаег, 


Уу01а _ Еаз®еса11 ТЕЕ11ез 
ТТгееМоае *М№оае, Роо1 &А11омСо11арзе) 


{ 
1Е (М№оае->ТмадеТпаех == 1) 


{ 
М№оае->ТтадеТпаех = 0; 
Моае->5е1есфеаТпаех = 0; 


// 
у014 __Еаз®са11 ТЕЕ11ез: :МСору1С11сК (ТОБ]есЕ *5епаег) 


{ 
1Е (ТУЕТР->$е1есфеа != м0) 
) 


1Е (ТУЕТР->5е1ескеа->ТтадеТпаех == 


{ 
Е1]етуЕТР = ТРТпЕ (ТУРТР->5е1есфеа->рафа) ->$01г; 


геЁбцгп; 


} 


ЗВомМе5заае ("Нет выделенного файла"); 


// | 
Уу01Аа __Еаз®са11 ТЕЁЕ11е$: :МРаз%е1С11сК (ТОБ)есе *5епаег) 


{ 
!= М№МОЬЬ) && (Е11етУСопшр != "") ) 


1Е ((ТУЕТР->5е1ес%еа 
{ 
Гоги] ->ММЕТР1->СРапаер1г (ТРТпЕ (ТУЕТР->5е1есфеа->рафа) ->$01г); 


Гогт1->ММЕТР1-> 
Ор1оаа (Е11еТУСотр, Ех гас®Е11еМаше (Е11еТУСопр) ); 


Е11еТУСошр = ""; 
‚} 
}. 
и---нннннннннн-н--==================-======-=--- 
у01А __Еаз®са11 ТЕЕ11е5$: :МРазке2С11ск (ТОБ]есЕ *5епаег) 
{ | 

РСраг Е; 

&& (Р11етТУЕТР != "")) 


1Е ((ТУСотр->5е1есеёеа != Мо) 
{ 
= '/') +1; 


Когм1->ММЕТР1->Бомп1оаа (Р11етТуЕТР, | 
ТРТПЕ (ТУСопр->5е1ескеа->Бака) ->5$01х + '\\' + ЕЁ); 


Е = ЗЕгВ5$сап (Е11еТУЕТР.с_з%г(), 


Р11еТуУЕТР = ""; 
} 
} 
Инннннннннннннннннннннннн--нн==========-===-==== 
уо1Аа __ЁЕаз®са11 ТЕЕ11ез: :МСору2С11сКк (ТОБ]есЕ *5епаег) 
{ 
1Е (ТУСопр->5е1есееа != м0) 
1Е (ТУСопр->5е1есееа->ТтадеТпаех == 2) 
{ 
#1]еТУСомр = ТРТпЕ (ТУСопр->5е1есфеа->рака) ->501г; 
гебигп; | 


} 


ЗРомМез5аае ("Нет выделенного файла"); 


} 
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Уу01А _ Еаз®са11 ТЕЕ11е5: :МОе1С11ск (ТОБ)]есе *бепаехг) 


{ 

1Е (ТУЕТР->5е1есееа->1тадеТпаех < 2) 

ЕГКогт1 ->ММЕТР1->Вепохер1 т (ТРТпЕ (ТУЕТР->5е1есфеа->рафа) ->$01г); 
е1зе 

Гоги] ->ММЕТР1->П0е]1ете (ТРТпЕ (ТУЕТР->5е1ес*еа->Вафа) ->$01х); 


} 


Рассмотрим приведенный код. Функция ЕогтОЕТР осуществляет фор- 
мирование структуры фрагмента дерева файлов сервера, относящегося к теку- 
щему каталогу. Процедура вызывается после того, как выполнен метод [11$$%, 
дающий список файлов. Первый оператор процедуры снимает сортировку де- 
рева, задавая в свойстве ЗогёТуре компонента ТУЕТР, расположенного на 
вспомогательной форме ЕЕЦе$, значение $&Мопе. Далее следует цикл по спи- 
ску, содержащемуся в объекте ММЕТР1-—>ЕТРПГИгесфогуГ! 15%. Свойство Соип% 
этого объекта дает общее число элементов списка. 

Для каждого нового элемента списка операцией пе\м создается новая 
структура типа ТШЁ. Поля 1812е, 15афе и 1ЗАЙг этой структуры заполняют- 
ся сведениями, содержащимися в свойствах 12е, Мод !Оме и АНгЬщше объ- 
екта ММЕТР1—>ЕТРПО/!гесфогу! 1$. В поле 501: заносится текущий каталог, 
содержащийся в свойстве ММЕТР1—>Сиггеп г, далее записывается слэш 
и за ним — имя файла или папки, содержащееся в свойстве Мате объекта 
ММЕТР1-—>ЕТРПО!гес%$огу[1$$. 

Затем методом Цетз—>АЯаСЬИ9ОЩесй компонента ТУЕТР создается но- 
вый узел дерева и указатель на него — переменная М. Узел создается как до- 
черний по отношению к узлу Ехрапде4Мо4е — раскрывающемуся узлу дере- 
ва. Если функция выполняется в первый раз и еще никаких узлов в дереве 
нет, то значение ЕхрапдедМо4е = МОТТ,, что соответствует созданию корне- 
вых узлов. Проверяется первый символ атрибута созданного узла, чтобы опре- 
делить, является ли узел папкой. Если является (символ равен '4’), то индек- 
сы изображений и обычного (Ппареш4ех), и выделенного (Зеесфе Тех) узла 
задаются равными нулю. В противном случае индексы изображений задаются 
равными 2. Кроме того, для узла папки создается дочерний узел с условным 
именем "???"”. Создание этого узла преследует две цели: показать, что узел 
можно развернуть (т.е. создать около него кнопочку с символом "+" — 
см. рис. 10.7), и, кроме того, пометить, что узел еще не разворачивался 
и структура его дочерних узлов пока неизвестна. 

Предпоследний оператор функции задает в свойстве Эегееп->Сигзог вид 
курсора мыши по умолчанию. Дело в том, что формирование списка файлов 
и дерева может оказаться довольно длительной процедурой. Поэтому прежде, 
чем начать эту процедуру, курсор устанавливается в форме песочных часов. 
А данный оператор восстанавливает обычную форму курсора. Последний опе- 
ратор функции вводит сортировку дерева. 

Функция ТЕЕЦез—>ЕогтСгез{е является обработчиком события формы 
ОпСгеже и формирует в компоненте ТУСошр корневые вершины дерева фай- 
лов компьютера пользователя. Эти корневые вершины, как видно из рис. 10.7, 
отображают доступные диски. В процедуре организован цикл по именам дис- 
ков от “А:” до “Й:". Наличие того или иного диска проверяется функцией 
П1гесогуЕх15 5. Если диск имеется и доступен, функция возвращает фгие. То- 
гда операцией пем создается структура типа ТШ{. В поле 1$812е заносится 
в виде строки объем занятой памяти диска. Он вычисляется как разность раз- 
мера диска, возвращаемого функцией 013К51те, и свободного места на диске, 
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возвращаемого функцией О1зЕЕгее. В качестве параметра в эти функции пере- 
дается 0 для диска "А", 1 для диска "В" и т.д. Значение поля Шафе задается 
равным 0. В поле 1$АЩг заносится текст “диск”. В качестве значения поля 
$01: заносится имя диска, например, "а:”. Далее создается методом ЦНетз-—> 
АЯЗОБес{ узел, с которым связывается эта структура. Индекс изображения 
узла задается равным 3 — диск. Формируется дочерний узел с условным име- 
нем "???". Назначение такого узла уже рассматривалось выше: обеспечение 
кнопочки с символом "+" и указание на то, что данный узел еще не разверты- 
вался и структура его дочерних узлов пока неизвестна. 

Функция ТУСошрЕхрап а является обработчиком события ОпЕхрап- 
Чт? раскрытия узла. Параметр Моде этого обработчика определяет раскры- 
вающийся узел. Первый оператор этой функции проверяет свойство Наз- 
СВПагеп узла, указывающее, имеются ли дочерние узла. Если дочерних узлов 
нет, выполнение функции завершается. Если дочерние узлы имеются, значит 
это папка или диск. Если это папка (определяется по значению индекса пикто- 
граммы Гпарет4ех), то индекс пиктограммы задается равным 1, что соответ- 
ствует раскрытой папке. Затем проверяется, имеет ли первый дочерний узел 
условное имя "???". Если нет, значит, данный узел уже раскрывался ранее, 
и дерево его дочерних узлов было сформировано. В этом случае выполнение 
процедуры завершается, и компонент ТУСощр автоматически раскрывает 
узел, отображая его дочерние компоненты. Если же имя первого дочернего 
узла равно "???", значит узел еще не раскрывался. Тогда прежде, чем его рас- 
крыть, надо сформировать дочерние узлы. 

Формирование их начинается с того, что форма курсора мыши устанавли- 
вается соответствующей изображению песочных часов, поскольку предстоит, 
возможно, длинная операция формирования дочерних узлов. Затем снимается 
сортировка дерева (Зог Туре = зМ№опе) и первый дочерний узел с условным 
именем удаляется. Доступ к этому узлу дается методом де Е1г$СЬП@, а удаля- 
ется узел методом еее. Затем методом Ет@Е!г$ ищется первый файл или 
папка, содержащиеся в раскрываемой папке. В качестве первого параметра за- 
дается шаблон поиска. Он складывается из полного имени с путем раскрывае- 
мой папки, обратного слэша и шаблона "*.*". Например, “4:\Ассезз7\ОЁВ- 
се\*.*”. Имя папки вместе с путем берется из поля $01? структуры типа ТР, 
связанной с узлом Мо4е. Доступ к объекту структуры обеспечивается свойст- 
вом узла Моде->Ожа. Но поскольку это свойство является нетипизирован- 
ным указателем Ройцег, он приводится к типу ТРЕ. В качестве атрибутов 
искомого элемента задается гаАпуЕЙе | гаПлгесфогу, т.е. все типы файлов или 
каталогов. 

Если функция Еш@аЕ!:г$ возвращает 0, значит, искомый элемент найден. 
Тогда проверяется, не начинается ли имя найденного элемента с точки. Дело 
в том, что при развертывании папки находятся элементы с именами "."и"..", 
соответствующие переходу на верхний уровень дерева. Нам они не нужны. По- 
этому элементы с именами, начинающимися с точки, . пропускаются. Для эле- 
мента с любым другим именем выполняются уже рассмотренные ранее опера- 
ции. Создается новая структура типа ТФ. В ее поле 1$51те заносится размер 
файла — поле 912е структуры Эг, используемой при поиске. В поле ГДафе зано- 
сится дата файла (поле зг->Т!те), переведенная в тип ТОжеТипе функцией 
ЕПедж{еТора{еТ!1те. В поле ПР! заносится путь к раскрывающемуся узлу 
Мое, дополненный обратным слэшем и именем файла. Затем создается новый 
узел дерева, соответствующий найденному файлу (или каталогу). По значению 
атрибута зг->АИтг проверяется, является ли элемент каталогом. Если являет- 
ся, то индекс его пиктограммы задается равным нулю (закрытая папка) и соз- 
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дается дочерний условный узел с именем “???”, о котором уже не раз говори- 
лось. Если найден файл, то индекс его пиктограммы задается равным 2 — до- 
кумент. 

Затем в цикле осуществляется поиск остальных элементов каталога функ- 
цией ЕпАМехё. Операции в этом цикле не отличаются от только что рассмот- 
ренных. В заключение возвращается обычная форма курсора мыши и дерево 
сортируется. 

Функция ТУЕТРЕхрап те является обработчиком события ОпЕхрап- 
41 раскрытия узла в компоненте ТУЕТР — дереве файлов на сервере. Пер- 
вый оператор завершает функцию, если раскрываемый узел не имеет дочер- 
них. Затем пиктограмма узла заменяется пиктограммой открытой папки. 
Проверяется первый дочерний узел. Если его имя не равно "???", значит узел 
уже раскрывался ранее и его дочерние узлы сформированы. Тогда функция 
завершает работу. Если же надо формировать дочерние узлы, то выполняют- 
ся операции, аналогичные рассмотренным в предыдущей процедуре: снима- 
ется сортировка дерева, уничтожается дочерний узел с условным именем, из- 
меняется форма курсора. После этого методом ММЕТР1->Спвапое[ тг теку- 
щий каталог на сервере делается равным каталогу раскрывающегося узла. 
Затем переменной ЕхрапдеЯМо4е присваивается объект раскрывающегося 
узла и вызывается функция формирования списка файлов ММЕТР1-—>1[1$%0. 
После этого будет происходить формирование дерева файлов сервера. 

Функции ТУСошрСВапее и ТУЕТРСВапее являются обработчиками собы- 
тий ОпСвапге компонентов ТУСошр и ТУЕТР. Эти события наступают при 
перемещении пользователем фокуса на какой-то узел. Обработчики заносят 
в полосы состояния информацию о выделенном узле, как это можно видеть 
на рис. 10.1. 

Функция ТУСотрСотраге является обработчиком событий ОпСотраге 
и для компонента ТУСошр, и для ТУЕТР. Эти события наступают, когда 
в процессе сортировки дерева требуется определить, какой из передаваемых 
в обработчик узлов М№о4е1, или Моде? должен располагаться в дереве выше. 
Если выше должен быть Мо4е1, параметру Сошраге следует присвоить значе- 
ние —1, если выше должен быть № №од4е2, параметру Сотраге следует присво- 
ить значение 1, если узлы равноправны, параметру Сотраге следует присво- 
ить значение 0. В функции прежде всего анализируются индексы пикто- 
грамм. Если в узле М№о4е1 индекс пиктограммы меньше 2, значит это папка. 
Если при этом в узле Моде? индекс пиктограммы равен 2, значит это узел 
файла. Так как мы хотим, чтобы папки располагались выше файлов, в этом 
случае возвращается —1. Если все наоборот — узел Моде — файл, а узел 
Мо4е2 — папка, возвращается 1. А если характер обоих узлов одинаков, то 
узлы надо упорядочивать по алфавиту их имен, что делается функцией 
Ап$1СотрагеТехё. 

Функция ТУЕТРСоПарзше является обработчиком событий ОпСоПарзшя 
компонентов ТУСотшр и ТУЕТР. События наступают при сворачивании узла, 
и их обработка заключается в том, что если сворачивается узел каталога (ин- 
декс пиктограммы равен 1 — открытой папке), то индекс пиктограммы дела- 
ется равным 0 — закрытой папке. 

Функции МСору1СИсК и МСору2СПсК являются действиями при выборе 
пользователем в контекстном меню дерева раздела Копировать. В начале функ- 
ций проверяется, выделен ли в дереве узел и является ли он узлом файла. 
Если нет, то пользователю выдается сообщение об ошибке. А если выделен 
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файл, то полный путь к нему запоминается в переменной ЕИеТУСотшр или 
ЕПетуЕТР. 

Функции МРазе1СПеК и МРазе2СПеК описывают действия при выборе 
пользователем в контекстном меню дерева раздела Вставить. В начале функций 
проверяется, выделен ли в дереве узел (свойство Э@есфе4 не равно МОМ.) и за- 
дано ли имя файла, который надо копировать. Дальнейшие действия зависят 
от того, куда копируется файл — на сервер, или на компьютер пользователя. 
При копировании на сервер (функция МРазе1СПесК) сначала методом СВапёе- 
Пл: на сервере изменяется текущий каталог на тот, который соответствует вы- 
деленному узлу. А затем методом Ор]оа4 производится загрузка файла на сер- 
вер. В качестве имени файла на сервере задается имя файла на компьютере 
пользователя, выделяемое из его полного имени с путем функцией Ехёгас&- 
ЕПеМате. При копировании на компьютер пользователя (функция МРаз- 
$е2СПеК) сначала функцией 5`ВЭсап выделяется из полного имени файла на 
сервере часть этого имени, следующая за последним символом слэша "/". 
Функция В $сап возвращает указатель на послений слэш. Чтобы убрать его 
из имени, к этому указателю добавляется 1 и результирующее имя заносится 
в переменную #. Затем методом Вомщоа@ производится загрузка файла с сер- 
вера на компьютер пользователя. В качестве имени файла на компьютере зада- 
ется каталог, выделенный пользователем в дереве, и имя, выделенное из пол- 
ного имени на сервере. 

Последняя функция кода Ме СПеК соответствует разделу контекстного 
меню Удалить. Если выделенный узел отображает каталог, то он удаляется ме- 
тодом КетоуеП иг. Если выделен файл, он удаляется методом еее. 

Мы рассмотрели весь код приложения. Можете запустить его на выполне- 
ние и проверить в работе. Только имейте в виду, что выполнять операции ко- 
пирования на сервер и удаления на сервере файлов и каталогов вы сможете 
только в том случае, если имеете соответствующие права доступа. 

Рассмотренное приложение не охватывает всех методов компонента 
ММЕТР, изложенных ранее. Вы легко сможете сами дополнить приложение 
возможностью создания каталогов на сервере, записью копируемого файла 
в конец имеющемуся на сервере и т.п. Можно также изменить алгоритмы 
формирования деревьев. В приведенном приложении они формируются по 
мере раскрытия пользователем соответствующих узлов. Это предотвращает 
непроизводительные затраты памяти и времени на формирование тех частей 
дерева, которые не интересуют пользователя в данном сеансе. Но можно от- 
казаться от этого и формировать все дерево сразу. Это может потребовать 
очень больших затрат времени на формирование всего дерева файлов компь- 
ютера при запуске на выполнение, но сократит последующие затраты време- 
ни. Для дерева на сервере, которое обычно содержит немного узлов, такой 
подход, возможно, оправдан. 


10.4.3 Компонент 1АЕТР 


В семействе компонентов штау имеется свой клиентский компонент серве- 
ров ЕТР. Это компонент 1АЕТР со страницы шпау Сет (в С++Ви!аег 2006, 
к сожалению, не функционирует). Он напоминает по своим взможностям рас- 
смотренный в разд. 10.4.1 компнент ММЕТР. Адрес сервера задается свойст- 
вом Но$ф, пароль — свойством Раз\мог4. Идентификатор пользователя задает- 
ся свойством Озег. Соединение с сервером и разрыв соединения осуществляет- 
ся соответственно методами Соппес& и О15соппесё. 
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Получить список файлов и каталогов сервера можно с помощью метода 
11$: 


у01А __Еаз®са11 1,15% (С]1аззез: :Т5%&г1па5* АБе$х, 
сопзЕ Ап515%:1па Абрес1Е1ег = "", 
соп5Е Боо1 АПБефа11$ = Егае); 


Параметр АРез& класса ТЗИЛпез — это список, в который заносится ре- 
зультат сканирования сервера. Параметр АЗресЙег задает шаблон, котрому 
должны удовлетворять отбираемые в список файлы и каталоги. А параметр 
АПеа!з указывает, требуется ли указание атрибутов файлов и каталогов. 

Например, можно выполнить оператор: 


ТаЕтр1->115% (Мето1->1пез, Еа1*1->Техе, СВесКкВох1->СВескеа); 


Этот оператор заносит в окно Мето] список файлов и каталогов, удовлетво- 
ряющих шаблону, заданному в окне Е911. А состояние индикатора СВесК- 
Вох1 определяет, будут ли включены в строки списка характеристики фай- 
лов. 

Шаблон может содержать символы "*" — либое количество любых симво- 
лов, и символы “?" — любой один символ. Например, если задать шаблон 
"*.*", то будет выдан список всех файлов текущего каталога. Если задать шаб- 
лон "*", то будет выдан список всех файлов в текущем каталоге и во всех его 
подкаталогах. Но погружение в подкаталоги идет только на один уровень. 
Шаблон "*.ёхё” обеспечивает в список включение только текстовых файлов 
с расширением .{х. | | 

Вид списка зависит от значения аргумента АОеаЦЗз в вызове метода. При 
АБеа!з = Газе и шаблоне "*" список имеет вид: 

па11зегу.ЕГАО 

па11зекгу.РАО.м1п 

оп11пе.РАО 

оп11пе.КАО.м1ап 


рар/а$12е 
зирроге/т1гс502%.ехе 


С символом слэша указаны файлы подкаталогов. 
Если при том же шаблоне аргумент АБеа1$ равен фгие, то тот же фраг- 
мент списка имеет вид: 


—ги-г--г-- 1 гооЕ хкооЕ 12303 Фдап 24 1997 па115егу.РАО 


-ги-г--Е-- 1 гооЕ гоое 12303 Арг 21 1998 па11зеку.ЕАО.м1п 
-ги-г--г-- 1 гоое гоое 66265 Мау 25 1998 оп11пе.РАО 
-ги-г--г-- 1 гооЕ гоое 66265 Мау 25 1998 оп11пе.РАО.м1п 
-гм-г--г-- 1 гооЕ гооё 31368 Фап 18 1999 мим.ГАО 
-ги-г--г-- 1 гоо6 гооф 31368 ЧФап 18 1999 имм.РАО.м1п 
рУБ: 

фофа1 10 

Ягихг-хг-х 4 гооЕ гоое 512 дап 1 15:08 с5м 

-г--г--г-- 1 гооЕ гооЕ 9 Чип 9 03:30 а512е 

Агихг-хг-х 3 гооф 68 512 ОсЕ 21 1998 о5 

Агихг-хг-х 6 68 68 512 ОСф 19 1998 ге1сом 
Ягихг-хг-х 8 гоо$Е гооЕ 512 Арг 10 13:48 запЕгеемаге 
5арроге: 

фофа1 14210 | 

-ги------- 1 гооЕ гоое 1162 Зап 23 1998 „Резсгаретоп 


Как видите, в строках отражены атрибуты чтения, записи и т.п., размеры 
и даты файлов, подкаталоги и входящие в них файлы и каталоги. Например, 
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в приведенном списке в подкаталоге риб имеются покаталоги сзи, гесот, 
зип{теешаге (атрибуты начинаются с символа “4”), отсутствовавшие в сокра- 
щенном списке. | 

Метод [15% компонента ТАагтТрР. имеет как достоинства, так и недостатки по 
сравнению с методом 1[1$6 компонента ММЕТР, рассмотренного в разд. 10.4.1. 
К достоинствам относится возможность выбора типа файлов с помощью шаб- 
лонов. А недостатком, и достаточно серьезным, является то, что информация 
воспринимается только в виде паказанных выше строк, в то время как 
в ММЕТР она может храниться в свойстве ЕТРП1гесвогу1!1 $$, в котором отдель- 
ные составляющие этой информации хранятся порознь. Работая с 1АЕТР, вы 
сами должны расшифровывать полученный список. Для сокращенного списка 
это сделать несложно, Но для списка с полными характеристиками требуется 
более серьезный грамматический разбор. 

Перечислим теперь основные методы работы с файловой системой сервера. 
Метод СВапхеП!:г: 


у01А _ Еаз®са11 СПВапдер1г (сопзе Ап$15Ег1пд АР1гМапе); 


изменяет текущий каталог на сервере на заданный подкаталог АПигМате. Так 
что этот метод разрешает только спускаться по дереву каталогов. А подняться 
в дереве на один уровень вверх можно методом СВапхе 0: Ор: 


у01Аа __Еаз®©са11 Спапдер1хОр (уо1а); 


Методы МаКеП1г и Ветоуе иг: 


Уу01Аа __Еаз®са11 МакКер1г(сопзЕ Ап$15ег1па Ар1гМаме); 
Уу01А __Еазеса11 Вемоуер1г(сопз®е Ап$156г1па АР1гМапе); 


делают попытку соответственно создать на сервере или удалить каталог АП!г- 
Маше. Впрочем, чаще всего серверы не дают возможности выполнять подоб- 
ные операции. 

Метод ВейчеуеСиггеп О/г: 


Ап$156г1па _ Еазеса11 Веег1еуеСоггеп®01т(); 


возвращает текущий каталог на сервере. 
Теперь остановимся на функциях работы с файлами. Функция 512е воз- 
вращает размер указанного файла на сервере: 


116 _ Еаз®са11 $512е (сопзе Ап$156г1па АЕ11еМаще); 


Имеются две перегруженные формы метода @еф, позволяющие загружать 
файл с сервера: 
у01А _ Еаз®са11 Сеф(сопзЕ Апз15Ег1па АбоигсеЕ11е, 
С1аз5ез: :Т5&геам* Арез®); 
у01А __Еаз®са11 Сеф(сопзе Апз15Ег1па АбопгсеЕ11е, 


соп5е Ап$1бег1па АБезеЕ11е, 
соп$& РЮоо1 АСапОуегмг1Ее = Ха15е); 


Параметр АЗоигсеЕШе указывает загружаемый файл на сервере. Файл грузит- 
ся или в поток АШ,е$$, или в файл АШез Ее, создаваемый функцией на лока- 
льном компьютере. При загрузке в файл параметр АСапОуегитгЦе указывает, 
может ли переписываться файл, если он уже есть на компьютере. 
Метод Риф осуществлят обратную операцию — загружает файл на сервер: 
у014 _ Еазеса11 Раф (сопзЕ С1а$5ез::Т5Егеат* Абоогсе, 


соп5Е Ап$156г1па АБезеЕ11е = "", 
сопзЕ Роо1 ААррепа = Еа1зе}; 
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у01А __Еазеса11 Раф (соп5Е Ап$15Ег1па АбосгсеЕ11е, 
соп5$е Ап5156г1па АПезЕЕ11е = "", 
соп5Е Юоо1 ААррепа = Еа15е); 


Файл заносится на сервер под именем АБе{Е1е. Источником является или 
поток АЗоигее, или файл локального компьютера АЗопгсеЕ!е. Параметр 
ААррепа, установленный в фгие, позволяет дописывать файл в конец уже су- 
ществующего на сервере. 

Метод Ваее удаляет указанный файл на сервере: 


у01Аа __Еаз®са11 Ре1еее (сопз® Апз156г1па АЁЕ11епаме); 


Метод Вепате: 


у01А __Газеса11 Вепаме (сопзе Ап515ег1па АбоигсеЕ11е, 
соп5е Ап515Ег1па АрезеЕ11е); 


переименовывает файл АЗоигееЕПе на сервере в файл АШез Е Пе. 
Метод ЭЩе позволяет выполнить команду, указанную ее параметром 
АСоттапа: , 


у01А __ГазЕса11 $1%е (сопзе Апз156Ег1па АСоптапа); 


Эта функция используется для команд, которые не входят в перечисленные 
выше, но могут выполняться на том или ином типе сервера ЕТР. 

Метод АБогё прерывает выполнение любой операции еа сервере. Метод 
№ №шор посылает на сервер команду, предотвращающую разрыв соединения сер- 
вером при долгой паузе в общении с ним. 

Мы рассмотрели практически все методы компонента 14ЕТР. Думаю, что 
строить специальное приложение, демонстрирующее их, не стоит. Вы сами 
с помощью этих методов сможете построить заказное клиентское приложение 
ЕТР, осуществляющее какие-то необходимые вам операции с файловой систе- 
мой и файлами на сервере ЕТР. | 


10.5 Телеконференции и служба новостей 


10.5.1 Серверы новостей и телеконференции 


Телеконференции или служба новостей — популярная служба Интернета. 
С помощью этой службы вы можете найти единомышленников по любым ин- 
тересущим вас вопросам и наладить общение с ними, получить любую инфор- 
мацию от политики до спорта и погоды. Очень полезны телеконференции 
и для программистов. Вы можете найти в них ответы на многие мучающие вас 
вопросы, можете сами послать вопрос и, вероятнее всего, найдутся те, кто вам 
квалифицированно на него ответит. Можно подписаться на новости той или 
иной группы, и соответствующая информация будет регулярно поступать на 
ваш компьютер. | 

Отличие телеконференции от группы новостей заключается только в том, 
что в телеконферению вы можете послать свое сообщение (статью) или свой от- 
вет на вопрос, заданный кем-то из участников конференции. Группа новостей 
позволяет только читать поступающие новости. 

Существует много серверов новостей (Мефмогк Мемз Тгапз#ег Ргофосо| — 
ММТР), и во многих из них имеется масса конференций. Например, если вы 
свяжетесь с сервером пеиз.спЁги, то обнаружите на нем свыше 35000 конфе- 
ренций, правда живых среди них, т.е. имеющих хотя бы одну статью, намного 
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меньше — всего 1742., 


845 


Из них более 100 конференций Вопапа, а из них более 


20 посвящены С++ВиЙаег (в названии фигурирует слово сррЬчИаег` ). Вот не- 


полный список конференций Вопапа: 
фог1ап4.рибПс.аррзегуег.сопзо]е-а4ед ог | 
фог|апа.ри с.аррзегуег.е)Ъ-стшр 
Бог|апа.ри с.Б4е 
бог|ап9.риб1с.соттипцу 
фот1ап4.ри6Нс.сопегепсе-аа __ 
Бог|ап4.рибНс.срр.соттапаПпефоо1$ 
ботап4.рибЦс.срр.]00$ 


оО 
бог|ап4.рибс.срр.поп-4есВтса] 


Бог1апа.ри6с.срр.\мпар1 


Бонапа.рибс.сррЬиаег.асйуех | 


Бог|ап4.риЪс.со4есеп$га] 
___ Бомапа.рабйе.со{егепсе 
Ботапа.ри61с.срр.БогапАерр 
Бог|апа.рибПс.срр.14е 


`Бопапа. ри с.срр.1апацаве 


`БоПапа.раЪ1с.сррЬааег 


‚ 00$ 


Бо апа.рибНс.аррзегуег.е)Ъ 


Бог1апа.риб1с.а бас тет 


Боапа.риБ1с.срр.о\/ 


роапа.рибс.сррои!дег.соттапаПпе- 


Ботапа.рч 6 Пс.сррЬиПаег.аа$аБазе Ботап4.риб1с.сррЬааег.Ча$афазе.а4о 
Бог1ап4.рибИс.срроиаег.Чафабазе.4езК- | Бог|ап4.рибПс.сррЬаН4ег.Чафафазе.тп]- 
фор ийег 


Бог|апа.ра Пс.сррЬиПаег.ЧАафара- 
зе.за]зегуегз_ 


Богапа.ра61с.сррЬи!Паег.1Ае 


Богапа.риБ!с.сррЬаПаег.]апгиаае 


Ботапа.раб1с.сррЬиПаег.поп-{4есип1са| 


| 


Боапа.ри6с.сррЬаПаег.1гараг$Уюо]1$ 
Боапа.рибИс.сррЬаИаег.ус1.сотро- 


пеп{$.1$115 
Бонапа.риБ1с.сррЬиПаег.мпар! 
Боапа.риБс.4е]ры 


Бог|апа.ри 6 с.4е]рр1.асйуех.соп$- 
го]$. мг 


Ботапа.риб1с.4е]рЬ1.аафаБазе.а4о 
Бопапа.риЪс.4е]рЬ1.Чабафазе.4езКфор 


Ъоапа. рибс. 4е]рЬ!.4афаЪазе. т Нег 


Бопапа.риБс.Ае1рЬ1.Аер]оутеп% 
Бог1апа.риБс.Ае]рЬ1.14е 
Богапа.ра6с.Ае]рр1.и\егпе 


Бог|ап4.рибПс.ае]рЬ1.{егпе&.меБзегу1сез 


Бог|апа.ра Йс.сррЬиПаег.гарЬ1с$ 
д штиПРРм т 


Бо|ап4.ра Пс.сррЬи!4ег.з$а4ет{$ 


`Ботапа.ра61с.еррЬааег.ус].сотро- 
| пепф$.мг те 


'Бог|апа.рибПс.Ч4е!рЬ1.Базт 


Бог1апа.ра6с.сррЬиПаег.и{егпе{ 


Бог|ап4.риб1с.сррЬиИ@4ег.тз_сотра Ы- 


Бопапа.рибс.сррЬаПаег.ус] 


`Ботапа. раб 1с.Чаёфазпар 


`Богапа.рибИс.Че!рЬ:.ас&уех.соп+- 
018.131 


Бог1апа.ри 1с.4е]рЬ1.Ча$аЪазе.АЪехргезз 


Бог|апа.ра6с.Ае]рЬ1.4а{баЪазе. 1п4егЬа- 
зеехргезз 


Боапа.ри 6 с.ае]ры. ЧааЪазе. а] зегуегз 
Богапа.риб1с.Аае]рЬ1.егарВ1с$ 


Боап4.рибс.Ае]ры1.ицегпа опа 2а оп 


Богапа.рибПс.ае]рЬ1.14егпе%$.1зар!-мге- 
ЪгокКег 


Богапа.риБс.4е]рЬ1.1п{егпе$. меб зпар 
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Бог1ап4.ри6Пс.ае]рр1.30Ъ$ 


Бог|ап4.рибс.аеры 1щегпе$.мпзоск 


'Бог|ап4.рибШс.4е]рЬ1.поп-4есиса] Богапа.риБс.ае]рЫ1.оБ]есфразса] 


Богапа.риБ!1с.ае]рЬ1.о]еа$ота оп Бо апа.ричБс.4е]рЬ1.оо4ез1я п 
Богапа.риу 6 Пс.аерь1.орепт$о0]зар! Бог|ап4.рибс.ае]ры.герогпй-свагипЕ 
Боапа.рибПс.Ае]р1.з$а4ет+з Бог1апа.риБ!с.ае]рЬ1.&1гарагву-00]$ 


Бог|апа.риБс.Че]р.ирягаае Ботапа.риб1с.4е!рЬ1.ус1.сотро- 
пеп{5.и5ште 


Бог|апа.рибс.ае]р1.ус1.сотро- Богапа.риЪ!с.аеры. "пар! 
пет. угИпй 


Бог1апа.риЪБ!1с.) Би 4ег.Аабафазе 


Боапа.рибс.}БиЦ4ег.АБзуте 


_| Бопап4.рибПс.)би4ег.етегрг1ве 


Богапа.рибс.)Биаег.АеБийеегоог- 


]апа.риб1с.)БиПаег.4ероутепф 


Ботапа.ри61с.)ЪБиаег.14е Боапа.риб Пс. }ЪаПаег.]ауа.|апцае 


Богапа.ра6 Пс. )ЪоПаег.)ауа.з\ште Бог|апа.ри61с.]БаПаег.)Ъс] 


ООН ИОН 


Конечно, не все эти конференции активны (имеют хотя бы одну статью) 
и интересны. Но попадаются и полезные. Правда, все эти конференции 
Воап4 на английском языке. 


10.5.2 Компонент ММММТР 


Возможность работы с новостями поддерживается многими почтовыми 
программами, в частности, встроенной в \Уш@4омз программой Оиоок Ех- 
ргезз. Но в С++ВиЦаег 6 на странице библиотеки Го$!Ме! имеется компонент 
ММММТР, который позволяет построить свою специализированную програм- 
му работы с новостями. 
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Свойства этого компонента, обеспечивающие соединение с сервером, ана- 
логичны рассмотренным для других компонентов. Это Но$ — адрес сервера 
ММТР, Рог — номер порта (обычно 119), Озег[4 — идентификатор пользова- 
теля, Раззмог — пароль. Идентификатор пользователя и, особенно, его па- 
роль требуют далеко не все серверы. Соединение с сервером осуществляется 
методом Соппесф, разрыв соединения — методом О1зеоппес$. Различные собы- 
тия, сопровождающие удачный и неудачный процесс соединения, в данном 
компоненте те же, что и в рассмотренных ранее компонентах страницы 
РазНМе!. — 

Статьи и новости, полученные с севера, могут занимать достаточно боль- 
шое место. Поэтому желательно отвести специальные каталоги для хранения 
сообщений и вложенных в них файлов. Каталог хранения сообщений задается 
свойством Мем’зПлг. Каталог хранения вложенных файлов задается свойством 
АНасьЕПеРа. Однако если второй параметр, как будет сказано позднее, ре- 
ально работает, то первый не используется, так же как и параметр СасВеМофде, 
определяющий режим кэширования, т.е. режим сохранения сообщений на 
диске. Эти свойства и соответствующие им методы в компоненте ММММТР не 
реализованы. 

Компонент ММММТР позволяет решить следующие основные задачи: 


и Получение списка доступных конференций 

и Получение списка названий статей выбранной конференций 
и" Чтение выбранной статьи 

и Посылку своего сообщения в выбранную конференцию 


Рассмотрим поочередно решение этих задач. Список имен доступных кон- 
ференций получается методом @еёСгопрГ1$+. В процессе выполнения этого ме- 
тода при чтении с сервера названия каждой новой конференции (конференции 
называются также группами новостей) возникает событие ОпСгопр!1$+- 
Орда{е. Заголовок обработчика этого события имеет вид: 


у01А __Ёаз®&са11 ТЕГогм1 : : ММММТР1бгоцрЬ1 $ Ордаее (Апз15Ег1п3 папе, 
106 Е1Е56Аге1с1е, 1пЕ Таз Ахе1с]1е, Боо1 РозЕ1па) 


Параметр паше содержит имя конференции. Параметры Е!г$&Атие 
и Газ АгиИе определяют номера первой и последней статей в конференции. 
Номера статей вовсе не обязательно начинаются с 1. На сервере новостей хра- 
нятся, естественно, не все поступавшие туда статьи, а какое-то ограниченное 
их число или только статьи за определенный отрезок времени. Параметры 
ЕгЗАгие и Газ Атие указывают первый и последний номер доступных 
в данный момент статей. Если Е1г$& Агие > Газ Агие, значит, конферен- 
ция не содержит ни одной статьи. Параметр Роз тя указывает, можно ли по- 
сылать свои статьи в эту группу новостей. 

Теперь рассмотрим получение списка наименований статей (новостей) не- 
которой конкретной конференции (группы). Прежде, чем запрашивать список 
статей, надо выполнить метод ЭеёСгочцр: 


У01А __Еаз$©са11 5еСгочр (Апз156г1пд Сгочр); 


Параметр Сгопр должен содержать название выбранной конференции. 
Метод делает данную конференцию текущей (активной). В результате 
в свойство З@есе4Сгоипр компонента заносится имя активной конферен- 
ции, а в свойства ГоМеззахе и Н!Меззасе заносятся номера первой и по- 
следней из доступных статей. В свойство РозИпе заносится фгие или Ёа]зе 
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в зависимости от того, можно или нельзя посылать свои статьи в данную 
группу новостей. | | 

После того как текущая конференция установлена, можно прочитать спи- 
сок имеющихся в ней статей. Это осуществляется методом Се АгиеГ! 1$: 


%01а __Еаз®са11 СефАгк1с1еГ15$% (роо1 А11, 1пе АгЕ1с1еМипрег); 


Если при вызове этого метода задать параметр АП равным фгие, будет прочи- 
тан весь список. Тогда значение параметра Аги«еМиаштьег не имеет значения. 
Если же задать параметр АП равным #а{5е, то будут прочитаны названия толь- 
ко первых АгиееМипфег статей. Функция не возвращается до тех пор, пока 
не будет закончено чтение списка. 

В процессе выполнения метода де Аги«еГ.1${ при чтении названия каж- 
дой статьи возникает событие ОпНеа4егТ.1$%. В обработчике этого события дос- 
тупно свойство Неа4ег — объект, содержащий в виде списка строк всю инфор- 
мацию о заголовке статьи. Информация этого заголовка очень обширная, со- 
держит много служебных сведений и в целом обычно не представляет интере- 
са. Более информативно свойство Неа4дегВесог4. Это объект типа ТРо$- 
ВесогЧТуре, содержащий следующие свойства (все они имеют тип $&г1шх, кро- 
ме целого свойства РгАги@е19): 


РгАррМаше Имя приложения, приславшего 
РгАгие14 


Ре иБоНоп Тип рассылки сообщения 


сообщение 


'Номер данного сообщения в группе 


РгЕготА9@гез$ ! Адрес электронной почты пославшего сообщение 


1 . 
РгМемзСгоирз |Группа новостей (конференция), пославшая сообщение 


РгВер!уТо Адрес электронной почты, который можно использовать для 
ответа на данное сообщение 


| Тема сообщения 


Дата и время отправки сообщения 


Рг5иБ ес 


Наиболее существенная информация заключена в свойствах Неа4егВе- 
согда->РгЗибуес{ и НеадегВесога->РгАгисеЧ — тема и номер статьи. Тема 
позволяет понять, о чем эта статья и стоит ли ее читать. А номер будет нужен, 
если вы решите прочитать статью. 

Теперь рассмотрим чтение статьи. Перед чтением соответствующая конфе- 
ренция (группа новостей) должна быть активизирована рассмотренным ранее 
методом Зе Сгоир. Должен быть также известен номер читаемой статьи. Чте- 
ние может осуществляться методом бефАгиее: 


У01А __ЕазЕса11 СееАге1с1е(1пЕ ВеЕ); 


Параметр Ве? указывает номер статьи в группе. Метод бе Агие читает 
всю информацию о статье. Имеются также методы СеёАгиеНеадег и Се Аг- 
иеВоду: 


у01А __Еаз®са11 СефсАгЕ1с1еНеааег (1пе ВеЁ); 
Уу01Аа __Газеса11 СееАгЕ1с1еВо@ау (106 ВеЕЁ); 


Первый из них читает заголовок, а второй — текст статьи с номером Ве?й. Надо 
иметь в виду, что не все серверы поддерживают команду, соответствующую 
методу де АгиеВоду. 
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Если используется метод де Агие, то после получения с сервера статьи 
возникает событие ОпАгие. При использовании методов се АгиеНеадег 
и Се АгиеВоду возникают соответственно события ОпНеафег и ОпВоду. По- 
лученную заголовочную информацию можно найти в рассмотренных выше 
свойствах Неа4ег и Неа4егВесог4. А текст сообщения хранится в свойстве 
Воду в виде списка строк. В полученном сообщении могут быть вложенные 
файлы. Как они воспринимаются, зависит от значения свойства РагзеАВасВ- 
теп{$. Если это свойство установлено в #а]зе, то файлы просто остаются в теле 
сообщения. А если РагзеАНасвтепф$ = фгие, то одновременно должно быть за- 
дано свойство АЙасвЕПеРа{ И — каталог, в котором на компьютере пользова- 
теля надо сохранять полученные файлы. В этом случае вложенные файлы из- 
влекаются из тела сообщения, декодируются и заносятся в указанный ката- 
лог. А полные имена сохраненных файлов заносятся в свойство АНасвтеп{$ 
типа Т$&т1Т1$$. | 

Если при выполнении метода де Агие произошла ошибка, возникает со- 
бытие ОпшуаПАаАгие. Ошибка обычно связана с неправильным номером 
статьи. 

Нам осталось рассмотреть задачу посылки своего сообщения в телекон- 
ференцию. Посылка осуществляется методом Ро5& Агие. Перед посылкой 
статьи ее текст должен быть занесен в свойство Ро5&Во@ду, представляющее 
собой список строк. Должен быть также сформирован заголовок посылаемо- 
го сообщения. Этот заголовок содержится в свойстве Роз Неа4ег, подобном 
упоминавшемуся ранее свойству Неа4ег. Более удобно пользоваться другим 
свойством — Ро5{КВесога. Это свойство имеет тот же тип, что и рассмотрен- 
ное выше свойство Неа4егВесога. Для отправки сообщения надо, как мини- 
мум, заполнить такие его поля, как РтгЕгот АЯ4ге$$ — свой адрес электрон- 
ной почты, РгКер!уТо — адрес электронной почты, по которому можно по- 
сылать ответ (обычно равен РгЕготА@4@4ге5$), РгЗи6]есё& — тема сообщения 
и, главное, РгМем$Сгопр$ — телеконференция, в которую вы посылаете со- 
общение. Если вы хотите вложить в свое сообщение какие-то файлы, то 
должны занести их полные имена в свойство Роз АНасптеп{$ типа 
'Г5 1121156. 

Перед вызовом метода Ро5&АгИие полезно проверить свойство РозИпе, 
которое показывает, можно ли посылать сообщение в текущую группу ново- 
стей. Это свойство, о котором говорилось ранее, заполняется в момент активи- 
зации группы. Если сообщение методом Ро Агие передалось успешно, воз- 
никает событие ОпРоз{е@4. В противном случае возникает событие ОпРо${- 
РГаПе4. Заголовок его обработчика имеет вид: | 


уо1а __ Еаз®са11 ТЕМемз : : ММММТР1РозЕГа11еа (ТСотропепе *5епаег, 
МОВР Еггпо, Ап$15ег1па Еггмза) 


Параметр Еггпо — номер возникшей ошибки, а Еггт$# — сообщение об ошибке. 

Вот, собственно, все основные сведения о компоненте ММММТР, которые 
необходимы при практической реализации приложений, работающих с ново- 
стями. Стоит только упомянуть еще о методе АБог, прерывающем выполне- 
ние текущей операции. Его нередко надо использовать, поскольку чтение 
больших объемов информации может требовать много времени и пользовате- 
лю всегда может захотеться прервать затянувшуюся операцию. Необходимо 
также сказать, что поскольку в компоненте не реализован режим кэширова- 
ния, надо продумывать свои способы хранения на диске информации, чтобы 
не тратить время на повторное получение уже однажды полученной инфор- 
мации. 
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10.5.3 Пример приложения 


Теперь перейдем к примеру (проект РСоп{ для С++Ви!аег 6 в каталоге 
Соп]егепсе на приложенном к книге диске), который покажет основные спосо- 
бы работы со службой новостей. Окно этого приложения во время работы пока- 
зано на рис. 10.8. Начнем с чисто внешнего описания этого примера с точки 
зрения пользователя. 

Соединение с сервером осуществляется командой меню Соединение | Вкл/Выкл 
или крайней левой быстрой кнопкой инструментальной панели. Сервер, с кото- 
рым осуществляется соединение, указывается в окне редактирования Сервер. 

Основную часть окна приложения занимают три вертикальные панели. 
В левую загружается список конференций, доступных на сервере. Число та- 
ких конференций может быть очень большим. Как уже говорилось, на сервере 
пеишз.сп1.ги доступно свыше 35000 конференций и групп новостей. Загрузка та- 
кого объема информации требует немалого времени, в течение которого ком- 
пьютер должен быть связан с Интернетом. Причем, если пользователь, напри- 
мер, все время работает с одни сервером, то львиная часть этого времени будет 
потеряна зря, так как список обновляется не так уж часто. Поэтому в прило- 
жении предусмотрено три варианта загрузки списка. Первый вариант, выпол- 
няющийся по команде Конференции | Загрузка с сервера (третья слева быстрая 
кнопка на рис. 10.8), осуществляет чтение списка и отображение его в списке 
Список конференций. Второй вариант по команде Конференции | Загрузка с запи- 
сью в файл (пятая слева быстрая кнопка) выполняет ту же операцию, но одно- 
временно записывает адрес сервера и имена всех конференций в текстовый 
файл на диске. А третий вариант по команде Конференции | Загрузка из файла 
(четвертая слева быстрая кнопка) вместо загрузки списка с сервера загружает 
его из файла, созданного при выполнении второго варианта. Это происходит 
очень быстро и не требует соединения с сервером. Так что разумный вариант 
работы с приложением такой: один раз выполняется чтение с созданием файла 
на диске, а в дальнейшем список загружается из этого файла. Только изредка 
можно повторять чтение с сервера, чтобы отследить изменения в списке кон- 


ференций. 


Рис. 10.8 
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Загрузку списка статей конференции, выбранной в списке Список конфе- 
ренций, также можно осуществлять в трех вариантах. Один вариант — чтение 
списка с сервера. Это осуществляется командой Статьи | Чтение списка с сервера, 
или соответствующей быстрой кнопкой (шестая слева на рис. 10.8), или про- 
сто двойным щелчком на соответствующей строке в списке Список конферен- 
ций. Можно также вообще предварительно не заполнять список конференций, 
а просто написать конференцию в окне редактирования этого списка. В ре- 
зультате любых этих действий список Список статей заполнится названиями 
доступных статей. Второй вариант реализуется командой Статьи | Чтение списка 
с записью в файл или восьмой слева быстрой кнопкой. В этом варианте помимо 
заполнения списка Список статей осуществляется создание на диске текстового 
файла, в который заносятся имя сервера, имя конференции, а затем чередуют- 
ся строки с именами статей и их идентификаторами. Третий вариант реализу- 
ется командой Статьи | Чтение списка из файла или девятой слева быстрой кноп- 
кой. В этом варианте список читается не с сервера, а из запомненного на диске 
файла. 

Чтение статьи, выбранной в списке статей, осуществляется командой Стоа- 
тьи | Чтение статьи, или третьей справа быстрой кнопкой, или просто двойным 
щелчком на выбранной статье в списке. В результате в окно Тема загружается 
тема статьи, а в окно Статья — ее текст. Если в статью вложены файлы, то их 
имена заносятся в список Файлы. Сделав двойной щелчок на имени файла, 
пользователь может посмотреть его той программой \У/1т4о\’з$, которая ассо- 
циируется с этим файлом. 

Если пользователь хочет направить в конференцию свое сообщение, он мо- 
жет занести в окно Статья его текст. При желании пользователь может вло- 
жить в статью какие-то файлы. Для этого он должен выполнить команду Сто- 
тьи | Вложить файл (вторая кнопка справа) и в стандартном диалоге \У/1пдо\з вы- 
брать нужный файл. Его полное имя занесется в список Файлы. Если пользова- 
телю в дальнейшем потребуется удалить файл, он может выделить его в списке 
Файлы и нажать кнопку ОШеее. 

Таким образом, данное тестовое приложение содержит большинство опе- 
раций, необходимых для построения специализированного приложения, рабо- 
тающего с новостями. 

Теперь перейдем к рассмотрению этого приложения с точки зрения его 
реализации. Форма приложения показана на рис. 10.9. Помимо визуальных 
компонентов, которые вы могли видеть на рис. 10.8, на форме расположены 
компоненты ММММТР, ГШпареГ! $4, АсНопТ 13%, АррИсаНйопЕует5$, МашМепи 
и ОрепП1а]1ог. В компонент [пареГ15&1 занесены пиктограммы, которые вы 
можете видеть на кнопках инструментальной панели. 
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Рис. 10.9 
Форма 
приложения, 
работающего 
с новостями 


ааея 
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В компонент Асй0опГ!л1$1 введены все основные действия, выполняемые 
приложением и отраженные в меню и инструментальной панели. Свойство 
Гпаге$ компонента равно ПпареГ 151, так что все действия снабжены соответ- 
ствующими пиктограммами. Все действия снабжены подсказками Нш. 
В компоненте определены следующие действия: 


Действие Описание 


АСоппес Включение и выключение соединения с серве- 
ром 


Категория 


Соединение 


ААБог+ 


Конференции | АВеа4Соп!Ноз{ | Чтение списка конференций с сервера 


АБеаЧСопЕПе |Чтение списка конференций из файла 


АВегез В Соп? Чтение списка конференций с сервера и за- 
пись его в файл 


АВеа4Аг{Ноз${ |Чтение с сервера списка статей выбранной 
конференции 


АБеадАг+ЕПе Чтение списка статей из файла 
АБе{!гез В Аг Чтение с сервера списка статей выбранной 
конференции и запись его в файл 
АБеаЧАг Чтение выбранной статьи из указанной группы 


Прерывание текущей операции 


Аше 4еЕ Добавление файла в отправляемую статью 
АРоз& Аг Отправка статьи в конференцию 


Компонент МашМепи1 определяет главное меню приложения, повторяю- 
щее описанную выше структуру действий. Свойство Ппабе$ компонента равно 
ГпасеГ,15{1. Инструментальная. панель реализована компонентом Тоо@Ваг. 
Свойство Ппахез компонента равно ПщаретТ.1${1. Свойство ЭВомНИЁ установ- 


> 


` 
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лено в фгие, что обеспечивает все быстрые кнопки панели всплывающими яр- 
лычками. Внизу формы расположена панель состояния ЭёабизВаг. Ее свойст- 
во Эпир!еРапе] установлено в &ёгие, что соответствует несекционированной па- 
нели. 

Основную площадь окна занимают три панели. Левая и средняя выровне- 
ны влево (АПеп = аП.еЁ@), правая занимает всю оставшуюся клиентскую об- 
ласть формы (АНеп = а!СПеп®. Между панелями размещены разделители 
эрНЦег. Это позволяет пользователю произвольно изменять ширину всех па- 
нелей. 

На левой панели помещено окно редактирования ЕЁ с меткой Сервер (его 
имя в программе ЕНо${) и список СошБоВох с меткой Список конференций 
(имя — СВСоп®). В компоненте СВСопЁ свойство 5 Ее задано равным ©е551т- 
ре. Это обеспечивает представление списка в развернутом виде с окном редак- 
тирования вверху. Свойство Зое@ списка установлено в фгие, чтобы строки 
списка были упорядочены по алфавиту. Свойство ЗВо\Нш установлено 
в фгие, чтобы в дальнейшем компонент АррИсаИопЕуепй$ мог обеспечивать 
отображение во всплывающем ярлычке длинных строк списка, не помещаю- 
щихся в его окне. Свойством Апевог$ список привязан ко всем сторонам роди- 
тельского компонента, что обеспечивает изменение его размеров при измене- 
нии пользователем размеров панели. Компонент ЕНо$ё привязан свойством 
Апсвог$ ко всем сторонам родительской панели. 

На средней панели расположен список СошфФоВох с меткой Список статей 
(имя — СВАгиИ@е). Все его свойства аналогичны рассмотренному выше компо- 
ненту СВСопёЁ. Только свойство Зоге4 равно #а5е, так как упорядочивать ста- 
тьи по алфавиту вряд ли целесообразно. На правой панели размещены окно ре- 
дактирования Е с меткой Тема (его имя — ЕЗиБ]есф), многострочное окно 
редактирования Мето с меткой Статья (имя — МАгИи4е) и список 11$ Вох 
с меткой Файлы (имя — ГВЕЦе5). Окно МАгие свойством Апевог$ привязано 
ко всем сторонам родительской панели, а список ЕВЕПШез — ко всем, кроме 
верха. 

Из размещенных на форме компонентов осталось рассмотреть только ос- 
новной — ММММТР1. В нем заданы свойства АЙасвЕПеРа{ И и М№емзО!:г — ка- 
талог размещения читаемых файлов. Свойство РагзеАвасвтеп{$ установлено 
в гие, чтобы обеспечить извлечение и декодирование файлов, вложенных 
в читаемые сообщения. Задано имя пользователя в свойстве Озег1а. 

Теперь рассмотрим программную реализацию приложения. Ниже приве- 
ден его полный код. 

#10с1аАе <ус1.Н> 


#10с1оае <зЕато.В> 
#10с1аае <1о.8> 


// Прежде, чем выполнять данный пример, его надо настроить 


// В компоненте ММММТР1 в свойствах АЁЕЕасЬЕ11еРаЕНВ и 

// М№еи5р1г задайте калалог для хранения полученных файлов. 
// В свойстве ПОзегТАа задайте свое имя как пользователя 

// Если связываетесь с сервером, требущим пароля, 

// укажите пароль в свойстве Раззиога 


// Задайте значения введенных в тексте констант: 

// $5Е11еСопЕ - полное имя (с путем) файла списка конференций 
// 5ЗЕ11еАгЕЁ - полное имя (с путем) файла списка статей 

// МуЕта11 - ваш адрес электронной почты 


854 Глава 10. Сетевые службы 


ЕТЬЕ* ЕС; 


ЕТЬЕ* РА; // Файловые переменные 

Боо1 Мг1+еСопЕ = Ёа15$е; // Должен ли записываться файл 
Боо1 Ме1ЕеАге = Еа13е; // Должен ли записываться файл 
Боо1 ГоаЯАг&1с1еТ13% = +хие; // Флаг чтения из списка 
Т5Е10911$6 *115ЕМаи= пем Т56г1п91156; // Список номеров тем 
Ап$15Ег1па $Е11еСопЕЁ = "Е11еСопЁ.6хе"; // Файл конференций 
Апз15&к1па $Е11]еАге = "Е11]еАге.*хе"; // Файл статей 
Ап$15Ег1па МуЕта11 = "123@.456.гы"; // Адрес ета11 

1опа МСопЕЁ; // Число прочитанных конференций 


у01А _ Еаз®са11 ТЕМемз: : Рога/ез®гоу (ТОР)есе *5епаег) 
// Завершение работы 

{ 

1Е (ММММТРТ->Соппесееа) ММММТР1->015соппесе (); 

1 зЕМ№ип->Ггее (); 


У01а __ аз са11 ТЕМемз: : АСоппес%Ехесике (ТОБЗес® *Зепаег) 
// Установка / Разрыв соединения 
{ 
1Е (АСоппес®->Сфескеа) 
{ 
ММММТР1->Ноз& = ЕНо$&->Техе; 
Зрафа$Ваг1->$1тр1еТехе = 
"Осуществляется соединение с сервером " + 
ЕНозе->Техе; 
Зсгееп->Сагзог = сгАрроваг&; 
ММММТР1->Соппесе (); 


} 
е1з5е ММММТР1->01$5соппес® (); 


У01А __Еаз®са11 ТЕМемз: : ММММТР1Соппес® (ТОБЗесе *5епаег) 
// Соединение установилось 
{ 
бсгееп->Сигзог = сг/еЕац1{; 
Зсаеиа$Ваг1- ->51пр1еТехе = 
"Установлено соединение с сервером " + ЕНо$®->Техе; 


уо1а ГЕазЕса11 ТЕМемз: : ММММТР101$соппес® (ТОБ]есе *бепаег)} 
// Соединение разорвано 

{ 

1Е (\Мг1ееСопЕ) С1озеНапа1е (ЕС); 

1Е (Иг1ееАге) С]1озеНапа]1е (ГА); 

ЗЕафсазВаг1->51тр1еТехЕ = "Соединение разорвано"; 
АСоппес&->СресКея = ЁЕа15е; 

Зсгееп->Сигзог = сгреЁао]1{; 


\01А _ Еаз®са11 ТЕМемз: : ММММТР1Соппес*1опРа11еа (ТОБ)есе *5епаег) 
// Ошибка соединения 


{ 


ЗВомМеззасде ("Не удалось установить соединение с сервером"); 
АСоппес+->Срескея = Еа1з5е; 


ЗЕаеи$Ваг1->$51тр1еТехЕ = "Соединение разорвано"; 
5сгееп->Сигзог = сгреЁат1*; 
АБоге (); 


10.5 


Телеконференции и служба новостей 


у01А _ Еаз®са11 ТЕМемз: ; ММММТР11пуа11АНоз% (Фоо1 &Напа1ея) 
// Ошибочный адрес 

{ 

ЗРомМе$засде ("Неверный адрес сервера"); 
АСоппесе->Спескея = Еа15е; 


ЗЕабазВаг1->51тр1еТех®е = "Соединение разорвано"; 
5сгееп->Сигзог = сгр)егац1*; 

АБоге (); 

} 
И-----=--н-нннннннн-н----========-=-=======--=-===---- 


у014 __ Еаз®са11 ТЕМечмз : : ММММТР1АДЕНеп* 1са&1опГа11еа ( 


ТОР)]есе *бепаег) 
// Ошибочная авторизация 


{ 
Боо1 1; 
Зсгееп->Сигзог = сгреЁат1*; 
Ап$15Ег1па 5 = ММММТР1->ОзегТа; 
1Е ( = ТпраеОцегу ("Ошибка в имени пользователя или в пароле", 
"Уточните имя:", 5)) 
ММММТР1->О5егта = 5; 
$5 = ММММТР1->Раззмога; 
1Е (ТпрабОчцегу ("Ошибка в имени пользователя или в пароле", 
"Уточните пароль:", 5)) 
{ 


ММММТР1->Раззиога = 5; 

Г = &гае; 

} 

1Е (Т,) 

{ 

5сгееп->Сигзог = сгАрр5фбаг®; 
ММММТР1->СоппесЕ (); 

} 


е15е ЗЕаки$Ваг1->51тр]1еТехЕ = "Соединение разорвано"; 


у01А _ Еа5®са11 ТЕМемз:; : ММММТР1А Реп 1са*1опМ№ееааеа ( 


Боо1 &Напа1еа) 


// Нужна авторизация 


{ 


} 


бсгееп->Сигзог = сгреЁац1%; 

Ап$15Ег1па 9; 

Боо1 1; 

1Е (ММММТР1->0ОзегТа == "") 

{ 

1Е (Ъ = ТрраеОчегу ("Нужна идентификация", 

"Введите ваше имя", 5))} 

ММММТР1->0ОзегТа = $5; 


} 
1Е (ММММТР1->Раззмога == "") 
{ 
1Е (ТпрчеОцегу ("Нужна идентификация", 
"Введите пароль", 5)) 
{ 


ММММТР1->Раззмога = $5; 
Г = Е ге; 
} 
} 
Напа1еа = &гае; 
1Е (1) 
{ 
5сгееп->Сихгзог = сгАррэваге; 
ММММТР1->Соппес® (); 
} 


е1зе ЗЕакозВаг1->51тр1еТехЕ = "Соединение разорвано"; 
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У014 __Газ®са11 ТЕМемз: : АВеа4ЯСопЕНоз*Ехесиее (ТОр)]есЕ *5епаег) 
// Чтение списка конференций с сервера 
{ 
Ап5156г1па 5 = ЕНо$е->Техе; 
1Е (!ММММТР1->Соппесеея) 
{ 
ЗромМез55аде ("Нет соединения"); 
гебагп; 
} 
МСопЕЁ = 0; 
Иг1$еСопЕ = (Зепаег == АВКеЕгезПВСопЕ); 
1Е (МгтееСопЕ): 
{ 
ЗЕафо$Вах1->$51тр]1еТехе = 
"Загрузка списка конференций с сохранением в файле 0"; 
ГС = Еореп (5Е11еСопЕ.с_з%г(),"мё"); 
Еретп ЕЕ (ЕС, "%5\п", 5); 
} 
е15е 
ЗБаеа$Ваг1->51тр1еТехе = 
"Загрузка списка конференций с сервера 0"; 
СВСопЕ->С1еаг(); 
эсгееп->Сиагзог = сгАррэбаг; 
СВСопЕ->5огЕе = Еа15е; 
// СВСопЕ->ТЕетз->ВедлпИрааее (); 
ММММТР1Т->СееСгоцртЬ15$% (); 
СВСопЕ->богфеЯ = фгае; 
// СВСопЕ->ТЕетз->ЕпаПрааЕе (); 
5сгееп->Сагзог = сгр)еЕао1{; 
ЗсабизВаг1->$1тр1еТехЕ = , 
"Загружен список конференций сервера " + 
ЕНозе->ТехЕ + " (" + ТоЕТобЕг (МСопЕЁ) + 
" наименований)"; } 


Уу01Аа __Еаз®са11 ТЕМемз: : ММММТР1Сгоир1 15 Ордате (Ап515&г1па папе, 
1106 ЕР1г56Аге1Сс1е, 1пе Газе АгЕ1с1е,. Боо1 РозЕ1па) 
// Чтение очередного названия конференции 


//1Е(Е1Е5ЕАКЕ1С1е <= Газ ЕАГЕ1Сс1е) 
{ 
№МСопЕ++; п 
1Е (Иг1ееСопЕ) 
ЗЕаба$Ваг1->$1тр1еТехЕе = 
"Загрузка списка конференций с сохранением в файле " + 
ТпеТоЗЕг (МСопЕЁ); 
е1зе | 
ЗЕафо$Ваг1->51тр]1еТехе = 
"Загрузка списка конференций с сервера " + 
ТпЕТозег (№МСопЕЁ); 


1Е (Мг1ееСопЕЁ) Ерг1пЕЕ (ЕС, "%$з\п", папе); 
СВСопЕ->Т$емз->АЯА (паме); 


Уу01А _ Газфса11 ТЕМемз: : АКеадСопЕЕ11еЕхесиее (ТОБЗес+ *бепаег) 
// Чтение списка конференций из файла 


{ 
сраг $[100]; 
1Е (!Р11еЕх1 $$ ($Р11]еСопЕ)) 
{ 
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ЗРоиМеззасде ("Файл '" + 5Е11еСопЕ +"' не найден"); 
гебигп; 

} 

ЗсабчзВаг1->5$1тр1еТехЕ = 

"Загрузка списка конференций из файла"; 

5сгееп->Сигзог = сгНочгС]аз$; , 
ГС = Еореп (5$Е11еСопЁЕ.с зе: (),"хк®"); 

Еаефз$ (5$,100,ЕС); 

Ес1о$е (ЕС); 

$ [$6 х;1еп ($) -1]='\0!; 
ЕНоз®->Тех®е =5; 
СВСопЕЁ->Т6епз->оааЕгопЕ11е ($Е11еСопЕ); 
СВСопЕ->Т$емз->ре1еке (0); 
СВСопЕ->Т$епТпраех = 0; 

Зсафоч5Ваг1->51тр1еТехе = "Сервер " + ЕНоз®->Техе + 

", список загружен из файла"; 

бсгееп->Сигзог = сгЕреЁЕац1{; 


Уу01А _ Еаз®са11 ТЕМемз: : АКеадАгеНозхЕхесофе (ТОБ)есе *5бепаег) 
// Чтение списка статей с сервера 
{ 
Ап$156г1па 5; 
1Е (!ММММТР1->Соппескечя) 
| | 
зромМеззаде ("Нет соединения"); 
гееагп; 
} 
МСопЕЁ = 0; 
Иг1ееАгЕ = (бепаег == АВеЕгезвАг\); 
1Е (Мг1ееАгЪф) 
{ 
ЗЕакизВаг1->$51тр1еТехе = 
"Загрузка списка статей конференции '" + 
СВСопЕЁ->Техе + "'-с записью в файл 0"; 


КА = Еореп (5Е11еАге.с $6г(),"мё"); 
5=ЕНоз®->Техе; 
Ерг1пеЕЁ (РА, "%$5\п", 5); 
$=СВСопЕ->Тех*; 
Ерг1п Е (РА, "%$\п", 5); 
} 
е1зе 
ЗсакизВаг1->$1тр1еТехе = 
"Загрузка списка статей конференции '" + 
СВСопЕ->ТехЕ + "' 0"; 
ТоааяА"*1с1е115$% = ф$гае; 
ММММТР1->Нозе = ЕНозе->Техе; 
ММММТР1->5бееСгоцр (СВСопЕ->Тех®); 


\01А _ Еаз®са11 ТЕМемз: : ММММТР1Сгоцр$е1ес® (ТОБ)есе *5епаег) 
// Событие при активизации конференции 
{ г 
1Е (ГоааАг*1с1е115®) 
{ 
СВАг&1с1е->С1еаг(); 
Т1$ЕМим->С]еаг(); 
эсгееп->Сиагзог = сгАрруваге; 
ММММТР1->СеЕАгЕ1с1еГ15$Е ($гае, 0); 
5сгееп->Сигзог = сгреЁаи1{; 
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у01А __Еаз®са11] ТЕМемз: : ММММТР1Неа4егт 15% (ТОБ]есе *5епаег) 
// Чтение заголовка очередной статьи 
{ 
Апз15Ег1па 5; 
СВАг*1с1е->ТГ$емз->Ааа (ММММТР1->НеааегВесога->РгбаБ)ес*); 
15ЕМ№ам->Ааа (ТпЕТобег (ММММТР1 ->Неа4егВесога->РгАг%1с1ета)); 
№МСопЕ++; 
1Е (Мг1феАг®) 
{ ` 
$ = ММММТР1Т->НеааегВесога->РгбаБ]ес®; 
Ерг1пЕЕ (РА, "%$$\п", 5); 
5 = ТаЕТобег (ММММТР1->НеааегВесога->РгАге1с1еТа); 
Ерх1пеЕ (РА, "%$5\п", 5); 
Зсафи$Ваг1->51тр1еТех®е = 
"Загрузка списка статей конференции '" + 
СВСопЕ->Техе + "' с записью в файл, " + 
ТпЕТобег (М№МСопЕ) + " статей"; 
} 


е1зе 
Зсаёи$Ваг1->5$1тр1еТехе = 
"Загрузка списка статей конференции '" + 
СВСопЕ->Техе + "', " + ТПЕТобЕг (МСопЕ) + 
" статей"; 
1Е (ММММТР1->НеааегВесога->РгАг®&1с1е1Та == ММММТР1->Н1Мез$заче) 
{ 
ЗбаеизВаг1->51тр1еТехЕ = "Сервер " + ЕНо5®->Техе + 
"‚, конференция '" + СВСопЕ->Тех® + 
"', " + ТОЕТобЕг (МСопЕЁ) + " статей"; 


бсгееп->Саузог = сгр)еЁЕао1*; 


\01А _ Еаз®са11 ТЕМемз: : АВеадАгеЕ11еЕхесисе (ТОБ)есЕ *бепаег) 
// Загрузка списка статей из файла 
{ 
сраг $Н[ 100]; 
сраг $С[100]; 
ТЕ ( ! ММММТР1Т ->Соппесееа) 
{ 
ЗромМез$заде ("Сначала надо соединиться с сервером"); 
гекагп; 
} 
5сгееп->Сигзог = сгНоцгС1а$$; 
ЗЕаеазВаг1->51тр1еТехе = 
"Загрузка списка статей конференции '" + 
СВСопЕ->ТехЕ + "' из файла"; 
СВАгЕ1с1е->С1еаг(); 
115&Мим->С1еаг(); 
1Е (Р11еЕх15$$ (5Е1]еАг®)) 
{ 
КА = Еореп (5ЕР11еАге.с зег(),"гф"); 
Еаее$ (5Н,100,ГРА); 
Еаеез$ ($С,100,ЕА); 
ЗН [$ г1еп ($5Н)-1]='\0'!; 
$С [5 г1еп ($С) -1]='\0'!; 
ЕНоз®->Техе = 5Н; 
СВСопЕ->Техе = 5С; 
1Е (СВСопЕ->ТЕемз->ТпаехоЕ (5С) >= 0) 
СВСопЕ->Т$ешТпаех = СВСопЕ->Т%епз->ТпаехоЕ (5С); 
и\р11е (!ЕеоЕ(ГА)) 
{ 
Едчеф$ (5С,100,ЕРА); 
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$С [56 х1епт ($С) -1]='\0'; 
СВАг&1с1е->Т$етз->Ааа (5С); 
Гаеез (5С,100,РА); 
$С [5Ех1еп ($С) -1]='\0'!; ? 
Т15ЕМит->Ааа ($С); 
} 
Ес1о$е (ГРА); 
ТоааА"*1с1е15$Е = Ёа1зе; 
ММММТР1->бееСгочр (СВСопЕ->Тех*); 
СВАг&1с1е->Т+епТраех = 0; 
ЗЕБаеизВаг1->51тр1еТехЕ = "Сервер " + ЕНоз®Е->Техе + 
", конференция " + СВСопЕ->Тех® + 
", список загружен из файла"; 
} 
е1зе ЗВомМеззаде ("Файл '" + $К11еАгЕ +"' не найден"); 
5Зсгееп->Сигзог = сгреЁЕац1{; 


у01А _ Газ®са11 ТЕМемз: : АВеааАгеЕхеси*е (ТОБ)есЕ *5еп4ег) 
// Чтение статьи 
{ 
1Е (!ММММТР1->Соппесфея) 
{ 
ЗромМезз5асде ("Нет соединения"); 
гебагп; 
} 
1Е (ММММТР1->Нозе != ЕНоз&->Техф) 
{ 
бВоиМеззачце ("Соединение не с тем сервером. \п" 
"Разорвите соединение и снова соединитесь"); 
гебагп; 
} 
эсгееп->Сигзог = сгАррофаг&ф; 
ММММТР1->СебАгЕ1с1е (5 гТотТпе ( 
.1$Мам->56г1п9а$ [СВАг*1с1е->Тееп{1паех])); 
5сгееп->Сигзог = сгр)еЁау1*; 


014 __Еаз®са11 ТЕМемз: : ММММТР1Аг%1с1е (ТОр)]есЕ *5епаег) 
// Статья прочитана 
{ 
МАгс1с1е->С]еаг(); 
МАге1с1е->11пез$- Ааа ("Автор "+ 
ММММТР1->Неа4егВесога->РгЕкгомАаагез5) ; 
1Е (ММММТР1->НеааегВКесога->РгуВер1уТо != "") 
МАг®1с1е->Г1пез->Ааа ("Ответ на " + 
ММММТР1->НеааегВесога->РгВер1уТо); 
МАге1с1е->11пез->Ааа5 Е глпа$ (ММММТР1->Воау) ; 
МАгк1с1е->1пез->Ааа ("--------------------- "); 
Ебар]есе->Техе = ММММТР1->НеааегВесога->Рг5оаБ]есе; 
Т.ВЕ11ез->С1еаг(); 
ТВЕ11ез->Т$ет5->Ааа5Ег1па$ (ММММТР1->А&асртепез); 


Уу01А __Еаз®&са11 ТЕМемз: : ММММТР1Оесоае$*аге ( 
Ап5156г1па &Е11еМапе) 


{ 


СсафтизВаг1->51тр1еТехе = "Декодируются вложенные файлы"; 


у014 __Еаз&са11 ТЕМемз: : ММММТР1Ресо4еЕпа (ТОр)есЕ *бепаег) 


ЗЕаси$Ваг1->51тр1еТехЕ = "Вложенные файлы декодированы"; 


860 Глава 10. Сетевые службы 


у01А __ЁРаз®са11 ТЕМемз: :; ММММТР1Тпуа119Аг®1с1е (ТОБ]есе *5епаег) 
{ 
ЗПомМеззаде ("Ошибочный идентификатор статьи"); 


} 


уо1А _ Еа5®са11 ТЕМемз: :1ВЕ11е5061С11сК (ТОБ)ес®е *5епаег) 
{ — | 
Зле11Ехесоее (Напа1е, МОТЦ, 
.ВЕ11ез->Т6еп$->56г1па$ | 
| ТВЕ1]ез->Г{емТпаех].с_з6х(), 
МОЪЬ, МОГЬ, $5М ВЕЗТОВЕ); 


1Е (Орепр1а1о0о91->Ехесиее ()) 
ТВЕ11ез->1$етз->Ааа (Орепр1а1031->Е11еМапе); 


‚У01А _ Газ®са11 ТЕМемз: : ЪВЕ11езКеуромт (ТОБ]ес® *5епаех, 
ИОВ &Кеу, Т5р1ЕЕбсабе $01Е%) 
{ 
1Ё (Кеу == УК _ОЕЪЕТЕ) 
ТВЕ11ез->Т&емз->ре1ефе (Т1ВЕ11ез->ТеепТпаех); 


у01А _ Еаз®са11 ТЕМемз: : АРозсАг%Ехесо®е (ТОр]есе *5епаег) 
{ | 

// Отправка статьи в конференцию 
1Е (!ММММТР1Т->Соппескея) 

{ 

ЗРромМеззаае ("Нет соединения"); 

гегагп; 

} 

1Е (ММММТР1->5е1есееЯбгоир != СВСопЕ->Техф) 

{ 

ТоаЧ9Аге1с1е1$% = Еа15е; 

ММММТР1->5еесгоир (СВСопЕ->ТехЕ); 

} 

1Е (!ММММТР1->РозЕ1па) 

{ 

ЗпомМеззачде ("В данную конференцию сообщения не принимаются"); 
гебсагп; 

} 
ММММТР1->Роз&Воау->Аззтап (МАГ 1с1е->11пез$); 
ММММТР1->Роз&Весога->РхЕгомАаагезз = МуЕта11; 
ММММТР1->РозЕВесога->РгВер1уТо = МуЕма11; 
ММММТР1->Роз&Весога->Ргбаб]есЕ = Ебиар]ес®&->Техе; 
ММММТР1->Роз< АЕ баспмеп®*->Азз1ап (.ВЕ11ез->ТеЕетз); 
ММММТР1->РозеВесога->РуМемзсгойпрз$ = ММММТР1->5е1есфеасгочр; 
ЗЕаео$Ваг1->51тр1еТехЕ = "Отправка статьи в конференцию " + 

ММММТР1->5е1ескеЯасго`р; 

ММММТР1->Роз6Аг®1с1е(); 


Уу01А _ Еазеса11 ТЕМемез: : ММММТР1Розтеа (ТОр)есе *5епаег) 
{ 


Зтаси$Вах1->$51тр1еТехЕ = "Сообщение успешно передано"; 
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у01А __Еаз®са11 ТЕМемз: : МММУМТР1Роз%Га11еа (ТСотропепЕе *5епаег, 
МОВКО Егхгпо, Апз156г1па Еггм$9а) 
{ 


ЗПомМез$засде ("Ошибка передачи с сообщением " + Еггт5а); 


} 


у01А _ Еазеса11 ТЕМемз: : ААрогеЕхесисе (ТОБ)]ес® *5епаег) 
{ 

1Е (Мг1ееСопЕЁ) Ес1озе (ЕС); 

1Е (Мг1тееАгф) Ес1озе (ГА); 

Зсгееп->Сагзог = сгреЁац1*; 

ММММТР1->АБогеЕ (); 


Уу014 _ Еазса11 ТЕМемз: :Арр11сае1опЕуеп®$15ПомН1п® ( 
Ап$15©г1па &Н1пебеЕтг, Боо1 &СапбПВом, 
ТНтоеТрЕо &НапеТрЕо) 


{ 
1Е (Н1леТоЕо. Нап СопЕго1->С1аззМаметТ$ ("ТСопроВох")) 


{ 
ТСотроВох * ор] = (ТСотроВох *)Н1пЕТпЕо.Н1пЕСоп®го1; 
1Е (о6]->Т6ешТраех >= 0) 
1Е (Сапуа5->ТехЕМлаен (о ->Т&емз->5Ег1па$ [о] ->Т$емТпаех]) > 
о] ->С11епМтаев}) , 
{ | 
Н1пЕ5ег = ор]->Теетмз->56&г1паз$ [о] ->Т6ет1Тпаех]; 
Арр11са*1опЕуеп*$1->Сапсе1015зраеср (); 
} 
} 
} 


В коде введен ряд глобальных переменных. Переменные ЕС и ЕКА — это 
файловые переменные, используемые при работе с текстовыми файлами 
списков конференций и статей. Имена соответствующих файлов вместе с пу- 
тями содержатся в константах ЗЕЦеСоп? и ЗЕПеАгё. Структура информа- 
ции в этих файлах была описана выше. Переменные УтгЦеСопЁ и УгцЦеАг+ 
служат для определения, должен ли при выполнении соответствующей опе- 
рации формироваться файл УЗЕПеСопЁ или 5ЗЕПеАг. Переменная 
Гоа4Агис]еГ,1$% служит индикатором того, что список статей читается из 
файла, а не с сервера. | 

Список [4$ Миш — это объект, который создается в программе и заполня- 
ется одновременно со списком статей СВАгие. Он хранит номера статей. 
Объект этого списка создается при его объявлении. В функции ЕогтОе$&гоу — 
обработчике события ОпОез{гоу формы, список уничтожается. Одновременно 
разрывается соединение компонента ММММТРУТ с сервером, если оно не было 
разорвано ранее пользователем (проверяется по свойству Соппесфед). 

Функция АСоппес{Ехесще является обработчиком действия АСоппесй — 
установки и разрыва соединения с сервером. В этом действии свойство Ашфо- 
СПесК задано равным фгпе, так что при каждом обращении пользователя к это- 
му действию его свойство СВесКе4 автоматически изменяет свое значение. Со- 
ответственно связанная с действием быстрая кнопка изменяет свое состояние 
с нажатой на ненажатую или наоборот. Аналогичные изменения происходят 
в соответствующем разделе меню. В функции АСоппес Ехесще проверяется 
состояние, в которое перешел объект действия. Если действие не выделено, 
значит надо разорвать соединение с сервером методом О15соппес+. Если выде- 
лено — значит надо соединяться с сервером. Тогда в свойство Но$& компонента 
ММММТРУТ заносится текст, заданный в окне ЕНо$%, формируется сообщение 
о соединении в панели состояния и осуществляется соединение методом 
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Соппес*. Поскольку процесс соединения может занять некоторое время, уста- 
навливается форма курсора "песочные часы". 

Если соединение успешно установилось, возникает событие ОпСоппес+, 
и срабатывает его обработчик — функция ММММТР1Соппес{. В ней в панель 
состояния заносится сообщение о состоявшемся соединении. Если соединение 
разорвалось, возникает событие ОпО1$соппес&, и срабатывает его обработ- 
чик — функция ММММТР1И15еоппес+. В ней задается соответствующий текст 
в панели состояния и снимается выделение действия АСоппес+. Кроме того, 
проверяется по переменным УгЦеСоп{ и УгЦцеАтф, была ли запись в соответ- 
ствующие текстовые файлы. Если была, то файлы закрываются. 

При установлении связи с сервером возможны ошибки. В этом случае мо- 
гут генерироваться события ОпСоппесНопРа Пе, ОпшуаПЯНо$, ОпАиТеп- 
ИсайопРаЦе@, ОпАщ{ПепИса оп №ее4е4. Обработчики этих событий — функ- 
ции ММММТР1СоппесНопРГа!ед, ММММТР ПпуаП9Но$, ММММТР1АпШеп- 
ИсайопРаЙеа, ММММТР1АпТеписайопМ№еедед. В функциях ММММТР1Соп- 
песНопЕа1е4 и ММММТР ПпуаПЯНо3з пользователю просто выдается соответ- 
ствующее сообщение, и процесс соединения прерывается функцией АБог{. А 
в функциях ММММТР1АачеписаНопЕаЙей и ММММТР1АшТепйсайоп- 
Меедед, связанных с ошибками идентификации клиента на сервере, пользова- 
телю функцией шршОчегу предъявляются диалоговые окна, в которых он мо- 
жет исправить свое имя или пароль. Если пользователь что-то исправил (это 
определяется по возвращаемому функцией шршОчпегу значению), то делается 
еще одна попытка соединения с исправленными данными о клиенте. При этом 
в функции ММММТР1АцТепИеаНопМееде4 задается параметр Нап Ше4 рав- 
ным фгие, чтобы не появлялось стандартное сообщение об ошибке на англий- 
ском языке. | 

Во всех случаях удачного или неудачного окончания процесса соединения 
курсор приобретает форму по умолчанию. 

Функция АКеадСопНо${Ехесше является общим обработчиком двух 
действий: АКеа4Соп?ЁНо${ и АКеЁ!гезСоп? — чтения списка конференций без 
записи или с записью в файл. В начале функции проверяется, есть ли соедине- 
ние с сервером, и если нет, то выполнение функции после выдачи соответст- 
вующего сообщения пользователю завершается. Далее флаг записи в файл — 
переменная УтЦеСоп? устанавливается в фгие, если источником события 
(Зеп4ег) является действием АВе{гезВСоп?. В противном случае, если источ- 
ник — АВеа9Соп?Но5%, УгЦцеСопЁ = #Ё15е. В зависимости от выполняемого 
действия в панель состояния заносится тот или иной текст. Если должна вы- 
полняться запись в файл, то файл ЭЕРЦеСоп? открывается для записи, и в него 
заносится первая строка — имя сервера, с которого загружается список конфе- 
ренций. 

Затем очищается список СВСопф, в который будут заноситься названия 
конференций. Вызов метода Че СгоирГ! 15$ обеспечивает загрузку списка. Это 
может быть очень длительным процессом, поскольку списки ряда серверов со- 
держат десятки тысяч конференций. Поэтому перед вызовом @еСгопрГ!а8% 
форма курсора устанавливается соответствующей "песочным часам со стрел- 
кой”. Такая форма устанавливается, поскольку загрузка списка — процесс 
асинхронный. И пользователь может во время этого процесса осуществлять 
какие-то операции, в частности, может прервать загрузку списка. Перед нача- 
лом загрузки для списка СВСоп? снимается сортировка, чтобы ускорить его за- 
полнение и уменьшить мелькание. В этот момент можно также вызвать метод 
ВерлтОраме, отключающий перерисовку списка при его изменении (соответ- 
ствующий оператор в коде закомментирован). Это исключит мелькание строк 
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в СВСопё и несколько ускорит процесс чтения списка за счет отказа от перери- 
совки компонента. Но, с другой стороны, пользователю, пожалуй, интереснее 
видеть результаты чтения, чем сидеть перед неизменной картинкой на экране. 

Функция Че Сгопр![1 $ не возвращается до тех пор, пока не будет законче- 
но чтение списка. После того как функция возвращается, курсор обретает вид 
по умолчанию, и пользователю выдается сообщение об окончании загрузки 
списка. 

Пользователь может заскучать, пока скачиваются десятки тысяч наиме- 
нований конференций. Или может заподозрить, что компьютер завис. Поэто- 
му в приложении предусмотрен подсчет и вывод в панель состояния числа про- 
читанных конференций МСоп?. Пользователь видит это постоянно изменяю- 
щееся число и понимает, что компьютер трудится над выполнением его зада- 
ния. В функции АВеа4Соп!Ноз Ехесше число прочитанных конференций 
МСоп{ задается равным 0, а потом это число будет увеличиваться при чтении 
каждой новой конференции. В конце текстов, выводимых в панель состояния 
перед началом чтения, записано "О" — значение МСоп? в данный момент. 
А после чтения списка пользователь видит, сколько конференций прочитано. 

В процессе чтения списка конференций возникают события ОпСгочпр- 
Т15 Ордафе. Обработчиком этих событий является функция ММММТР1Сгочпр- 
Та Ордаже. Сначала в ней можно проверить сравнением Е1г$& Аги@е и Газ$- 
Агие, имеется ли в конференции хотя бы одна статья (соответствующий опе- 
ратор в приведенном коде закомментирован). Это позволяет отсечь массу мер- 
творожденных конференций, в которых нет статей. Правда, при этом отсекут- 
ся и только что созданные и потому пустые конференции. Так что включать 
или не включать такую проверку — это решать вам. Далее число прочитанных 
конференций МСоп{ увеличивается на 1, и в панель состояния выводится. 
текст, содержащий это число. Если требуется запись в файл (УгиеСопЁ = 
фгое), то в файл заносится строка с именем очередной конференции. Затем со- 
ответствующий элемент заносится методом А@Я в список СВСопёЁ. 

Функция АВеадСоп ЕПеЕхесще является обработчиком действия АВеад- 
СопЁЕПе — загрузки списка конференций из файла. В начале функции прове- 
ряется наличие на диске соответствующего файла. Конечно, тут надо было бы 
предусмотреть возможность выбора читаемого файла, а в рассмотренной выше 
функции АВеа4СопНо5{Ехесще — возможность выбора файла для записи. 
Но я не стал этого делать, чтобы не усложнять несущественными деталями 
и так достаточно громоздкий код. При желании вы сами легко сделаете соот- 
ветствующие добавления в код. Затем устанавливается форма курсора "песоч- 
ные часы”, так как, хотя чтение из файла — не очень длинная операция, но 
размер файла может быть очень большим. Файл открывается для чтения, 
и текст его первой строки (имя сервера) заносится во временную переменную 
5. Файл закрывается функцией С1озеЕШе. Значение строки $ заносится в окно 
ЕНо$+. Затем методом ГоаЯЕготЕЦе все строки файла загружаются в список 
СВСопЁ. Но первая строка этого списка лишняя — это имя сервера. Поэтому 
первый элемент списка удаляется методом Ваее. Индекс списка устанавли- 
вается равным 0 — первая конференция. В панель состояния выдается соот- 
ветствующий текст и возвращается форма курсора по умолчанию. 

Функция АВеад Аг Но$ Ехесще является общим обработчиком двух дей- 
ствий: АВеадЯАг{Но$ и АВегез В Аг — чтения списка статей без записи или 
с записью в файл. Эта же функция является обработчиком события 
ОпрЫСЦсК компонента СВСоп}ф, т.е. вызывается при двойном щелчке на спи- 
ске конференций. Функция построена аналогично рассмотренной ранее функ- 
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ции АКеадСопНо5&Ехесще: проверка соединения, выяснение того, какое из 
действий выполняется, выдача соответствующих текстов в панель состояния. 
Если должна производиться запись в файл, то этот файл открывается для за- 
писи и в него заносится строка с именем сервера и строка с именем конферен- 
ции. Далее устанавливается в фгие переменная Гоа4АгИиеГ 1$, указываю- 
щая, что загрузка списка производится с сервера. В заключение вызывается 
метод ЗеёСгопр, активизирующий выбранную конференцию. 

При вызове этого метода возникает событие ОпСгопр5@есф, обрабатывае- 
мое функцией ММММТР1Сгоир5 еесф. Поскольку метод Зе Сгоир вызывается 
в нескольких местах программы, в начале функции ММММТР1Огопр5 ес 
проверяется переменная Гоа4АгиеГ! 1$. В функции АВеадАг{Но${Ехесще 
этой переменной задается значение фгае. В этом случае очищаются список ста- 
тей СВАгие и список номеров статей 115Мит, форма курсора меняется на 
“песочные часы” и вызывается получение полного списка статей — метод 
Се АгиеГ15{ с параметрам АП равным фгие. 

В процессе выполнения метода аеАгиеТ! 1$ при чтении заголовка оче- 
редной статьи возникает событие ОпНеа4егГ 15$. Обработчик этого события — 
функция ММММТР1Неа4егГ.1$%. Тема статьи — свойство Неа4дегВесогд-—> 
Рг5иб]ес{ заносится в список СВАгище. Идентификатор (номер) статьи 
НеадегВесогд->РгАгиеТ@ заносится в список 115 Миш. Таким образом, спи- 
сок 4$ Миш заполняется синхронно со списком СВАги@е. Если требуется за- 
пись в файл (УгЦеАгф = %гие), то в него заносятся в виде отдельных строк 
тема и идентификатор статьи. Затем сравнением номера прочитанной статьи 
с максимальным номером Н1Мез5асе проверяется, не закончено ли чтение 
списка. Если закончено, в панель состояния выдается соответствующий текст 
и восстанавливается форма курсора. | 

Функция АКеа4АгЕЕПеЕхесле является обработчиком действия АВеад- 
Ан{ЕПе — загрузки списка статей из файла. Сначала проверяется наличие со- 
единения, которое потребуется в конце загрузки списка для активизации соот- 
ветствующей конференции. Затем изменяется форма курсора и выдается соот- 
ветствующий текст в панель состояния. Списки СВАгИее и 11$ Мат очища- 
ются. Проверяется наличие файла ЗЕПеАтф. Этот файл открывается для чте- 
ния. Тексты первых двух строк файла читаются и заносятся в ЕНо$$ и СВСопЕЁ. 
‚Предварительно из прочитанных строк удаляется последний символ — символ 
новой строки. Индекс списка конференций СВСо!Ё изменяется, чтобы соответ- 
ствовать записанному в СВСопЁ (просто для удобства пользователя). Затем 
в цикле читаются все строки файла и заносятся в списки СВАгИее и 1$ Мит. 
Перед занесением из этих строк также удаляется заключительный символ но- 
вой строки. После завершения чтения файл закрывается, задается Гоад- 
АгисеГ15{ = Ёа]5е и вызывается метод Зе Сгопр, активизирующий ту конфе- 
ренцию, для которой был прочитан список. Без вызова Зе Сгоир последующее 
чтение статей из списка было бы невозможным. При вызове ЭеёСгоир насту- 
пает событие ОпСгоирэ@ес+ и срабатывает его обработчик — описанная ранее 
функция ММММТР1Сгопрэеес&. Но на этот раз в ней не должно ничего про- 
исходить. Именно для этого и введена переменная Гоа4АгиееГ! 1$, значение 
которой в данном случае: Ёа[5е. 

Функция АВеаЧАг{Ехесще является обработчиком действия АВеаААг — 
чтения статьи. Функция начинается с проверок, есть ли соединение и с тем ли 
сервером оно установлено. Затем изменяется форма курсора и вызывается ме- 
тод чтения статьи ае Агие. В него должен быть передан идентификатор ста- 
тьи в виде целого числа. Для этого определяется индекс Цеп пех списка 
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СВАгие, берется элемент с тем же индексом из списка 11$ Мит и функцией 
Эи"То[ переводится в целое значение. 

Если статья успешно прочлась с сервера, наступает событие ОпАгие{е. Его 
обработчик — функция ММММТР1Агиае. В ней сначала очищается окно 
МАгие. Затем в него заносится строка вида “ Автор ...”, где вместо многото- 
чия фигурирует адрес автора статьи — свойство Неа4егВесога->РгЕгот- 
АЧ4ге$$. Если статья является ответом на какую-то другую статью, то в окно 
МАгие заносится строка вида "Ответ на ...”, где вместо многоточия фигури- 
рует адрес исходной статьи, которая обсуждается — свойство НеадегВесог9-> 
РгВер!уТо. После этого методом Аа и`те$ в окно МАги@е загружается 
текст статьи — свойство Воду. В окно ЕЗи ее заносится тема статьи — свой- 
ство Неа4егВесог4->РгЗиБ]ес{. В список ГВЕЦПез заносится список вложен- 
ных файлов (свойство АНаевтеп{$), если, конечно, такие файлы имеются. 

Если в статье имеются вложенные файлы, то при их извлечении из тела 
статьи и декодировании возникают события ОпОесоде$ $аг{ и Оп)есодеЕп@а 
соответственно в начале и в конце декодирования. Обработчиками этих собы- 
тий являются функции ММММТР1Оесоде фа и ММММТР1Фесо4еЕп4, вы- 
дающие в панель состояния соответствующие сообщения. 

Если при чтении статьи возникла ошибка, генерируется событие Оп-. 
пуаПдАгие. В его обработчике — функции ММММТР ПпуаПААгие, поль- 
зователю выдается сообщение об ошибке. 

Функция ГВЕЦезрЫсСИсК является обработчиком двойного щелчка на 
списке вложенных файлов ГВЕЦез$. В этом обработчике функцией ЭВеПЕхе- 
сше вызывается программа \1194о\%5$, связанная с выделенным в списке фай- 
лом и позволяющая пользователю посмотреть содержимое файла. 

Функция Ашеша4еЕЕхесие является обработчиком действия Ашеа- 
4еЕ — включения в статью, отправляемую в конференцию, какого-то файла. 
В этой функции с помощью компонента ОрепО1а1051 вызывается стандартный 
диалог открытия файла, и полное имя выбранного пользователем файла зано- 
сится в список ГВЕЦе$. Функция ГВЕ|ЦезКеу о\мп является обработчиком со- 
бытия ОпКеу омут списка ГВЕЦе$. Это событие наступает при нажатии поль- 
зователем какой-нибудь клавиши. В обработчике проверяется, не является ли 
эта клавиша клавишей ШОее!е. Если является, то выделенный в списке ГВЕЦез 
элемент с именем файла удаляется из него методом Веее. 

Функция АРо${Ат{Ехесше является обработчиком действия АРоз&Агё — 
отправки статьи в конференцию. В начале функции проверяется наличие со- 
единения с сервером. Затем проверяется, является ли конференция, название 
которой записано в окне СВСопр, активной. Если нет, то эта конференция ак- 
тивизируется методом Зе Сгопр. Предварительно переменная Гоа4АгиеТ 154 
устанавливается в #а15е, чтобы при обработке последующего события Сгопр- 
Зеесё в процедуре ММММТР1Сгопр5еес& ничего не совершалось. Поскольку 
в результате всего этого конференция, в которую отправляется послание, ак- 
тивна, свойство Розйпе указывает, можно ли в данную конференцию отправ- 
лять статьи. Если нельзя — пользователю выдается соответствующее сообще- 
ние. Если отправка статьи разрешена, то заполняются свойства компонента 
ММММТР1, определяющие содержание статьи и ее атрибуты. В свойство 
Ро5{Во4у заносится текст статьи, записанный в окне МАгие. В свойства 
Роз{Весога->РгЕготА99гез$ и Роз{Весог4->РгВКер!уТо заносится адрес 
электронной почты пользователя, записанный в константе МуЕтай. В свойст- 
во Ро$АНасЬтеп{5 заносится список вложенных файлов, хранящийся 
в ЕВЕЦе$. В свойство Роз Весог9->РгМем$Сгопр$ заносится название конфе- 
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ренции, в которую отправляется статья. Затем делается соответствующее сооб- 
щение в панели состояния и вызывается метод Роз Агие. 

Если инициированная этим методом отправка статьи завершилась успеш- 
но, наступает событие ОпРозед. Если произошла ошибка, наступает событие 
ОпРо5{ЕаПе4. Эти события соответственно обрабатываются функциями 
ММММТР1Рое4 и ММММТР1Ро&Еа!ед, выдающими пользователю соответ- 
стующие сообщения. 

Функция ААБог{Ехесще является обработчиком действия ААБог& — пре- 
рывания текущей операции. В этом обработчике закрываются файлы, если 
они были открыты, и вызывается метод АБог, прерывающий операцию. 

Последня функция кода АррИсайопЕует{ $15 ом Ниё является обработ- 
чиком событий ОпЗвомНи\ приложения. Эти события наступают, когда кур- 
сор мыши задерживается над каким-то компонентом, в свойстве ЭВо\Н т ко- 
торого установлено фгие. В нашем приложении это сделано в списках СВСопЁ 
и СВАгИе{е. В них может содержаться длинный текст, который не виден поль- 
зователю целиком. Обработчик АррИсайЙопЕуеп( $; 15$Бом Ни\ призван в подоб- 
ных случаях отобразить полный текст выделенного элемента списка во всплы- 
вающем ярлыке. Обработчик анализирует класс элемента, в котором возникло 
событие (свойство Ни Фо.Ни{Сопь:о1.С1аззМате). Если это список класса 
ТСошфоВох, то методом Тех УИ канвы формы проверяется длина этого 
текста и оценивается, не превыптает ли она ширины клиентской области окна 
списка. Сравнение ведется по канве формы, поскольку в компонентах СВСопЁ 
и СВАгие установлено свойство 5&Уе равным с5Эппр!е. При этом канва спи- 
ска ТСошфоВох оказывается недоступной. А шрифты формы и списков в дан- 
ном приложении одинаковы, так что для оценки длины текста можно исполь- 
зовать канву формы. Если текст выделенного элемента оказывается длиннее 
ширины окна, то в качестве текста ярлыка (параметр Ни ЗИ`) задается выде- 
ленный текст. 


Мы рассмотрели код данного примера. Конечно, этот пример чисто тесто- 
вый. В настоящем приложении можно сделать еще очень многое: организовать 
какое-то хранение и классификацию заинтересовавших статей и ответов на 
них, организовать быстрый поиск тем по каким-то ключевым словам и т.п. 
В рассмотренном примере могут также возникать проблемы с кодировкой ста- 
тей на русском языке. Вопросы кодировки будут подробно рассмотрены в кни- 
ге [5]. Так что здесь я не счел возможным на них останавливаться. Впрочем, я 
думаю, что рассмотренного достаточно, чтобы вы смогли на основе данного 
примера создать себе прекрасное приложение по своему вкусу, работающее 
с конференциями и серверами новостей. 


10.5.4 Компонент 1АММТР 


В семействе шау имеется свой клиентский компонент, работающий с про- 
токолом ММТР. Это компонент 1АММТР со страницы |паду Сйепк (в С++Вии- 
ег 2006, к сожалению, не функционирует). Многие его свойства и методы по- 
добны описанным ранее: Но$ — адрес сервера ММТР, Рог — номер порта 
(обычно 119), Озег{Ч — идентификатор пользователя, Разз\мог@ — пароль. 
Идентификатор пользователя и, особенно, его пароль требуют далеко не все 
серверы. Соединение с сервером осуществляется методом Соппес%, разрыв со- 
единения — методом О15соппес%. 

При соединении с сервером учитывается значение свойства Моде. Значе- 
ние тё5&геат соответствует возможности посылки на сервер группы статей. 


10.5 Телеконференции и служба новостей 867 


Значение ш_НАУЕ обеспечивает диалог с сервером относительно уже имею- 
щихся на сервере статей. Клиент информирует сервер о том, что у него имеет- 
ся данная статья, и посылает запрос о необходимости копировать ее на сервер. 
Все это достаточно экзотические варианты. А нормальный вариант — шёВеа- 
ег, обеспечивающий обычное общение с сервером и принятый по умолчанию. 

Реакция сервера на заданное значение Моде заносится в свойство Моде- 
Вези{. В зависимости от значения Мо4е свойство МодеВвези может прини- 
мать значения шгСап{геат или шгМоЗ&геат (при Мо4е = ше геат), 
шгСаШНАУЕ или шгМоНАУЕ (при Моде = шИНАУЕ), шгСапРо$ или 
шгМ№оРо$6 (при Моде = пёВеа4ег). Эти значения соответствуют возможности 
или невозможности операций посылки множества статей, диалога об обмене 
статьи, посылки новых статей. 

Когда произошло соединение с сервером, клиенту посылается число, опре- 
деляющее состояние соединения. Это число записывается в свойство агее Япг- 
Везо{ компонента 1АММТР. Свойство имеет тип ТСоппесИопВези{, объяв- 
ленный следующим образом: 


епим ТСоппес*1опКези1е {сгСапРоз®, сгМоРозЕ, сгАцЕ&ПКеаитгеа, 
сгТепрОпауа11ар1е}; 


Величина сгТетрОпауаПаЫе означает, что сервер временно недоступен. 
Значение сгАщ{ИВедилте4 свидетельствует о том, что для связи с сервером тре- 
буется авторизация: задание идентификатора пользователя и, возможно, па- 
роля. Значение сгМоРо$ свидетельствует о том, что соединение с сервером ус- 
тановлено, но доступны только операции чтения. Значение сгСапРо$% говорит 
о том, что соединение с сервером установлено и доступно для чтения и записи. 

При соединении с сервером возникает событие ОпСоппеее4. В обработчике 
этого события можно проанализировать свойство @бгеейпВези{ и выдать поль- 
зователю сообщение о текущем состоянии соединения с сервером. Например: 


$м1Есй (ТАММТР1->Сгее&1паВези1+) 
{ 
сазе сгСапРозе: Зсаби$Ваг1->$1тр1еТехЕе = 
"Установлено соединение с сервером " + 
Таммтр1->НозЕ + 
". Разрешено чтение и запись."; 
БгеаК; 
сазе сгМоРо$®: ЗКабизВаг1->$1тр1еТехе = 
"Установлено соединение с сервером " + 
Таммтр1->Но$* + 
". Разрешено только чтение."; 
Бгеак; 
сазе сгАа*ВВеац1геа: ЗбабозВаг1->51тр1еТехе = 
"Для соединения с сервером " + 
Таммтр1->Нозе + 
" требуется авторизация пользователя."; 
Бгеак; 
сазе сгТетрОпауа11аЪ1е: Зкаба$Ваг1->$1тр1еТехе = 
"Сервер " + ТАММТР1->Ноз® + 
" временно недоступен."; 


} 


Если при соединении с сервером произошла ошибка, генерируется исклю- 
чение ЕамМТРСоппесИйопВеЁи5е4. Оно автоматически вызывает метод 0\$- 
соппес{, разрывающий соединение. Возможна генерация и других исключе- 
ний. Так что установку соединения с сервером имеет смысл оформлять, напри- 
мер, следующим образом (подразумевается, что в окне ЕНо$% задан адрес сер- 
вера): 
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Таммтр1->НозЕ = ЕНозЕ->Техе; 
гу 

{ 

Таммтр1->Соппес® (); 


} 
саесь(...) 


{ 


ЗпомМе$зачде ("Ошибка в процессе соединения с сервером " + 
ТЯММТР1->Ноз%); 
} 


При явном или неявном вызове метода О15$соппесё возникает событие 
ОпП1зсоппесед. В его обработчике можно сообщить пользователю о разрыве 
соединения. Например: 


ЗБаки$Ваг1->51тр1еТех® = "Соединение с сервером разорвано"; 


Проверить, установлено ли соединение, можно в любой момент методом 
Соппефеа. Именно методом, а не свойством, как было в компоненте 
ММММТР. Например: | 


1Е (Таммтр1->Соппесфеа () } 


После того как соединение установлено, можно получить с сервера список 
конференций одной из перегруженных форм функций Се МемСгоирГ!1$% 
и Се Ме\Сгопр$Г1$6: 

%У01А __Еаз®са11 СееМемизагочрЬ1$% (уо1а); 

у01А __Еаз&са11 СееМмемзагоирЬ 1$ (С1аз5ез: :Т5&г1п49$3* АГ15$е); 

У01А __Еаз®са11 СееМемиСгопр$11$% (сопзЕ бузеем::ТрафеТ1ме Арафе, 

сопзе Боо1 АСМТ, 

соп5Е Ап515бЕг1па Ар15ехг1ра 101$); 
у01А __Еаз®са11 СееМембгопрз115$% (сопзе бузеем: :ТрафеТ1ме АрБафе, 

соп5зе Роо1 АСМТ, 

соп5Е Апз15Ег1па АО1$6г1раетоп$, 

С]аз5ез: :Т56г1па$* АГ15$6); 


Функции Се{Мем5гоирГ!1 5 инициируют чтение всего списка конферен- 
ций. А в функциях Се МемСгопр$[1$ параметр АДае указывает начальную 
дату списка. В список будут включены только те конференции, которые появи- 
лись после указанной даты. Если нужен полный список, можно задать значение 
АЛа{е равным 0. Параметр АСМТ указывает, какое время использовано при за- 
дании АДафе: фгие — универсальное (по Гринвичу), Ёа]5е — локальное. Нали- 
чие в этих функциях параметра АДафе облегчает обновление списка конферен- 
ций, полученного ранее и запомненного на компьютере в каком-то файле. Надо 
только в том же файле запоминать дату получения списка с сервера. Тогда при 
желании обновить список, добавив в него новые конференции, надо вызвать 
функцию Се МемСгопрзГ1$$, передав в нее дату предыдущего считывания. 

Параметр АР БиИоп$ в вызовах функций Се МемСгопр$Г1$ лучше 
всего задавать равным пустой строке, так как далеко не все серверы восприни- 
мают этот параметр. 

Если используется первая форма функции Се МемузтгопрГ! 156 или функ- 
ции Се МемСгопр$Г1$%, то при чтении названия каждой новой конференции 
генерируется событие ОпМемСгопр$Г.1$%. Заголовок обработчика этого собы- 
тия имеет вид: 

у01А _ Еаз®са11 ТЕГогм1 : : ТАММТР1Мембгоир$11$5 ( 

соп5е Ап51бЕг1лпа АМеизагочцр, 


соп5$Е ОИОВО АГом, сопзЕ РМОВО АН19П, 
соп$е Ап$156г1па АТуре, Роо1т &АСапСоп&1пие) 
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Параметр АМем5егопр содержит название группы. Параметры АЁГом 
и АН№В определяют минимальный и максимальный идентификатор статей 
в группе. Если АГом > АНИ, значит, в конференции нет ни одной статьи. 
Это позволяет при желании отсечь подобные конференции, которых очень 
много в Инетернете. Параметр АТуре определяет тип конференции. Обычно он 
равен “у” — разрешается читать и посылать новые статьи, “п” — разрешается 
только чтение, “ш” — конференция модерируется, т.е. новые статьи включа- 
ются только после их проверки. Параметр. АСапСопИпие определяет, надо ли 
продолжать чтение списка. 

Например, обработчик события ОпМемСгоир5$1.15{ может состоять всего из 
одного оператора: 


СопроВох1 ->ТЕемз->Адаа (АМемзагоцр); 


В результате в компоненте СошфоВох1 сформируется полный список всех до- 
ступных конференций. При желании исключить конференции, в которых нет 
ни одной статьи, оператор может быть изменен следующим образом: 


1Е(АГом <= АН1аН) СомБоВох1->Т%етз->Ааа (АМемзагопр); 


Если вы вызываете вторую форму функции бе Ме\з5гопрГ! $ или функ- 
ции СеМе\уСгопр$Г1$%, то параметр АТ1$$ указывет объект класса ТЗИ“т2$, 
в который заносятся результаты. Это может быть, например, свойство Цетз$ 
выпадающего списка СотбоВох, или свойство Шиез окон редактирования 
Мето и В1сепЕЗЦ. Например, загрузка списка конференций в компонент 
СошБоВох1 может быть организована всего одним оператором: 


Таммтр1->СбеЕМемСгопр$11$% (0, Еа1зе, "", СопроВох1->ТЕемз); 


Впрочем, поскольку чтение списка происходит несравненно быстрее, чем 
при рассмотренном в предыдущих разделах чтении компонентом ММММТР, 
необходимо избежать мерцания компонента СотБоВох1. Так что лучше офор- 
мить чтение следующим образом: 

СопооВох1->Гбепз->Ведч1п0Орааее (); 


Таммтр1->бсеМемСгоир$[1$6 (0, Еа15зе, "", СопроВох1->Теетз); 
СопроВох1->Т&емз->Епа9раа%е (); 


При чтении списка рассматриваемым вариантом функций надо учесть, что 
строки списка в этом случае имеют формат: 


<название конференции> <АГо> <АН1> <тип> 


где АГо и АН! — минимальный и максимальный идентификаторы статей 
в группе. Если вас устраивает такая форма строк, то ничего более делать не 
надо. Если же вы хотите раситифровать строку, выделив в ней отдельные син- 
таксические элементы, то это можно сделать функцией РагзеМем$Сгоцр: 


Уу01А __Еазеса11 РагзеМемзСкочр (Ап515ег1па Арлпе, 
Ап$15Ег1па &АМемзСгочр, 
ипз1апеЯа &АН]1, | 
ип51апеа &Ао, 
Ап515Ег1па &Аббса®аиз); 


Параметр АГШпе — это исходная строка описанного выше формата. Пара- 
метр Апе\м$Сгопр — выделенное из строки название конференции. Парамет- 
ры АН\1, АГо и АЗфайа$ соответственно индексы статей и тип конференции. 
Возможные значения типа "у", “п” и "т" не отличаются от получаемых в опи- 
санном выше обработчике события ОпМемСгопр$1:1$%. 


870 Глава 10. Сетевые службы 


Ниже приведен пример чтения списка конференций с выделением заголов- 
ков и с устранением из списка конференций, в которых нет ни одной статьи. 
15611109156 *15Е = пем Т5ег1пар15$е; 
Таммтр1->СсеЕМембСгоир$11$% (0, Еа1зе, "", 1156); 
Ап515Ег1па 5, Аббабаз; 
ип5$1апеа АГо, АН]; 
СВСопЕ->Т$епз->Вед1пИОраа*е (); 
Рог (1106 1=0; 1 < 11$5->Сочпе; 1++) 
{ | 
Рагземем$Сгоир (11$Е->5Ех1па$ [1], 5, АН1, АЬо, АбЗба®а$); 
1Е(АГо <= АН1) 
СВСопЕ->Т$ем$->Ааа (5); 


} 
Т1$Е->Егее(); 
СВСопЕ->ТЕетз->ЕпаЯОрадате (); 


В примере подразумевается, что результирующий список должен быть за- 
несен в компонент СопфовВох с именем СВСоп[. Сначала создается объект 11$% 
класса 'Т5%$г1те1Т1$%, и него методом @ае МемСгопр$Г15$6 заносится список всех 
конференций. Затем в цикле просматриваются строки списка, дешифруются 
функцией РагзеМеузСгоцпр, и те конференции, в которых имеются статьи, за- 
носятся в список СВСопЁ. Перед циклом перерисовка списка СВСопЁ запреща- 
ется методом Верт Орда. По окончании цикла перерисовка восстанавлива- 
ется методом ЕпЧ Орде, и объект 115% уничтожается. 

При выборе той или иной из рассмотренных функций чтения списков кон- 
ференций надо иметь в виду, что они часто читают с одного и того же сервера 
разные списки. Функции де МемСгопр$Гл$& даже при АДафе = 0 выдают суще- 
ственно более короткие списки. Но зато в них практически все конференции 
живые. Функции бе Ме\м$гопр!1$& могут выдавать на порядок более длинные 
списки и, соответственно, затрачивать на это на порядок большее время. Выда- 
ваемые ими списки практически те же, что выдает компонент ММММТР. Но 
среди полученных конференций многие не содержат ничего. Так что представ- 
ляется разумным во всех случаях использовать функции Че МемСгопр$Г1$. 

Чтение списка статей некоторой конференции осуществляется функция- 
ми Се Ме\уМе\м$Т15$4: 

у01А _ Еазеса11 СееМемМемз115$% (сопзе Ап$15ег1па АМемзагочрэз, 

соп5зЕ бузфет::ТРаееТл1те АПафе, 

соп$Е Боо1 АСМТ, 

Ап$15Ег1па АР1зЕг1рае1оп$); 
у01А __Еаз®са11 СееМемМ№емз115$% (сопзе Ап5156г1па АМемзагочрэз, 

соп5Е бузфем: :ТРафеТз1ме Арафе, 

соп5® Боо1 АСМТ, 


Ап$15Ег1па Ар1зег1рае1оп$, 
С]аз5ез: :Т5Ег1па$* АГ156); 


Параметр АМем$2гоир$ является наименованием конференции, а остальные 
параметры те же, что были описаны ранее для функций Се Мем’Сгоир$1Г15$$. 
И различие двух форм функции Се Мем’/Меу’$Гл$& аналогично различию между 
формами функции Се МемСгопр$Г1$. Первая форма вызывает генерацию для 
каждой статьи события ОпМемМе\м/$Г1$%. Его обработчик имеет вид: 


уо1а __Еаз®са]11 ТЕМемз: ; ТАММТР1МемМем$115® ( 
соп5Е Ап5156х1па АМзаТр, Боо1 &АСапСоп®1пае) 


Параметр АМз)О — это идентификатор статьи, а параметр АСапСоп8- 
ппе позволяет прервать процесс чтения списка статей. 

Вторая форма функции бе МемМем$Г1$% позволяет непосредственно зане- 
сти список статей в список АГ1$$. 
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Все очень просто, но, увы, при вызове функции де Мем’Ме\м/$Г1$% в любой 
форме вас может подстерегать главная неприятность — появление сообщения: 
"МЕУ/МЕХУ$ соштапа 41за]еа Бу аЯт111$%4гафог” — команда МЕХМ/МЕ\МУВ за- 
прещена администратором. 

В этом случае остаются только обходные маневры. Можно в цикле пройти для 
выбранной конференции все номера статей, которые, как было показано выше, по- 
лучаются при чтении списка конференций. И для каждой статьи прочитать ее за- 
головок. Делать это можно так. Прежде всего, над активизировать выбранную 
конференцию. Активизация осуществляется вызовом функции Э@щес&Сгочцр: 


У01А _ Еаз®са11 5е1есеСкочр (сопзЕ Ап$з156г1па АСкопр); 


Параметр АСгоир — название активизируемой группы. 

После активизации конференции можно в свойствах Мз2Т.ом, МзеН1ев, 
М5=Соппё компонента 1АММТР прочитать минимальный номер статьи, макси- 
мальный номер и число статей. Имеются также свойства Мз#М№ш и Ме) — 
номер и уникальный идентификатор текущей статьи. Имеются методы Мех& 
и Ргеу!1ои$, обеспечивающие перемещение по статьям: 


роо1 __Еаз$са]11 Мех® (уо1а); 
роо1 __Газ®са11 Ргеутола$ (у014); 


Эти методы возвращают #а]5е, если делается попытка выйти за пределы спис- 
ка статей. 

С помощью этих свойств и методов можно организовать различные вари- 
анты циклического просмотра номеров статей. В цикле можно читать заголов- 
ки статей функцией бе Неафег: 


роо1 _ Еаз®са11 СефНеааег (сопз® ипз1апеа АМздЗ№Мо, 
| соп$Е Ап$156г1па АМзатр, 
Тапеззаде: :ТТаМеззаае* АМ$ад); 


Параметр АМ$еМ№ о задает номер статьи, а параметр АМТ) — ее иденти- 
фикатор. Если задано значение АМ$ О, то значение АМзМ№ о должно равнять- 
ся нулю. А если задано непустое значение АМ$=ТО, то значение АМ$ ГО безраз- 
лично. Параметр АМ$$ является указателем на объект класса Т1АМеззаге. Объ- 
екты этого класса хранят различные сообщения Интернета и имеют множество 
свойств. Нас сейчас интересует одно из них — Зи ес. Это тема статьи. 

Таким образом, чтение списка статей без использования функций (е- 
МемМе\м5Т15 может иметь следующий вид: 

Таммтр1->5е1есескочр (5СопЕЁ); 

ТТамеззаае * АМза = пем ТТАаМеззаче (11$); 

СВАг*1с1е->С1еаг(); 

Еог (апз1апеяая 1 = Таммтр1->МзаЬом; 1 <= Таммтрт->М5аН1ай; 1++) 

< ТаЮнтР1->боенеааег (+, "", АМ5а); 

1Е (АМза->баресе != "") 
СВАг&1с1е->Т+еепз->Ада (АМза->5аБлес*); 

Ава >Егее (); 

В приведенном коде предполагается, что в переменной %Сопф записано на- 
звание конференции. Эта конференция активизируется методом Э@ес&Сгоцр. 
Список статей заносится в список СошфоВох с именем СВАгИие. Цикл орга- 
низован по номерам статей активной конференции от значения МзеГо\ до 
значения Мз2Н1еВ. Перед занесением в список проверяется, не пуста ли тема 
статьи, так как статью без темы заносить в список не имеет смысла. 
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Чтение статьи осуществляется функцией Се АгИиее: 


роо1 _ ЕазЕса11 СекАгЕ1с1е (сопзЕ ипз1апеа АМзамо, 
соп5е Ап$15Ег1па АМзатр, 
Тапеззаде: :ТТаМеззаае* АМ5$а); 


Ее параметры идентичны рассмотренной ранее функции беНеафег. Но она за- 
носит в объект АМ$х не только заголовок, но всю информацию о статье. 

‚Статьи из конференций, как правило, поступают в некодированном виде. 
Поэтому перед получением информации надо установить в %фгие свойство 
МоПесо4е объекта АМ$#. Тогда после вызова функции Се Агие в свойстве 
Воду класса ТЗ те$ этого объекта можно прочитать текст статьи. 


Отправка на конференцию собственной статьи осуществляется методом 
Зепа: 


Уу01А __Еаз®са11 5епа (Тамеззаде: :ТТаМеззаае* АМз4а); 


В объекте АМ$х предварительно должны быть заданы описанные ранее 
элементы послания: Воду, Зи есё. Надо также задать МоОбесо4е = фгие 
и сформировать свойство Егош класса ТЧЕМаПА@94геЦет. Объекты этого 
класса имеют три свойства типа Ап$15%гше: А94гез$ — почтовый адрес отпра- 
вителя, Мате — имя отправителя, Тех — полный адрес, включающий имя 
отправителя и его почтовый адрес. Достаточно задать или АЯ9@гез$ и Мате, 
или Техё — в этом случае почтовый адрес отделяется от имени пробелом и за- 
ключается в угловые скобки. 

Мы рассмотрели основные свойства и методы компонента 1АММТР, необ- 
ходимые для построения клиентского приложения конференций. Теперь рас- 
смотрим пример построения подобного приложения. На приложенном к книге 
диске вы найдете его для С++ВаПаег 6 в каталоге Соп{егепсе в проекте 
РСоп Ппау. Оно показано на рис. 10.10. Этот проект подобен рассмотренному 
в разд. 10.5.3, но несколько сокращен и построен на компоненте 1АММТР. Со- 
кращения коснулись в основном работы со вложенными файлами, так как 
обычно они не фигурируют в конференциях. 
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Ниже приведен код приложения РСоп пау. 


// Прежде, чем выполнять данный пример, его надо настроить 


// В компоненте ММММТР1 в свойствах АЁЕасрЕ11еРаЕВ и 

// М№еи5р1г задайте калалог для хранения полученных файлов. 
// В свойстве ПзегТа задайте свое имя как пользователя 

// Если связываетесь с сервером, требущим пароля, 

// укажите пароль в свойстве Раззиога 


// Задайте значения введенных в тексте констант: 

// $Е11еСопЕ - полное имя файла со списком конференций 
// $Е11еАгЕ - полное имя файла со списком статей 

// МуЕта11 - ваш адрес электронной почты 


ЕТЬЕ* ЕС; 

ЕТЬЕ* ЕА; // Файловые переменные 
Т5Ег1п911$6е *1$ЕМим = пем Т5&г1п1911$6;// Список номеров статей 
Ап$15г1па 5Е11еСопЕЁ = "Е11еСопЕТрау. ЕхЕе"; 

Ап$15Ег1па 5Е1]1еАгЕ = "Е11еАгЕТпау.ехе"; 

Ап$15Ег1па МуЕта11 = "123@.456.ги"; // Адрес ета11 
ИИ------нененаанан-н--на----нн---нн---------------=----- 


У01А _ Еаз®са11 ТЕМемз: : Роги)езегоу (ТОБ]есе *бепаег) 
// Завершение работы . 
{ 
1Е (Таммтр1->Соппесфеа()) таммтр1->р1зсоппесе (); 
Т15ЕМим->Ргее (); 


у01А __Еаз®са11 ТЕМемз: : АСоппес%Ехесиее (ТОр)]есе *5епаег) 
// Установка / Разрыв соединения 
{ 
1Е (АСоппесЕ->Свескея) 
{ 
Таммтр1->Нозе = ЕНозе->Техе; 
Сфафа$Ваг1->51тр1еТехе = 
"Осуществляется соединение с сервером " + 
Таммтр1->Ноз$е; 
5сгееп->Сагзог = сЕНочгС1аз$$; 
гу 
{ 
Таммтр1->Соппес® (); 
‚} 
саесь (...) 
{ 
ЗпомМеззасде ("Ошибка в процессе соединения с сервером " + 
ТаммтРр1->Ноз®); | 
АСоппес®&->Спескея = Еа1$е; 
} 
} 
е1зе ТаммтрР1->01$соппесе® (); 


5сгееп->Сигт5ог = сгрегаа1+; 
Стасч$Ваг1->51тр1еТехЕ = "Соединение с сервером разорвано"; 


Уу01А __Еазфса11 ТЕМемз: : АВеаЯСопЕНоз®Ехеси*е (ТОБ]есе *бепаег) 
// Чтение списка конференций с сервера 

{ 

1Е (! Таммтр1->Соппесфеа () ) 

{ 
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ЗПпомМеззасде ("Нет соединения"); 

гебцгп; 

} 
5сгееп->Сигзог = сгНоагС1а$3; 
Боо1 Иг1ЕеСопЕЁ = (бепаег == АВеЕгезЮСопЕЁ); 

1Е (Мг1веСопЕ) 

{ 

ЗбабазВаг1->51тр1еТехЕе = 

"Загрузка списка конференций с сохранением в файле"; 

ЕС = Еореп (5Е11еСопЁ.с 56г(),"мёе"); 

Ере1пЕ Е (ЕС, "%$3\п", Таммтр1->Но$®) ; 

Ере1п Е Е (ЕС, "%з\п", РаъеТ1меТо$ г (М№ом ())); 

} 
е15е 

Зсаси$Ваг1->51тр1еТехЕе = 

"Загрузка списка конференций с сервера"; 

Т5Е:11911$6 *11$6 = пем Т56г1п911$%; 
Таммтр1->СееМемСгоцрзТ1$% (0, ЁЕа1$зе, "", 115%); 
Ап$15Ег1па 5, Аббаби$; 

СВСопЕ->С1еат(); 
и1п519пеа АГо, АН]; 

СВСопЁ->Т$епз->Веа1пОраа*е (); 

Еог (110% 1=0; 1 < 115$Е->СоцпЕ; 1++) 

{ 

РагзеМемзСкочр (11$&->56г1109$[1], 5, АН1, АГо, Абфаеа$); 

1Е(АГо <= АН1) 


СВСопЕ->Тфетз->Ааа (5); 
1Е (Мг1ееСопЕ) Ерг1пЕ Е (ЕС,"%$з\п", 5); 
} 
} 
113 ->Ргее (); 
СВСопЕ->Т$ещ$->ЕпАПОраа*е (); 
ЗЕафказВаг1->$51тр1еТехе = 
"Загружен список конференций сервера " + 
Таммтр1->Нозе +" ("+ 
Тре ТобЕг (СВСопЕ->ТЕетщз->СоцпЕ) + 
" наименований)"; 
1Е (Мг1®ееСопЕ) 
{ 
Ес1озе (ЕС); | 
ЗсафтазВаг1->51тр1еТехе += " и сохранен в файле"; 


} 

ТЕ (СВСопЕ->Т6емз$->Сочп® >= 0) 
СВСопЕ->Т+епТпраех = 0; 
бсгееп->Сагзог = сгреЁЕай]1*; 


\014 __Еаз®са11 ТЕМемз: : АВеаЯСопЕЁЕ11еЕхесиее (ТОр)]есе *5епаег) 
// Чтение списка конференций из файла 


{ 
сраг $[100], $1[100]; 


1Е (! ЕР11еЕх1$%$ (5ЕР11еСопЕЁ)) 
ЗВомМез$засще ("Файл '" + $5Е11еСопЕЁ +"' не найден"); 
гебагп; 


} 
ЗЕафазВаг1->$51тр1еТехе = 
"Загрузка списка конференций из файла"; 
5сгееп->Сигзог = сгНоцгС1а$$; 
ЕС = Еореп (5Е11еСопЕ.с_$%г(),"г®"); 
Еаеез ($,100,ЕС); 
$ [5Ег1епт ($) -1]='\0'; 
ЕНо$®->Техе = 5; 
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Еаеез (5$,100,ЕС); 

$ [56 г1еп ($) -1]='\0!; 

Ес1озе (ЕС); 

СВСопЕ->богфеа = Еа15$е; 

СВСопЕ->Т+епз->ЬоааЕгомЕР11е (5Е11еСопЕЁ); 

СВСопЕ->Т6епз->0е1ебе (0); 

СВСопЕ->Т6епз->0е1еёе (0); 

СВСопЕ->5огЕеа = +гае; 

1Е (СВСопЕ->Т&ем$->Соипе >= 0) 

СВСопЕ->Т6епТпаех = 0; 

ЗтасазВаг1->51тр1еТехЕ = "Сервер " + ЕНоз®%->ТехЕе + 

", список загружен из файла от " + 

Ап$156г1па (5); 

5сгееп->Сагзог = сгр)еЁЕац1{; 


} 


у01А __Еаз$са11 ТЕМемз: : АВеадАгеНозеЕхесиее (ТОр)]ес® *5епаег) 
// Чтение списка статей с сервера | 
{ 
1Е (! Таммтр1->Соппестеа ()) 
{ 
ЗВомМеззасде ("Нет соединения"); 
гебагп; 
} 
Боо1 Иг1%ЕеАгЕ = (бепаег == АВеёЁгезвАг*); 
1Е (Мг1беАг®) | 
{ 
Ап515Ег1па 5; 
Зсаса$Ваг1->51тр1еТехе = 
"Загрузка списка статей конференции '" + 
СВСопЕ->Техе + "' с записью в файл"; 
ГА = Еореп (5Е11еАге.с 56г(),"мё"); 
$ = ТАММТР1->Ноз$Е; 
Ерг1п&Е (РА, "%$3\п", 5); 
5 = ОабеТ1теТоб ег (№ом()); 
Ерг1пеЕ (РГА, "%5\п", 5); 
} 


е1зе 
Сфаса$Ваг1->5$1тр1еТехЕ = 
"Загрузка списка статей конференции '!" + 
СВСопЕ->Техе + "'!"; 
5сгееп->Сигзог = сгНопгС1а$$; 


// Таммтр1->сеЕеМеиМ№еиз 115$ (СВСопЕ->ТехЕ, 0,Еа]1з5е, 
// "", СВАКЕТС]е->ТЕетз$); 
Таммтр1->5е1есЕСгопр (СВСопЕ->Тех®); 

ТТамМеззадче * АМза = пем ТТаМеззасде (+115); 
СВСопЕ->ТвкепшТпаех = СВСопЕ->Твепз->ТпаехоЕ (СВСопЕ->Тех{); 
СВАг&1с1е->С1еаг(); 

Еог (ипз1апеа 1=тТаммтр1->Мзаом; 1 <= Таммтр1->МзаН1ав; 1++) 
{ 


Таммтр1->сеЕНеаает (1, "", АМза);. 
1Е (АМза->би6)есе != "") 
{ 
СВАг&1с1е->Т6етз->Ааа (АМза->5аю]ес®); 
1 $ЕМап->Ааа (ТпЕТобекг (1)); | 
Арр]11сае1оп->Ргосез$Меззасвез (); 
1Е (Иг1тееАг®) 
{ 
Ерг1пЕЕ (ГА, "%$$\п", АМза->5аблес®); 
Ере1п ЕЕ (РГА, "%$$\п", ТпЕТобек (1)); 
} 
} 
} 
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АМза->Егее (); 

Зтаса$Ваг1->51тр1еТехёе = 
"Загружен список статей конференции " + 
СВСопЕ->Техе + " сервера " + ' ' + 
Таммтр1->Нозе + " ("+ 


ТпЕТобеЕгк (СВАГк1с1е->Т$&епз->Соип®) + 
" наименований)"; 

1Е (МглееАхгф) 

{ 

Ес1озе (ЕС); 

ЗсакизВаг1->51тр1еТехЕ += " и сохранен в файле"; 

} 
1Е (СВАг1с1е->Тепз->СойппЕ >= 0) 

СВАге1с1е->ТЕепТпаех = 0; 
бсгееп->Сцуизог = сиреЕац]1{; 


\01А __Еаз®са11 ТЕМемз: : АВеаЧАг%Е11еЕхеса(е (ТОБ]есе *5бепаег) 
// Загрузка списка статей из файла | 

{ 

саг $Н[100]; 

спаг $С [100]; 

1Е(! Таммтр1->Соппесееа () ) 

{ 


ЗромМеззаде ("Сначала надо соединиться с сервером"); 


гебигп; 
} 
$сгееп->Сагзог = скНочгС1аз3; 
ЗбабозВаг1->$1тр1еТехе = 
"Загрузка списка статей конференции '" + 
СВСопЕ->Техе + "' из файла"; 


СВАгЕ1с1е->С1еах(); 
.15ЕМит->С1еах(); 
1Е (Р11еЕх15$%$ (бР11еАкЕ)) 
{ 
ГА = Еореп (5Е11еАге.с зек(),"ге"); 
Еаеф$ ($Н,100,ЕА); 
Ече*$ (5С,100,ЕА); | 
$Н[ 56 к] еп ($Н) -1]='\0'; 
$С [36 х1еп ($С) -1]='\0'!; 
ЕНозе->ТехЕе = 5$Н; 
СВСопЕ->ТехЕ = 5С; 
1Е (СВСопЕ->Ткещз->ТраехоЕ($С) >= 0) 
СВСопЕ->ТеепТпаех = СВСопЕ->Т&епз->ТпаехоОЕ (5С); 
иВ11е (! ЕеоЕ(ЕА)) | 
{ 
Еаее$ ($С,100,ЕА); 
$С [536 х]1епт ($С)-1]='\0!; 
СВАгЕ1с1]е->ТЕепз->Ааа (5С); 
Еаефз ($С,100,ЕА); — 
$С [56Ех1еп ($С) -1]='\0!'; 
13 $ЕМам->Ааа ($С); 
} . 
Ес1о5е (ГА); 
Таммтр1->5е1есесгкопр (СВСопЕ->Тех®); 
1Е (СВАг1с1е->Ткетз->Сойпп® >= 0) 
СВАге1с1е->ТеепТпаех = 0; 
ЗЕабизВаг1->$1тр1еТехЕе = "Сервер " + ЕНо5®->Техе + 
", конференция " + СВСопЕ->ТехЕ + 
", список загружен из файла"; 
} 
е1зе ЗРомМеззасе ("Файл '" + $5Е11]еАкгЕ +"' не найден"); 
бсгееп->Сигзог = сгреГап1%; 


} 
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Уу01А _ Еаз&са11 ТЕМемз: : АВеаЯАг%Ехеси*е (ТОЮ)ес® *5епаег) 
// Чтение статьи | 

| _. 
1Е (! Таммтр1->Соппесееа()) 

{ 

ЗПпомМез$засде ("Нет соединения"); 
тебсагп; 


} 
1Е (ТАаммТР1->Ноз$Е != ЕНозе->Тех+) 
{ 
ЗВомМеззаае ("Соединение не с тем сервером.\п" 
"Разорвите соединение и снова соединитесь"); 
гефбатп; 
} 
5сгееп->Сигзог = сгНойгС1а$$; 
ТТамеззаае * АМза = пем ТТАаМеззасе (+115); 
АМ$а->Моресо4е = ф$гце; 
Таммтр1->сСесАгЕ1с1е (5 гТоТпе ( 
| 15 М№ам->56к1па$ [СВАгЕ1с1е->Т%&еп!Гпаех]), "", АМза); 
ЕЗиб)]ес®*->ТехЕ = АМза->5аБ]есЕе; 
МАге1с1е->С1еаг(); 


МАге1с1е->1пез->Ааа ("Автор: " + АМза->Егом->ТехЕе); 
МАге1с]е->1пез->Ааа5 Е г1па$ (АМза->Воау); | 
бсгееп->Сиагзог = сгрегац1*; 

} 
Ииннннннннннннн-==================-=======-===-=--=-- 


у01А _ Еаз®са11 ТЕМемз: : АРозсАгеЕхесиее (ТОБ]есЕ *бепаег) 
// Отправка статьи в конференцию 


{ 
1Е (! Таммтр1->Соппес*еа ()) 


{ 
зрпомМе$заде ("Нет соединения"); 
гесиагп; 


} 


Зсаеа$Ваг1->51тр1еТехЕ = "Отправка статьи в конференцию " + 
СВСопЕ->ТехЕ; 

ТТаМеззаде * АМза = пем ТТаМеззаче (411$); 

АМ ч->Воау->Аззтап (МАгЕ1с1е->11пез); 

АМза->5ир]есе = ЕбаБ]ес®->Техе; 

АМ5а->Ргоп->Ааагез$ = МуЕтма11; 

АМ5а->М№оресоае = +гие; 

‚ ТАаммтр1->5епа (АМза); 

АМ5а->Егее (); 


Ии----н-нн-нн-=-=-=-=====================-===-===-==--- 
у01А __ЕазЕса11 ТЕМемз: :№17С11сК (ТОБ)]есЕ *бепаег) 

С1озе (); 

} 
И-----------на------н--------------------------------------- 


у014 __Газ®са11 ТЕМемз: :Арр11са®1опЕуеп&$15ПомН1пе ( 
Ап515Ег1па &Напебег, 
Боо1 &Сап5Вом, ТН1пЕТпЕо &НтпЕТПЕо) 


1Е (НаоЕТоЕо.Н1пеСопего1->С1аззМамтеТз ("ТСотшроВох") ) 
{ 
ТСомроВох * оЪ] = (ТСопроВох *) Нап ТпЕо.Н1пСопего1; 
1Е (о) ->ТеемТпаех >= 0) 
1Е (Сапуаз->ТехЕм1аеь (о) ->Т6ет$->5&г1па$ [о] ->Г6епТпаех]) > 
ор7->С11еп Е И1аев) 
{ 
Напе5ег = об] ->1тЕетз->5Ег1паз [ор] ->Т$еп!Тпаех]; 
Арр11са*1опЕ\уепе$1->Сапсе101зрафсВ (); 
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Уу014 _ Еаз®са11 ТЕМемз: : ТАММТР1Соппесееа (ТОБ)есе *5епаег) 
{ 
Зсгееп->Сиагзог = сгреЁач1*; 
$зм1ЕсВ (ТАаммтР1->Сгее&1паВезо1{) 
{ 
сазе сгСапРозе: Збака$Ваг1->51тр1еТехе = 
"Установлено соединение с сервером " + 
Таммтр1->Нозе + 
". Разрешено чтение и запись."; 
Бгеак; 
сазе сгМ№оРо$®: ЭкаказВаг1->51тр1еТехе = 
"Установлено соединение с сервером " + 
Таммтр1->Нозе + 
". Разрешено только чтение."; 
ЬБгеаКк; 
сазе сгТепрОпауа11аЪ]1е: ЗеабизВаг1->5$1тр1еТехЕе = 
"Сервер " + ТАММТР1->Нозе + 
" временно недоступен."; 
Бгеак; 
сазе сгАч&РКеаи1геа: ЗфабазВаг1->$1тр1еТехе = 
"Для соединения с сервером " + Таммттр1->НозЕе + 
" требуется авторизация пользователя."; 
Апз15Ег1па 5; 
Боо1 1; 
1Е (ТАаммтр1->ОзегтТа == "") 
{ 
`1Е (ТТ == Тпра®Очегу ("Нужна идентификация", 
"Введите ваше имя", 5)) 
Таммтр1->0зегта = 5; 
} 
1Е (ТАаммтР1Т->РаззмогкА == "") 
{ 
1Е (ТпраЕОцеку ("Нужна идентификация", 
"Введите пароль", 5)) 
{ 
Таммтр1->Раззмога = $5; 
Ъ = ское; 


} 


1Е(). 
{ 


Зсгееп->Сигзог = сгНочгС1аз$$; 
Таммтр1->Соппесе (); 
ее ЗЕаеазВаг1->$51тр1еТехе = 
"Соединение разорвано"; 
Бгеак; 
} 

} 

Большинство процедур, использованных в этом коде, было описано при 
рассмотрении компонента ММММТР. Так что ограничусь краткими замеча- 
НИЯМиИ. 

Файл, в котором сохраняется список конференций, отличается от рас- 
смотренного в разд. 10.5.3 тем, что второй строкой в него записывается дата 
и время получения списка с сервера. В данном приложении эта информация 
используется только в сообщении, выдаваемом пользователю. Но вы можете 
дополнить приложение кодом, который по желанию пользователя дополня- 
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ет файл новыми конференциями, появившимися после этой даты. Файл, 
в котором сохраняются названия статей, не отличается от рассмотренного 
в разд. 10.5.3. 

В функции АКеадАгНозЕхеслце, обеспечивающей чтение списка ста- 
тей, закомментирован оператор, вызывающий метод Се{МемМе\узГл1$6. Как 
уже говорилось, этот метод не срабатывает для многих серверов. Но если для 
того сервера, с которым вы работаете, этот метод разрешен, имеет смысл рас- 
комментировать этот оператор и закомментировать последующие операторы 
вплоть до оператора удаления объекта АМ$Р. Ну, а остальной код, вероятно, 
пояснений не требует. | 
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При работе в Интернете и локальных сетях возникают иногда чисто слу- 
жебные задачи, связанные с кодированием и декодированием файлов. Чаще 
всего это требуется при работе с почтовыми программами, которые будут под- 
робно рассмотрены в книге [5]. Но иногда кодирование применяется и при пе- 
ресылке файлов и сообщений в других программах. Задачи кодирования и де- 
кодирования файлов могут решаться в С++Ва4аег 6 компонентом ММООРго- 
сеззог со страницы ГаМе!. Компонент очень простой. Фактически, он имеет 
только одно задаваемое во время проектирования свойство — Ме Под, которое 
может принимать одно из двух значений: пиМ1те или пиСоде. Первое значе- 
ние соответствует кодированию и декодированию файлов методом МТМЕ/Вазе 
64, второе — методом ОЦЕпсо4тх /Оесо4 тя. Конечно, свойство Мепо4 мож- 
но задавать не только во время проектирования, но и программно. 

Исходный файл или иной объект, который кодируется или декодируется, 
связывается с входным потоком, задаваемым свойством только времени вы- 
полнения шри $ геат. Результирующий файл или объект, получающийся 
в результате кодирования или декодирования, связывается с выходным пото- 
ком, задаваемым свойством времени выполнения Обри Згеат. Кодирование 
осуществляется методом Епсо4е, декодирование — методом Оесоде. Перед на- 
чалом и в конце выполнения кодирования возникают соответственно события 
ОпВехштЕпсоде и ОпЕпдЕпсо4де. Перед началом и в конце декодирования воз- 
никают события ОпВергтОесо4де и ОпЕпдОесофде. 

Вот, собственно, все свойства, методы и события компонента ММОПОРго- 
сеззог. На рис. 10.11 показано тестовое приложение (проект Соае в каталоге 
Со4ае_Песоае для С++Ви!аег 6 на приложенном к книге диске), верхняя часть 
которого иллюстрирует применение этого компонента. На форме, кроме ком- 
понентов, видимых в верхней части рис. 10.11, размещены невизуальные ком- 
поненты ММО ОРгосе$5ог, ОрепП1а]10о5 и Зауе О 1а1о7. В ММО ОРгосез$5ог зада- 
но МеШо4 = ичаСоде, что согласуется с выделенной кнопкой в группе радио- 
кнопок Метод кодирования (ее имя в программе — ВаМеШо9д). Окна редактиро- 
вания, в которые заносятся имена файлов, имеют имена ЕЁ 1 и ЕЁЕ2 соответст- 
венно для исходного и результирующего файлов. Расположенные под этими 
окнами кнопки Найти имеют соответственно имена ВЕТ и ВЕ1. Обработчики 
щелчков на них имеют вид: 


Уу01А __ Еаз®са1]1 ТЕогим1: :ВЕ1С11сК (ТОБ]есе *5епаег) 


{ 
1Е (Орепр1а1о91->Ехесоиее ()) 
ЕЕ1->ТехЕ = Орепр1а1о0о31->Е11еМаще; 


880 Глава 10. Сетевые службы 


у01А _ Еаз®са11 ТГогм1::ВЕ2С11сКк(ТОБ]есЕ *5епаег) 


{ 

1Е (5бауер1а1оч1->Ехесиаке ()) 
ЕЕ2->Техе = бауер1а1091->Е11еМаме; 

} . 


Они вызывают соответствующие стандартные диалоги работы с файлами 
и заносят их результат в окна ЕЁ 1 и ЕЕ. 


Рис. 10.11 :: Кодирование / Декодирование а 
Тест кодирования / г Исходный файло Кодирование ^__^ т 


декодирования Пе г Метод кодирования` 


айлов и строк В 
ф р СС МЕ 
| ’ НИ : . 
Найти | |! © ЧУЕпсодто 


Файл результата оо НИИ 7 | 
Гезииие | 


Найти 


| 
| 
| 


а де 


гКодирование строк НТТР-——---—- се тт сеет теснее 


Исходная строка 


7 
| | | 
[ЕпойН (её и русский текст 
‚ Строка ЦВЕ | 

Епоз/ жен Е 9+ РОЖЕЗЖЕ1 ХЕ ЖЕАЖЕВЯЕ Э+АР2ЖЕВЖЕАА 


Обычная строка 


[ЕпойзН (ех{ м русский текст 


= що. <-> 


Файл Тез. иие кодиров 


| Обработчик щелчков на кнопках Кодировать и Декодировать (их имена 
ВСоде и В,Шесо4е) общий для обеих кнопок. Его код: 


У01А __Еаз®са11 ТГогм1: :ВСо4ес11ск (ТОр)]есе *5епаег) 
{ 


ТЕ ((ЕЕ1->ТехЕ == "") || (ЕЕ2->ТехЕ —— "")) 
{ 
ЗПомМез$заде ("Задайте имена файлов"); 
гебогп; | 


} 
ТЕ1]ебегеам *ТпбЕгеам = пем ТЕ11е5егеапм (ЕЁЕ1->Техе, ЕпОрепВеаа); 
ТЕ11ебегеам *ОцебЕгеаи = пем ТЕ11ебетгеам(ЕЁР2->Техе, ЕпСгеа®е); 


ММЧОРгосе$ $ог1->ТприЕ5Егеам = Тпбегеам; 
ММОЧРгосезог1->Оцсрие бе геам = Оче5Екеапм; 


1Е (ВКСМефевоа->ТЕепТпаех == 0) 
ММООРгосезог1->Меевноа = аоМ1пе; 
е]1зе ММООРгосеззох1->Меевоа = паСоае; 


1Е (бепаег == ВСоае) 
ММООРгосезог1->Епсоае (); 
е1зе ММООРгосеззог1->П)есоае (); 
Тобегеап->Етее (); 
ОцЕЕгеамт->Егее (); 
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В начале процедуры проверяется, не забыл ли пользователь задать файлы 
в окнах редактирования. Затем в локальных переменных ш$%%ёгеат и Ош З4ге- 
ат создается два файловых потока типа ТЕПезгеат, связанных соответст- 
венно со входным и выходным файлом. Входной открывается в режиме чте- 
ния, выходной создается заново. Созданные потоки заносятся в свойства т- 
ри З4теат и ОшршЗи`еат. В свойство Ме{о4 заносится то или иное значе- 
‚ ние в зависимости от того, какой метод выбрал пользователь в группе радио- 
кнопок ВС Мео4. Затем анализируется источник события Зеп4ег, чтобы вы- 
яснить, какая из кнопок нажата: ВСо4е или ВШесофе. В зависимости от этого 
вызывается метод Епсоде или О,есофе. В конце процедуры память освобожда- 
ется от созданных объектов файловых потоков. 

События ОпВегтЕпео4де, ОпЕп9 Епсо4де, ОпВезтОесо4де и ОпЕп@Оесо4е 
обрабатываются следующими функциями: 


у01А _ Еазеса11 ТЕГогм1 : : ММОЧРкосеззог1Вед1пресоае (ТОр)]есе *5епаег) 
{ . 


Зсаеи$Ваг1->51тр1еТехЕ ="Декодируется методом " + 
ВСМеевоа->Т$епз->$5ег1па$ [КСМеброа->ТеештТпаех] + 
" файл " + ЕЕ1->ТехЕ; 


у01а _ Еаз®са11 ТЕогт1: : ММИОРгосеззог1Вед1пЕпсоде (ТОБЗесе *5епдег) 
{ 


Ссаби$Вах1->51тр1еТехЕ ="Кодируется методом " + 
ВСМесроа->Т$емз->5%ег1паз [КСМеброа->Т+епТпаех] + 
" файл " + ЕЕ1->ТехЕ; 


У01А _ Еазеса11 ТГогм1 : : ММОЧРгосеззог1ЕпаБесо@е (ТОБ]ес® *5епаег) 


{ 

Зсасо$Ваг1->51тр1еТехе ="Файл " + ЕЕР2->Техе+ 
" декодирован методом " + 
ВСМеевоа->Т$епз->5&г1па$ [ВСМеброа->Т+ептТпаех]; 


Ууо1а _ Еазеса11 ТЕогш1 : : ММООРгосеззог1ЕпАЕпсоае (ТОБ)есе *5епаег) 


{ 

СсафазВаг1->5$1тр1еТехе ="файл " + ЕЕ2->Техе+ 
" кодирован методом " + 
ВСМеероа->Т6етз->5ег1па$ [ВСМеероа->ТеепТпаех]; 


} 


Эти функции просто отображают в полосе состояния ход кодирования или 
декодирования. . 

Создайте это простое приложение (или возьмите его с приложенного 
к книге диска) и запустите на выполнение. Задайте в качестве входного ка- 
кой-то файл, например, файл документа \У!ога. В`качестве выходного файла 
задайте имя какого-то несуществующего файла (иначе прежний файл с этим 
именем сотрется). Например, обычно для файлов, кодируемых методом 
ОО Елсоатя /Оесо 41175, задается расширение .иие. После щелчка на кнопке Ко- 
дировать создастся кодированный файл, соответствующий исходному входно- 
му файлу. Если исходный файл был документом Уога, то, попытавшись от- 
крыть выходной файл с помощью Уога, вы обнаружите, что в нем записана 
нечитаемая абракадабра. Но если вы теперь зададите в своем приложении 
в качестве исходного этот закодированный файл, то в качестве выходного по- 
лучите декодированный файл, ничем не отличающийся от того, с которым вы 
начали свои эксперименты. 
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Мы рассмотрели задачу кодирования и декодирования передаваемых по 
сети файлов. Теперь рассмотрим еще один компонент со страницы Газе! — 
ММОВГ. Он позволяет декодировать строки в формате ОВ в обычные сим- 
вольные строки и кодировать символьные строке в строки формата ОВГ, кото- 
рые можно использовать в запросах НТТР. 

Формат И ВГ сводится к следующему: 


м Любой не алфавитно-цифровой символ (в том числе символы кириллицы) 
преобразовывается в знак процента, за которым следует шестнадцатерич- 
ный код этого символа из таблицы АЗСП. 


и Пробелы заменяются на символами "+". 
и Все поля (переменные) отделяются знаками &. 
и Имена полей и данных разделяются символом "=". 


Компонент ММОВТ; имеет всего три специфических свойства. Одно из них — 
Шри гшо, доступное и во время проектирования, и во время выполнения. В это 
свойство помещается исходная строка, подлежащая кодированию или декодирова- 
нию. Это может быть обычная символьная строка или строка в формате ОВГ. Два 
другие свойства — Епсоде и О,есоде, доступные только во время выполнения. Ни- 
каких специфических методов в компоненте ММОВТ, нет. Для того чтобы преобра- 
зовать строку, ее достаточно поместить в. свойство при ЗИлп?. Тогда в свойстве 
Епсоде появится образ строки в формате ОНТ, а в свойстве Весо4е — в виде обыч- 
ной строки. Так что если осуществляется кодирование в формат ОВГ, надо брать 
результат из свойства Епеоде. А если в шри Или поместить строку в формате 
ОВГ, то результат — декодированную строку надо брать из свойства Оесоде. 

Компонент ММОВТ имеет всего одно событие — ОпЕггог. Заголовок его 
обработчика следующий: 


у01А __ Еаз®са11 ТКГогт1: : ММИВЬ1Еггог (ТОБ)есЕ *5епаег, 
Ап5$156г1па Орега®1оп, Апз15Ег1па ЕгуМ$9) 


Параметр ОрегаЙоп содержит описание операции, при которой произошла 
ошибка. Например: "Еггог Читие десо4е” — ошибка при декодировании. Па- 
раметр ЕггМ$= содержит сообщение генерируемого при этом исключения 
ЕСопуег& Еггог. 

В нижней части рассмотренного ранее тестового приложения (см. 
рис. 10.11) размещены элементы, тестирующие компонент ММОВКГ. Это три 
окна редактирования ЕЁ. В верхнее окно ЕЯ] заносится текст, помещаемый 
при щелчке на кнопке Пуск в свойство шри&З#`т?. В окна ЕЯ и ЕЗИЗ при 
щелчке на той же кнопке помещаются значения свойств Епсофде и Оесоде. Та- 
ким образом, обработчик щелчка этой кнопки имеет вид: 


у01А _ Газ®са11 ТРоги1: :Вие6оп2С11сК (ТОр)есе *бераег) 


{ 

ММОВГЬ1->Тприебег1па = Еа11->Техе; 
Еа1е2->Техе = ММОКВГ1->Епсоае; 
Еа1Е3->Техе ММОВЬ1->ресоае; 


} 


Обработчик события ОпЕггог компонента ММОВТ имеет вид: 


\01А _ Еаз®са11 ТГоги1 : : ММОВЬ1Етггог (ТОБ]есе *5епаег, 
Ап515Ег1па Орега®1оп, Ап$15Ег1па ЕггМ$9) 


{ 

1Е (Орега®1оп == "Еггог ачг1па аесоае") 

ЗПомМеззасе ("Ошибка декодирования: " + Ег!Мза); 
е1зе ЗПомМез$заче ("Ошибка кодирования: " + ЕгтхМ5а); 
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Запустите этот пример и проверьте его в работе. Если в окно Исходная стро- 
ка вы поместите обычный текст и щелкнете на кнопке Пуск, то увидите в окне 
Строка ЦК! (см. рис. 10.11), что английские символы в формате ОНТ, остаются 
неизменными, а символы русских букв кодируются. В окне Обычная строка бу- 
дет повторен текст исходной строки. Если вы теперь возьмете текст из окна 
Строка ЦЕ\, перенесете его в окно Исходная строка, сотрете текст в окне Обычная 
строка и щелкнете на кнопке Пуск, то увидите, что в окне Обычная строка поя- 
вится декодированный текст. Проверить событие ОпЕггог можно, например, 
введя в окно Исходная строка обычный текст и поместив в нем символ процента 
"%"; Этот символ наводит компонент на мысль, что исходная строка записана 
в формате ОВГ. А так как декодировать ее не получится, наступит событие 
ОпЕггог. 
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В ряде приложений возникают задачи обработки или формирования уни- 
версального идентификатора ресурса ОВ] (см. разд. 9.1.2), частным случаем 
которого является Ц ВГ.. К таким задачам относятся выделение отдельных эле- 
ментов ОВГ, формирование ОНТ, по заданному множеству элементов, преобра- 
зование не алфавитно-цифровых символов в формат, принятый в ОВГ. 

Все эти задачи удобно решать с помощью объекта класса ИАОВТ, доступ- 
ного и в С++Ви!аег 6, и в С++Ви!аег 2006. Этот объект не представлен в каче- 
стве компонента в палитре библиотеки. Для его использования надо подклю- 
чить к проекту заголовочный файл 140 Е.И рр. 

Ниже приведены основные свойства объекта и соответствующие им эле- 
менты ОВГ (см. разд. 9.1.2): 


ОИ ПООООои —_ ИЕ 
Свойство Описание — . 


'ВооктагК | Ссылка на фрагмент документа (элемент ОВТ БооКктагК). 


О ТЕ 


Поситеп{ Заключительный элемент пути к ресурсу — документ или программа. | 
ООО 


‚ Но$$ ‚Адрес сервера (хост) (элемент ОВ] Во5%. 


Рагатз ‚Передаваемый в ресурс параметр (элемент ОВ] зеагепра В). Только 
в С++ВиЦаег 2006. 


Пароль (элемент ОВ1 раз5\мог4). Только в С++Ви|аег 2006. 


Путь к ресурсу на сервере (элемент ОВТ иг]-ра{Ъ). 


Порт (элемент ОВ! рог®. | 
м И 
| 


ИИ 


Ргофосо! Схема ОНТ (Ир, Ир и т.п.). _ 


| ОВ Строка ОВ. 
поно ОИ И 
'Озегпаше | Пользователь (элемент ОВ изег). Только в С++ВиЦаег 2006. 


Объект класса Т1АОВТ создается конструктором, в который может переда- 
ваться строка ОВ. В этом случае все указанные выше свойства заполняются 
элементами, выделенными из этой строки. Таким образом, для того, чтобы вы- 
делить отдельные элементы ОВГ, достаточно создать экземпляр ТАОНТ. На- 
пример, следующий оператор создает объект и декодирует строку ОВТ, запи- 
санную в окне редактирования ЕОВТ: 
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ТТаовт *оВТ = пем ТТАОВвтТ (ЕОВТ->ТехЕе); 


Метод бе ЕРоПоВТ в С++Ви!аег 2006 производит обратное преобразова- 
ние — формирует ОВ] на основе параметров объекта ТЛАОВТ: 
Апз156г1па __Еаз6са11 СбефЕа11ОВТ ( 
сопзЕ ТТАаовтор&1о0опа1Е1е1А$5еф АОре1опа1Е1]1еаз)); 


Параметр АОрйопа!Ре4$ является множеством, которое может содер- 
жать опцию оЁАи Шо — включение в ОВ]! информации об авторе (имя и па- 
роль) и опцию оЁйВооктагК — включение в ОВ ссылки на фрагмент: 

суреаеЕ Зее<ТтТапвторЕ1опа1Е1е1аз$, оЕАаЕПТпЕо, оЕВоокмагкК> 

ТТадвторЕ10па1Е1е1а$5еф; 

По умолчанию обе опции включены в АОрНопа!ЕШеб$. Так что оператор: 

ЕОВТ->ТехЕ = ОВГ->бееРо1108ВТ(); 


занесет в окно редактирования ЕОВ1 строку ОВТ, сформированную из всех 
свойств объекта ОВТ. А следующий оператор создаст строку ОЕ, но не вклю- 
чит в нее информацию о пользователе: 


ЕОВТ->Техе = ОВГ->СееРо110ВТ ( 
ТТАаовТОр®&1опа1Е1е1Ааз5ее () > оЕАаЕРТпЕо); 

Номер порта включается в методом Се Ки ОВТ в ОВГ только в том случае, 
если он отличен от значения 80, принятого по умолчанию. 

Применение описанных свойств и методов иллюстрирует пример, окно ко- 
торого показано на рис. 10.12. Это проект (АГ, который вы найдете в каталоге 
СЕТ для С++ВиИаег 2006 на диске, приложенном к книге (для С++ВиПаег 6 
этот пример не приводится, так как большинство использованных в нем мето- 


2 Операции с ИВ 


ЦВ МЕ р:/ ;атБап:123@®ппусогтриЕег:800/с9:-Ып/Му.ехе/соипЕ? 1 


Декомпозиция ИВТ 
Протокол _ МЫр 


х 
ост [пусотрикег 


Формирование ИВТ | 
Порт 800 


Путь | с9'-Ып/Му.ехе/ 
Документ [соипе | 


Параметр [1 | 
Пользователь [вап | | 


„мольдинщьльвьь-араьь 


Пароль 123 


| г Преобразование строки 


4 Инодная. [Епой$В ЕехЕи русский текст 
Кодирование [Еп9й$Н%20.е%20%Е8%20%70%Е3%Е 1%71%ЕА%Е8%Е9 | 
Декодирование [ЕпойзВ ЕехЁ и русский текст 


Рис. 10.12. Приложение, обрабатывающее ЦК! 
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дов и свойств недоступны). Основную часть формы занимают окна редактиро- 
вания. Верхнее окно ОНТ (его имя в приведенном далее коде ЕОВТ) содержит 
строку ОВТ. Ниже расположен ряд окон (ЕРгофосо|, ЕНо$&, ЕРогё, ЕРай В, 
Е Боситеп, ЕРагат, ЕО5ег, ЕРа$$\ог@9), содержащих отдельные элементы 
ОВТ. Пользователь может занести ОВ] в верхнее окно, щелкнуть на кнопке Де- 
композиция ЦК! (ВиЙопТ), и в нижних окнах появятся результаты декодирова- 
ния — элементы ОНТ. На рис. 10.12 вы можете видеть, как выглядит каждый 
из них. Пользователь может поступить иначе: заполнить нижние окна и щелк- 
нуть на кнопке Формирование ЦК (ВиЙоп2). Тогда в верхнем окне появится 
сформированная строка ОЁЕЦТ. В этом режиме можно заполнять не все окна, но 
протокол (схему ОВ] и хост надо указать обязательно. 
Ниже приведены обработчики щелчков на описанных кнопках. 


#1пс10ае <Таовт.Врр> 


У014 _ ЕГазеса11 ТЕГоги3: : Ви оп1С11сК (ТОБ)]есе *5епаег) 
{ 
ТТаовт *ОВТ = пем ТТАаовт (ЕОВТ->ТехЕ); 
сху 
{ 
ЕРго®осо1->Техе = ОВТ->Рго®осо1; 


ЕНоз®->Техе = ОВТ->Ноз$е; 
ЕРоге->ТехЁЕ = ОВТ->Рокс; 
ЕРаеИ->Тех+ = ОВТ->РаёВ; 


ЕБосипеп® ->ТехЕе 
ЕРагап->ТехЕ 
ЕОзег->Техё ОВТ->05егпаме; 
ЕРаззмога->Техе ОВБКТ->Раззмога; 
ЕРагап->Техе = ОВТ->Рагамз; 


} 


ОВТ->росипепЕ; 
ОВ1->Рагамз; 


__Е1па11у 
{ 
Че1ефе ОБТ; 
} 
} 
км 
у01А __Еаз®са11 ТРГогм3: : Ви оп2С11сК (ТОр)]ес& *5епаек) 
{ 
ЗЕглпа 9; 
1Е(ЕРгофосо1->ТехЕе == "") 
$ += "Не указан протокол.\п"; 
1Е(ЕНозе->Техе == "") 
5 += "Не указан хост.!"; 
1Е(5 1="") 
{ 
ЗРомМеззасве ("Ошибочные данные.\п" + 5); 
гебагп; 
} 
ТТачвт *оВТ = пем ТТАаОдвт(""); 
Егу 
{ 
ОВТ->Ргобосо]1 = ЕРгобосо1->Техе; 


ОБКТ->НозЕ = ЕНозе->Техе; 
ОВТ->РогЕ = ЕРОог®->ТехЕ; 
ОВТ->РафН = ЕРа*В->Техк; 


0ВТ->Босомепе = ЕБосищепе->ТехЕ; 
ОВТ->Рагамз ЕРагап->ТехЕ; 
ОКТ->0зегпапе ЕОзег->ТехЕ; 
ОВТ->Раззмога ЕРаззмога->ТехЕ; 


ЕОВТ->Техе = ОВТ->бееЕи110ВТ(); 
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} 
__Е1па11у 
{ 
ае1еке ОКВГ; . 


} 


} 


Приведенный код достаточно очевиден. При щелчке на ВиЙоп1 создается 
объект ОВ класса ТЛАОВТ, причем в конструктор передается строка ОНТ. 
В этот момент заполняются все свойства объекта, так что остается только пере- 
нести их значения в соответствующие окна редактирования. При щелчке 
на ВиН_оп2 объект (ВП создается на основе пустой строки. Затем заполняются 
значения его свойств, и вызывается метод Се Ро ПОВТ. 

Нижняя часть приложения, показанного на рис. 10.12, связана с кодиро- 
ванием символьных строк в формат ОВГЬ и с обратным декодированием. 
В разд. 9.1.2 и 10.6 уже говорилось о форматах отображения в ОВГ не алфа- 
витно-цифровых символов (в том числе символов кириллицы). Аналогичные 
форматы используются и в запросах НТТР. 

В классе ТАОВТ объявлен ряд методов класса, обеспечивающих взаимное 
преобразование форматов: 

зсаЕ1с Апз156г1п9 _ Еазеса11 ОВШЕпсоае (ТМефаС1аз3* уме, 

сопзЕ Ап$15Ег1па Абгс); 
зсаЕ1с Ап5156г1п3 _ Еазеса11 РагамзЕпсоае (ТМебаС1аз5* уме, 
сопзЕ Ап515Ег1па Абгс); 
зсае1с Ап5156г1лпа __Еазеса11 РаепЕпсоае (ТМефаС1аз$* уме, 
соп5Е Ап515ег1па Абгс); 


зсае1с Апз15Ег1пд _ Еазкса11 ОВГОесоае (ТМефаС1аз$* уме, 
Ап$156г1па Абгс); 


Методы ОВТ.Епсоде, Рагат$Епсоде, Ра Епсо4е преобразуют строку А%$гс, 
записанную обычными симолами символов (ОБ-АЗСП, в строку кодировки 
ОВТ-Епсодед, и возвращают преобразованную строку. Метод ОВТ.Оесоде осу- 
ществляет обратное преобразование: переводит строку АЗге в кодировке 
ОВГ-Епсо4е4 в строку обячных символов 0Б-АЗСИ. 

Метод ОВГЕпеофде требует, чтобы исходная строка АЗге соответствовала 
формату ОВТ. Например, она обязательно должна содержать элементы, опре- 
деляющие протокол и хост. Методы Рагат$Епсоде и Ра ВЕпсоде могут осуще- 
ствлять перекодировку любой строки. 

Во все методы передается параметр ушё — метакласс, осуществляющий 
преобразование. Обычно этот параметр можно задавать равным МОГ. 

Нижняя панель приложения, показанного на рис. 10. 12, демонстрирует 
рассмотренные методы. Если в окно Исходная вы поместите обычный текст и 
щелкнете на кнопке Преобразование, то увидите в окне Кодирование, что анг- 
лийские символы в формате ЦК остаются неизменными, а символы русских 
букв кодируются. В окно Декодирование заносится результат декодирования 
строки окна Кодирование. Она, естественно, повторяет исходную строку. Обра- 
ботчик щелчка на кнопке Преобразование имеет вид: 


Еа12->Техе ТТаовт: :РагамзЕпсоае (МОТ, Еа11->Тех®); 
Еа1 Е 3->ТехЕе ТТаовт: : ОКГОесоае (МОТТ,, Еа1Е2->Техе); 


В этих операторах методы вызываются через ссылку на класс, так что объ- 
ект класса ИАОВТ создавать не требуется. 


Работа с удаленными 
модулями данных 


11.1 Построение серверов с удаленными 
модулями данных 


Современные приложения очень часто работают с удаленными базами дан- 
ных: база данных расположена где-то на сервере, и с ней должно работать мно- 
жество клиентских приложений. 

Работа с удаленными данными в С++ВиПаег может быть организована 
различными способами. Можно использовать для этих целей сервер транзак- 
ций МТ$, можно ориентироваться на технологии СОВВА или ОГЕегритзе. 
Однако эти варианты требуют развертывания дополнительного программного 
обеспечения. Пожалуй, наиболее универсальный вариант — технология 
ОСОМ, встроенная в \У1т4о\з. 

Рассмотрим основные составляющие механизма построения многоуровне- 
вых приложений, работающих с данными. Приложение в общем случае состо- 
ит из следующих элементов: 


Удаленные моду- |Серверы СОМ, ОСОМ или СОВВА, связанные с удаленны- 
‚ли данных ми базами данных и обеспечивающие доступ клиентов 
к специальным компонентам — поставщикам информации. | 


| 1 
| Поставщики Объекты, размещенные на удаленных модулях данных | 
‚информации и возвращающие клиенту нужную информацию — резуль- 
| 
| 


| таты вычислений или наборы данных. Выполняют функ- 


ции сервера приложений. 


‘Компоненты связи | Обеспечивают связь между отдельными составляющими | 


системы. | 


ЕН ИНОЕ 
Клиентские Приложения, обрабатывающие получаемые наборы данных 
' приложения и посылающие запросы на удаленные модули данных. 
НИ НВ 


Работа всех этих элементов организуется следующим образом. Клиентское 
приложение соединяется с сервером, содержащим удаленный модуль данных 
и расположенным на серверном компьютере. Если сервер не был запущен, то. 
клиентское приложение автоматически запускает его на выполнение. После 
этого сервер будет постоянно располагаться в памяти, обслуживая клиентов. 

Далее в процессе работы клиентское приложение запрашивает у сервера при- 
ложений (поставщика информации) какой-то набор данных. Сервер приложений 
обращается к соответствующей базе данных, получает требуемый набор, упако- 
вывает его и посылает клиентской программе. Клиентская программа распако- 
вывает набор, создает его локальную копию и с помощью обычных компонентов 
отображения и редактирования данных предоставляет его пользователю. 

Если пользователь вносит в данные (локальную копию) какие-то изменения, 
клиентская программа посылает пакет сделанных изменений серверному прило- 
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жению. Сервер приложений распаковывает его и формирует транзакцию для сер- 

‚вера данных. Если никаких проблем не возникает, то клиентской программе воз- 
вращается измененный набор данных. Если же при изменении данных возникли 
какие-то недоразумения, то сервер приложений формирует набор ошибочных 
данных и возвращает его клиенту. Пользователь, работающий с клиентской про- 
граммой, должен определить, как разрешить возникшие проблемы. 

Начнем создание такого многоуровневого приложения с построения серве- 
ра, содержащего удаленный модуль данных. На диске, приложенном к книге, 
в каталогах ДазаМодашез эти проекты имеют имена туМД и шуйМ02006 
в зависимости от версии С++Во!аег. Правда, там они несколько более слож- 
ные, чем описано в данном разделе, поскольку в них учтены добавления, рас- 
смотренные в последующих разделах. 

Начните новое приложение. Создавшаяся форма будет представлять собой 
окно сервера. Никаких особых операций с сервером выполняться не будет. Так 
что можете ограничиться заданием какого-то заголовка окна и, если хотите, 
добавить на форму кнопку Закрыть и написать в обработчике щелчка на ней 
оператор С]озе (рис. 11.1). Свойство формы Вог4ег5{Яе целесообразно задать 
равным 65511 ]е, поскольку изменять размер окна пользователю не имеет 
смысла, а свойство \Ущт4ом 54 аже целесообразно задать равным \$5Мпипи2ед, 
так как с окном сервера пользователю работать не придется и удобнее, если 
сервер будет выполняться в свернутом виде. Сохраните проект под именем 
ту МО или тукМО2006. 

Конечно, отображение сервера в полосе задач в свернутом виде с помощью 
свойства У\У\шдомфафе — это не лучшее решение. Разумнее отображать сервер 
в виде пиктограммы в области Зуз4ет Тгау. Это можно сделать с помощью ме- 
тодов, рассмотренных в разд. 1.10. Но не будем излишне усложнять наш сер- 
вер, чтобы не отвлекаться от решения основных задач. 


Рис. 11.1 | ": Удаленный модуль дан 
Окно сервера данных | 


Теперь надо добавить в сервер удаленный модуль данных. Выполните ко- 
манду Не | Мем | О!ег и выберите пиктограмму Кетое Ба Модие (удаленный 
модуль данных). В версиях, предшествующих С++ВиПаег 2006, она находится 
на странице Ми! 1ег. В С++Ви!Иаег 2006 она находится на странице С++Вийаег 
Ргоесв | МиН\ег. При выборе этой пиктограммы появится диалоговое окно, пока- 
занное на рис. 11.2. В окошко СоСаз$ Мате надо занести имя интерфейса созда- 
ваемого модуля данных — на рис. 11.2 "с МуВМО”". Для С++Ви|аег 2006, что- 
бы далее не путаться в зарегистрированных в системе серверах, можете ввести 
имя "< МуКМр2006”. Имя класса вашего удаленного модуля данных (наслед- 
ника класса ТКкетофеОа{аМо4е) будет равно этому имени с добавленным в на- 
чале символом “Т" — ТеМуВМО. Этот класс будет экспонировать интерфейс. 
с тем же именем, но с добавленным в начале символом "Г’ — Та МуВМО. 
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Рис. 11.2 Меч Вепоке Вага Модше Обе 
Окно задания свойств | ани 


удаленного модуля данных | соаз Мате: [Вмувмо 


| | ‚ Теафоо Моде: [драгтеге "| 
Безсирйол: [Вмо Рег$ Бер 


ее а чата льнееы дана - 


| 
| ' Г сепегаке ЕмегЕ зиррой соде 


Сапсе| | Нер | 


Выпадающий список ТРгеа4та Моде! определяет модель потоков — способ 
обращения клиента к интерфейсу ОСОМ: 


Ушёе Запросы клиентов обрабатываются поочередно, так что оче- | 
(единственный) редной запрос ждет, пока сервер освободится. В этом вари- 
анте размышлять об организации потоков не приходится. | 


Арагетепф Каждый экземпляр модуля данных обслуживает одновре- | 
(индивидуальный) | менно только один запрос. Но для многоуровневых объек- | 
тов ОШ, может обрабатывать множество запросов в отдель- \ 
ных потоках. Данные сохраняются в отдельных потоках, 
но вы должны обеспечить отсутствие конфликтов между 
потоками. Эта модель рекомендуется при использовании 
наборов данных ВПЕ. При этом вы должны добавить в мо- | 
дуль компонент 5е5$10п со свойством АщвоЗе5з10оп Мате, 
установленным в фгие. 


| 
Егее Экземпляры модуля данных обслуживают одновременно не- 
(свободный) сколько потоков. Надо позаботиться о защите данных от | 
| 
| 
| 
| 
| 


конфликтов. Этот режим рекомендуется для наборов дан- 


| 
__ _—__- ——_ и 


ных АРО . 


ВоВ То же самое, что Егее, но передача данных клиентам про- 
(двойной) изводится последовательно. 


| 


М№ешёга1] Эта модель предусмотрена, начиная с С++ВиПаег 6. Множе- 
ство клиентов могут одновременно вызывать модуль в раз- 
ных потоках, но между ними не должно возникать конф- 
ликтов. Эта модель — единственная при работе с СОМ+. 


Окно ОШезсирНоп позволяет ввести произвольное текстовое описание модуля. 

Заполнив данные окна рис. 11.2, щелкните на ОК. В вашем приложении 
появится модуль данных, который внешне не отличается от обычных (не уда- 
ленных) модулей данных. Вы можете разместить на нем любой компонент набо- 
ра данных и связать его с любой имеющейся у вас базой данных и с любой таб- 
лицей в ней. В дальнейших примерах использована база данных, содержащаяся 
на приложенном к книге диске. Ее псевдоним в дальнейших примерах — ЧЪР. 
Она содержит две таблицы Рага4ох — таблицу Рег$, представляющую собой таб- 
лицу сотрудников некоторого учреждения, и таблицу Оер, содержащую список 
отделов учреждения. Таблица Рег5 содержит следующие поля: 
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и 
Пояснение 


| Имя Тип 
‚ Ащошсгетет (автомати- | Номер записи (ключевое поле) 
` чески нарастающий). | 


| ‚ А]рва (строка текста) Отдел, в котором работает сотрудник 


‚ А1рВа (строка текста) | Фамилия 


—— 


| Имя 


_ Характеристика 


Рвою — бгарые (графический) _ __ | Фотография —__ 


| Тип ‚ Пояснение 
ИЕ | А]рва (строка текста) _ Наименование ие отдела _ 
Рго!зу |ТОСТСАГ, (логический) | 4гае — производство, #а]5е — управление 


В качестве компонента набора данных будем использовать простейший — 
компонент Та Ше, хотя это, конечно, не лучший вариант. Перенесите этот ком- 
понент в модуль данных и соедините его обычным образом с таблицей Регз 
базы ЧБР. Можно установить в фгие свойство Аейуе, чтобы сервер при его за- 
пуске сразу соединялся с таблицей данных. Такую связь можно установить за- 
ранее, так как сервер будет постоянно находиться в памяти, обслуживая за- 
просы клиентов. Но можно Асйуе в фгие и не переводить, так как набор дан- 
ных автоматически откроется при поступлении запроса. В свойстве ш4ехМа- 
ше набора данных задайте дерйо — индекс, упорядочивающий данные по от- 
делам, а внутри каждого отдела по алфавиту. С помощью Редактора Полей 
введите в набор данных объекты всех полей и задайте русские значения их 
свойств О15рауГаБе|. В базе данных, содержащейся на приложенном к книге 
диске, имеется таблица Пкаб.ОВ, содержащая словарь полей. Если вы акти- 
визируете этот словарь в С++Ви!аег 6 или в более ранних версиях с помощью 
ЗОТ, Ехр]огег ( команда Ос!аБазе | Ехроге, страница О/сНопагу — см. подробнее 
в [1] и [5]), то русификация всех полей таблицы выполнится автоматически. 
К сожалению, в С++ВиПаег 2006 такой возможности нет. 

Если в окне рис. 11.2 вы выбрали рекомендуемый для компонентов ВШОЕ 
режим Арагётеп, то в соответствии с данной ранее рекомендацией имеет 
смысл добавить в модуль компонент $е$$1оп и установить в фгоие его свойство 
АщоЗе5510оп Мате. 

Теперь надо перенести в модуль компонент-провайдер, который будет иг- 
рать роль серверного приложения, описанного выше. Это компонент Вафа е{- 
Рго\м14ег со страницы Оаа Ассез$ (в С++Ви!аег 5 он расположен на странице 
Мю9о5). 

Основное свойство компонента — Вафа еф. Оно определяет набор данных, 
с которым связан поставщик данных. В нашем примере в этом свойстве надо 
указать набор данных Та ]е1. Булево свойство Соп$фгаи $ определяет, будут 
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ли передаваться клиенту ограничения, заложенные в таблицу данных. Если 
Сопз{гаш$ = (гие, то эти ограничения передаются, и клиентское приложение 
может локально проверять, удовлетворяют ли им новые или редактируемые 
данные. Это понизит возможность ошибок при обратной пересылке данных на 
сервер и фиксации их в базе данных. 

Свойство ОрдаёеМоде определяет, по каким полям провайдер идентифи- 
цирует запись при ее фиксации в наборе данных после редактирования. Воз- 
можные значения Орде Моде: 


идентификация по начальным значениям всех полей 


идентификация по ключевым полям и по начальным зна- 
чениям измененных полей 


идентификация только по ключевым полям 


В нашем примере, очевидно, надо выбрать вариант ир\ВегеКеуОцу, по- 
скольку идентификация, например, по полям типа Мето и СгарЫе в принци- 
пе невозможна. 

Из множества событий, свойственных компоненту ЭаёаЗе Рго\м14ег, отме- 
тим, прежде всего, событие ОпСе Рафа, наступающее, когда данные уже под- 
готовлены, но еще не переданы клиенту. Обработчик этого события можно ис- 
пользовать, например, для шифровки каких-то данных. В дальнейшем кли- 
ентское приложение может расшифровать их. 

Событие ОпОрдафеафа наступает, когда РабаЗе{Ргох!4ег принял дан- 
ные от клиента и собирается занести их в базу данных. В обработчике этого 
события можно предусмотреть какую-то предварительную проверку и кор- 
ректировку данных, чтобы не допускать ошибок при обновлении набора 
данных, расшифровку переданных клиентом зашифрованных данных, со- 
хранение в каком-то вспомогательном наборе изменяемых или удаляемых 
записей и т.п. 

В обработчики обоих событий ОпбеОжа и ОпОрдайерайёа передается па- 
раметр Рафа её типа ТСПеп{Оаёа5е{. Это набор данных, через который можно 
получить доступ ко всем полям и записям. 

Событие ОпОрдаеЕггог наступает, если во время фиксации данных нару- 
шаются какие-то условия и обновление данных невозможно. Заголовок обра- 
ботчика события ОпОрда&еЕггог имеет вид: 

\01А _ Еа5®са11 Тс1ВМО: :Рабаб5е Ргоу1Аег1ОрдакеЕггохг ( 

ТОБ]есеЕ *5епаег, 
ТСизсомС11епЕРафкабее *РафабЗеф, 
ЕОраафеЕггог *Е, 


ТОрааееК1па ИрдафеК1па, 
ТВезо1уегКезропзе &Везропзе) 


Параметр Вафа$ ей соответствует переданному клиентом временному набо- 
ру данных. Свойства ОЧУаше, МемУаШе и СигУаШе этого набора позволяют 
увидеть, какие поля изменялись, и понять, что именно вызвало ошибку. Пара- 
метр Е представляет собой объект исключения класса ЕОрдаеЕггог, позво- 
ляющий определить характер ошибки. Свойства ЕггогСо4е и Меззайе этого 
объекта позволяют определить характер ошибки. Значение параметра Ордафе- 
Ка указывает, случилась ли ошибка во время вставки (значение иК ег), 
удаления (значение иКОеее) или модификации (значение иКМо@ Му) записи. 
Параметр Везропзе определяет действия, которые должны совершаться после 
выхода из обработчика события ОпОр4да{еЕггог: 


892 Глава 11. Работа с удаленными модулями данных 


= =——- = —==-==- = —=— = —_—_о— [- === рр 


тр прервать обновление записи, которая вызвала ошибку, и оставить ее ' 


| 


в кэше - | 


и - А 
| 
'ггАБог полностью прервать операцию обновления данных, не отображая 


никакого сообщения об ошибке | 


ии О }3б_——_р 
ггМегое |объединить изменения в новый пакет данных вместе с новыми зна- „ 
| чениями из базы данных 


‘тгАрру принять текущие значения полей записи вместо тех, которые перво- 
начально должны были быть записаны в базу данных 


———— о —————_о_и—оыиоио 


гг[опоге |игнорировать ошибку и не возвращать ошибочную запись клиенту 
для решения вопроса, что с ней делать 


—==——, 


Клиент может послать серверу произвольный запрос и получить на него 
столь же произвольный ответ. В качестве ответа могут быть посланы не только 
данные из таблицы данных, но и любое другое значение - строка, число и т.п. 
Для посылки запроса, как мы увидим позднее, клиент вызывает метода 
РаёаКецие${. В качестве аргумента в этот метод может передаваться строка 
запроса. Вызов метода дааВецие${ клиентского набора автоматически приво- 
дит в конечном итоге к генерации события ОпОаёаВецие${ провайдера в уда- 
ленном модуле данных. В обработчик этого события передается Зеп4ег — ука- 
затель на объект провайдера, и три '— значение, переданное в первичном вы- 
зове метода ЭаёаВецие$+. По умолчанию событие ОпОжаКедие$$ не имеет об- 
работчика. Но, написав этот обработчик, вы можете вернуть в нем любые за- 
требованные данные. 

Вернемся к нашему примеру. Вам надо связать свойством Оафа5е компо- 
нент ВафаЗе Ргоу14ег с ТаМе1 и задать свойство ОрдаеМо4е равным ар- 
‚ \УВегеКеуОщу. Самому компоненту ОаёфаЗе Ргоу14ег дайте имя (свойство 
Маше) ОЭРРег$, указывающее на то, что он подключен к таблице Регз. 

Перенесите на форму еще один компонент Та Ше и свяжите его с таблицей 
Оер, установите в фгие свойство Аесйуе. Перенесите на форму еще один компо- 
нент Рржфа5е Ргоу!4ег, задайте ему имя ОЗРЮер и свяжите его со вторым ком- 
понентом Тае2. Сохраните модуль, например, под именем с(туВМОГтрЕ. 

Модуль должен создаваться только тогда, когда клиент пришлет какой-то 
запрос. Поэтому следует выполнить команду Рго}ес* | Ор#10п$ и на странице 
Гогтз перенести форму модуля с панели автоматически создаваемых форм 
(Ашо-сгеое Югтз) в панель доступных форм (АусаНаЫе Ююгт5). 

Если вы работаете с С+-+Во!Паег 2006, то надо осуществить еще одну опера- 
цию. Выполните команду Рго]ес% | Ор опз и на странице АТГ, включите опцию 
МиНре Цзе. Она означает, что все клиенты будут работать с одним экземпля- 
ром сервера. 

Мы создали простейший север базы данных, не выполняющий никаких 
операций, кроме связи с указанной таблицей указанной базы данных. 

Позднее мы усовершенствуем его, но пока проектирование сервера базы 
данных закончено. Теперь надо зарегистрировать его в системе как сервер дан- 
ных. Для этого надо выполнить приложение сервера с параметром командной 
строки "/гейзегуег". , | 

Если вы разрабатываете сервер на том самом компьютере, на котором он 
в дальнейшем будет работать, то вам надо выполнить команду Вип | Рагатеег® 
и в отрывшемся окне на странице [оса в С++Ви!аег 6 или более ранних версиях 
(рис. 11.3 а) или в вершине ПОебоддег в С++ВиИаег 2006 (рис. 11.3 в) занести 
в окошко Рагатеег$ значение " /геззегуег". После этого надо закрыть данное диа- 


11.1 Построение серверов с удаленными модулями дачных 893 


логовое окно и запустить серверное приложение на выполнение. При этом ника- 
кой реакции вы не увидите, никаких окон на экране не появится, но У/т9о\$ за- 
регистрирует ваш сервер, внеся в свой реестр соответствующие записи. 
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Для того чтобы зарегистрировать сервер на удаленном компьютере, на ко- 
торый вы в дальнейшем перенесете его выполняемый модуль, в С++ВиПаег 6 
и более ранних версиях вам надо выполнить ту же команду Кип | Рагате!егз, но 
в отрывшемся окне перейти на страницу Кето!е (рис. 11.3 6) — удаленный сер- 
вер. В окошко Кетое Поз вы должны занести ОВТ, или [Р-адрес удаленного 
сервера, а в окошко Кетое рай — путь к файлу вашего сервера данных в таком 
виде, в котором он виден на серверном компьютере. В окошко Рагате!ег$ надо 
занести значение " /геззегуег", закрыть диалоговое окно и запустить серверное 
приложение на выполнение. | 

При последующих выполнениях сервера надо удалить из командной стро- 
ки параметр "/гебзегуег ". А если вы в дальнейшем захотите удалить инфор- 
мацию о регистрации вашего сервера из системы, вам надо будет выполнить 
ваше серверное приложение с параметром командной строки "/ипгеззегуег”. 

Мы построили простой удаленный сервер данных. Но его можно было бы 
и усложнить. Посмотрите, какие модули включены в ваш проект. Помимо тех 
модулей, которые вы сами составляли, вы увидите модуль МО ТЕВ — модуль 
библиотеки типов. Вы можете выполнить команду Ме\ | Туре Ибгагу и в открыв- 
шемся окне редактора библиотеки типов ввести в интерфейс класса методы 
и свойства, обогащающие возможности сервера. О работе с библиотеками типов 
рассказано в книгах [1] и [5]. Так что здесь на этом мы не будем останавливать- 
ся. Но позднее в разд. 11.4 мы усовершенствуем созданный нами сервер. 

Модуль, построенный выше, использовал в качестве набора данных ком- 
поненты ТаШе. Вместо них можно было бы использовать другие наборы дан- 
ных. Например, вы можете построить аналогичное серверное приложение, 
включив в модуль данных (назовите его класс «ВМОЗОГ,) вместо ТаШе ком- 
понент Фиегу. В этом случае в свойство БОГ этого компонента надо занести 
текст "беес$ * #гош Регз". Полезно также включить в свойстве ОрНоп$ про- 
вайдера РабаЗе Ргоч!14ег1 опцию роАПомСоттапаТехё. Это разрешит клиен- 
там изменять тексты запросов и управлять таким образом получаемой от сер- 
вера информацией. В этом существенное преимущество компонента Ф@иегу пе- 
ред ТаЁШе. Причем для связи с любой из таблиц базы данных достаточно одно- 
го компонента @чиегу. Текст, сформированный в его свойстве З@Г, не сущест- 
венен. Вы сможете впоследствии из клиентского приложения (см. разд. 11.9) 
изменять этот текст. Сохраните ваш новый сервер, например, под именем 
туз Г или туб@Г.2006 и зарегистрируйте его. 

Вроде бы все просто. И если вы будете тестировать клиентские приложе- 
ния, которые обсуждаются в данной главе, на том же компьютере, на котором 
расположен сервер, то все будет нормально работать. Но если сервер располо- 
жен на одном компьютере в сети, а клиент — на другом, то необходимо, во пер- 
вых, зарегистрировать сервер на обоих компьютерах (на клиентском после реги- 
страции его можно удалить). А главное, надо обратить внимание на настройки 
безопасности ОСОМ. Вопрос достаточно тонкий, зависит от версии операцион- 
ной системы, от принятой в сети политики безопасности, так что по деталям 
лучше посоветоваться с системным администратором сети. А в целом настройка 
выглядит так. Начиная с \ш4о\з 2000 и ХР, в состав операционной системы 
входит программа Осотсп{[.ехе. В предшествующих версиях \У!шо\з ее 
по умолчанию нет, но ее нетрудно скачать в Интернете. Запустить программу на 
выполнение можно в любой версии У/т4омз командой Пуск | Выполнить | 
Осотсп®Ю.ехе. Но проще вызвать ее из окна Панели управления апплетом Адми- 
нистрирование | Службы компонентов. Окно программы для У 1пдомз ХР по- 
казано на рис. 11.4 а. Для других версий У/1т4о\з оно несколько иное. 
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Рис. 11.4 
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Рис. 11.4 д) | 
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Политика безопасности ОСОМ может устанавливаться на двух уровнях: 
на уровне компьютера, и на уровне серверного приложения. Свойства настрой- 
ки, заданные на уровне компьютера, используются по умолчанию для всех 
приложений данного компьютера. Но для отдельного приложения эти на- 
стройки по умолчанию можно изменить. 

Настройка на уровне компьютера определяется  диалоговым окном, кото- 
рое вызывается щелчком в левой панели главного окна (рис 11.4 а) на вершине 
Мой компьютер и выбором раздела Свойства всплывающего меню. На странице 
Свойства по умолчанию надо включить индикатор Разрешить использование 
ОСОМ на этом компьютере и индикатор Включить на компьютере Интернет-службы 
СОМ (если требуется). Далее можно установить желательные уровни проверки 
подлинности и олицетворения. На странице Безопасность СОМ по умолчанию 
(рис. 11.4 6) следует настроить разрешения на доступ и на запуск приложений. 
Для этого надо щелкнуть на кнопке Изменить умолчания. Откроется окно, при- 
мер которого показан на рис. 11.4 в. В его верхней панели перечислены груп- 
пы пользователей и отдельные пользователи, имеющие по умолчанию доступ 
к любым объектам СОМ. Все представители этих групп будут иметь по умолча- 
нию доступ и к вашим серверам данных. Так что при желании можете вклю- 
чить в число привилегированных групп требуемую группу пользователей. 
Если вам нужно создать новую группу пользователей, то это делается из окна 
Панели управления вызовом апплета Администрирование | Управление компь- 
ютером. На этом процессе мы останавливаться не будем. 
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Впрочем, обычно задача ставится иначе: надо создать группу пользовате- 
лей, которая имеет доступ не ко всем объектам, а именно к вашему серверу 
данных. Тогда после ее создания ей надо дать права доступа к серверу. Для 
этого надо в левой панели главного окна (рис. 11.4 а) выделить вершину Но- 
стройка СОМ, щелкнуть в правой панели правой кнопкой мыши на элементе 
вашего сервера и выбрать раздел Свойства всплывающего меню. Откроется 
окно, в котором сейчас нас будет интересовать в первую очередь страница Безо- 
пасность (рис. 11.4 г). На этой странице вы можете кнопками Изменить настро- 
ить доступ к серверу. Щелчок на любой из этих кнопок открывает окно, пока- 
занное на рис. 11.4 в, относящееся к вашему серверу. 

В этом окне вы можете добавить новых пользователей сервера. Щелкните 
на кнопке Добавить, а в открывшемся после этого окне щелкните Дополнитель- 
но. Окно приобретет вид, показанный на рис. 11.4 д. Если щелкнуть в нем 
на кнопке Поиск, то в нижнюю панель загрузится список возможных пользова- 
телей и их групп, из которых можно выбрать тех, кого вы хотите допустить 
к вашему серверу. 

На этом я закончу обсуждение настройки доступа к объектам ОСОМ. Ко- 
нечно, это обсуждение было достаточно поверхностным, но детальное рассмот- 
рение политики безопасности в сети выходит за рамки данной книги. Осталь- 
ные тонкости настройки имеет смысл обсудить с администратором сети. 


11.2 Немного о ВОЕ 


В предыдущем разделе серверы созданы на основе компонентов Та е 
и Очегу, предусматривающих наличие на компьютере ВОЕ (Воапа РаёаЪазе 
Епоше). Вообще говоря, это не лучший вариант. Во-первых, при использова- 
нии ВПЕ иногда могут возникать проблемы с кириллицей в базах данных, ис- 
пользующих ОМСОПЕ. Во-вторых, надо позаботиться о том, чтобы на компь- 
ютере, содержащем серверное приложение, была установлена ВОЕ. Так что не- 
редко удобнее использовать, например, механизмы АШО вместо ВПБЕ. При ис- 
пользовании АПО указанные выше проблемы обычно снимаются. 

Тем не менее, у ВПЕ есть свои преимущества, так что коротко рассмотрим 
вопросы переноса приложений на компьютер, на котором не установлена ВОЕ. 
Оживить ваше приложение на новом компьютере можно. двумя путями. Пер- 
вая возможность — установить ВОЕ. Проще всего это сделать с тех же дисков, 
с которых вы устанавливали С++Ви!аег на своем компьютере. Только при ус- 
тановке надо отключить все индикаторы, определяющие, что именно устанав- 
ливается, кроме индикатора ВПЕ. Тогда на компьютере установится ВБЕ. 
Правда, вам еще надо будет ввести на новом компьютере все используемые 
вами псевдонимы (а|аз). А если приложение или его базы данных используют 
имена пользователей, то надо ввести на новом компьютере соответствующие 
имена пользователей. 

Установка ВПЕ, причем избирательная, относящаяся только к используе- 
мым типам баз данных, возможна также с помощью программы шзаП5Ыеа 
Ехргез$, поставляемой вместе с С++Ва|д4ег. 

Второй вариант переноса приложения — обойтись без установки ВПЕ. Это 
может потребоваться, в частности, если хозяева компьютера не разрешают 
провести подобную установку, или если у вас нет соответствующих прав досту- 
па к ресурсам системы. Тогда надо перенести в тот каталог, в который вы по- 
мещаете файл вашего приложения, еще ряд файлов из каталога ...\Ргойтгат 
ЕПез\Сотштоп ЕШез\Вог|апа ЭБагеа\ВОЕ вашего компьютера: как минимум, 
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Баплат.аНИ, БЫшзЗ2.аИ, спатзет.соб, 1аар132.аИ, 14г20009.аП, иза.6И, 1арахз2.аП 
для таблиц Рага4ох или 1а4фаз32.а[П для таблиц ОВЕ. Это займет у вас в архи- 
вированном виде около 500 КБ, а в распакованном — около 1 МБ. Возможно, 
потребуются и какие-то другие файлы — это зависит от особенностей вашего 
приложения. В крайнем случае, можете перенести из указанного каталога все 
файлы типов .АЦ, .соб и .БИ (кроме, вероятно, 7арап.6 ИН, если ваша программа 
не разговаривает по-японски). Этих файлов заведомо хватит для любой про- 
граммы. Но их объем в несколько раз больше: примерно 4,5 МБ в архивиро- 
ванном виде и 10 МБ в распакованном. | 

В тот же каталог, в котором вы все это разместите, надо перенести ваши 
базы данных. А в приложении обращаться к таблицам не по псевдонимам, а по 
именам их файлов. Можно сделать и иначе: разместить базы данных в ка- 
ких-то каталогах и обращаться к ним из приложения, указывая полный путь 
к ним. Но тогда могут возникнуть проблемы при перестроении файловой сис- 
темы компьютера. 

Конечно, описанный вариант не устанавливает полностью ВПЕ со всеми ее 
возможностями, так как ВШЕ хранит свои установки в системном реестре 
и для полной установки надо еще занести в реестр соответствующие ключи. 

Поскольку речь идет о ВПЕ, остановимся еще на одной задаче, не связан- 
ной с разработкой удаленных модулей данных. В состав ВПОЕ входит програм- 
ма ПРабабазе ПесЖФюор, используемая при создании и редактировании таблиц 
данных. Если вы откроете в этой программе какую-то таблицу, в которой име- 
ются строковые поля, содержащие русские тексты, то увидите вместо этих 
текстов непонятные иероглифы. Аналогичные проблемы могут возникать 
и в некоторых других случаях. Имеются различные варианты решения этой 
проблемы, связанные с подбором шрифтов. Но, пожалуй, наиболее простой ва- 
риант связан с изменением номера кодовой страницы. Для этого надо задать 
в ключе реестра НКЕУ ТГОСАШ МАСНТМЕ\УЗТЕМ\Согге {Сохо Зе \Сопфго[\ 
№5\СоаеРаде значение параметра “1252” равным “с_1251.113”. Выполняется 
это с помощью программы гебе4И.ехе, расположенной в каталоге У/1шт@4о\мз. 
Вызвав эту программу, надо в ее левой панели раскрыть указанный выше узел 
дерева ключей, в правой панели найти параметр "1252", щелкнуть на нем пра- 
вой кнопкой мыши, выбрать в контекстном меню раздел Изменить и в открыв- 
шемся окне заменить значение "1252", записанное по умолчанию, на значе- 
ние "1251". 

Указанный прием позволяет устранить проблемы с кириллицей не только 
в Эабаразе ПесКфор, но и во многих других программах \У1ш9о\мз. Если, все-та- 
ки, что-то в работе каких-то программ нарушится, вы всегда можете отсту- 
пить, вернув параметру указанное выше значение по умолчанию. 


11.3 Клиентское приложение 


11.3.1 Описание примера 


В предыдущем разделе был построен удаленный сервер данных. Теперь 
можно проектировать клиентское приложение. Построим его на компоненте 
СПешОа{фа5е{ — одном из основных компонентов наборов данных в последних 
версиях С++ВаНаег. Работа с этим компонентом подробно описана в книгах 
[1], [5], а также в [4]. Так что далее я буду полагать, что читатель знает этот 
компонент. Тем не менее, я подробно, но без излишних пояснений, изложу все 
шаги по созданию приложения. Этого хватит, чтобы понять, как проектиро- 
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вать клиентские приложения. Ну а более подробно познакомиться с СПепФа- 
фа её можно по литературе. | 

Окно создаваемого клиентского приложения (проект СПептМуЕМО 
в группе проектов РОМиуАМР в каталоге ДаёаМодшез на приложенном к кни- 
ге диске) показано на рис. 11.5. Правда, строки внизу окна, связанные с ото- 
бражением моментов времени, относятся к усложненному варианту клиента, 
рассмотренному позднее. 

В окне распложены обычные для подобных приложений компоненты: на- 
вигатор ОВМамвафог, таблица ОВСг1а, ОВПпахе для отображения фотогра- 
фии и ОВМето для отображения характеристики. В ОВО предусмотрено 
задание отдела, в котором работает сотрудник, выбором из списка имеющихся 
отделов. На рис. 11.5 изображен момент выбора отдела для сотрудника 
Иванова. 


Рис. 11.5 [= ны С И. | =191Х] 
Клиентское | обновить | 
приложение 
ст| > | м 
Антонина я 1 т р 
Иванов Иван Иванович 1950 
| Николаев Николай Николаевич 1930 
Борисов Борис Борисович 1937 
Иванова Ирина Ивановна 1961 
Павлов Павел Павлович 1975 —- 
Петров Петр Петрович 1960 [Карактеристика 
— ванова Ивана Ивановича, 
Андреев Андрей Андреевич 1930 1950 г.р., 
Иванников Иван Иванович 1975 сотрудника бухгалтерии 


Сидоров Сидор Сидорович — 1355 ИИ. Иванов отличный работник. 


Харитонов Жаритон Харитонович 1962 | 
Начальник ОК И.И. Иванов 


Сотрудников в подразделении Бухгалтерия 3 Всего : 11 . Поиск Гы ^ 


Время последнего изменения в базе данных: 09.03.2006 18:08:04 - 
Время последнего обновяения из базы данных: 10.03.2006 11:23:15 


Ниже компонента ОВСт14 отображаются совокупные характеристики таб-. 
лицы. Слева отображается число сотрудников того отдела, который указан 
в текущей записи в ОВС. А в середине отображается общее число сотрудни- 
ков в данной организации. В правом нижнем углу имеется окно быстрого по- 
иска. По мере ввода в него символов курсор таблицы перемещается на запись, 
в которой первые символы фамилии совпадают с введенными в окно. 

Кнопка В базу данных заносит в удаленную базу данных результаты редак- 
тирования. Кнопка Отменить отменяет все результаты редактирования, прове- 
денного с момента последнего щелчка на кнопке В базу данных. Кнопка Обно- 
вить обеспечивает отображение текущего состояния базы данных. Дело в том, 
что с базой данных может одновременно работать несколько клиентов. Каж- 
дый из них работает с локальной копией данных, в которой не отображаются, 
конечно, изменения, произведенные другими пользователями после создания 
этой копии. Так что полезно иметь возможность обновлять локальную копию, 
занося в нее истинное состояние таблицы данных на текущий момент времени. 

В начале выполнения клиентского приложения пользователю предлагает- 
ся ввести свое имя и пароль. Если имя "Гость", пользователю запрещается ре- 
дактировать данные. Если имя "1" и пароль "1", пользователь может и смот- 
реть, и редактировать данные. В остальных случаях пользователь не допуска- 
ется к работе с приложением. 
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Рассмотрим теперь по шагам процедуру создания подобного клиентского 
приложения. Перенесите на форму компонент ОСОМСоппесйоп со страницы 
Оаафпар. Этот компонент обеспечит связь клиента с удаленным модулем дан- 
ных по технологии ОСОМ. Если связь с удаленным сервером надо создать с по- 
мощью сокетов ТСР/ТР (см. разд. 9.5), вместо ВСОМСоппесйоп надо использо- 
вать компонент ЗоскКеСоппесйоп. Для связи с помощью НТТР используется 
\УеСоппесйоп. В нашем примере будем применять ОСОМСоппеейоп, так 
как решили использовать РСОМ. 

Для указания сервера воспользуйтесь свойством егуегМаше. Выпадаю- 
щий список около этого свойства в Инспекторе Объектов содержит имена 
классов зарегистрированных серверов РСОМ. В нем должен быть и сервер, ко- 
торый мы создали и зарегистрировали в разд. 11.1. Впрочем, он будет там, 
если сервер расположен на том же компьютерё, на котором проектируется 
клиентское приложение. Если сервер расположен на другом компьютере, надо 
задать имя этого компьютера в свойстве СотрщегМате. Его удобно задавать, 
воспользовавшись кнопкой с многоточием около этого свойства в окне Инспек- 
тора Объектов. 

После того как задано значение ЭегуегМате, автоматически установится. 
значение свойства ЗегуегСОТО, содержащего уникальный идентификатор 
СИОТО сервера. Можно поступить иначе — задать значение ЗегуегС ОТО. Тогда 
автоматически установится значение имени класса в свойстве ЗегуегМате. 
Требуемое значение ЗегуегС ОТО можно найти, в частности, в реестре. Если вы 
предпримете в нем поиск класса или сокласса (в нашем случае «1 МуВМо) сер- 
вера, то найдете ключ, в котором зарегистрирован этот класс. Имя ключа 
и есть СОТО сервера. 

Задание ЗегуегС ОТО, а не ЗегуегМате, предпочтительнее при размеще- 
нии сервера на удаленном компьютере, так как не требует регистрации серве- 
ра на компьютере клиента. | 

Установка в фгие свойства Соппесзфе4 обеспечивает соединение с сервером. 
Даже во время проектирования установка этого свойства обеспечит запуск сер- 
вера. Если он находится на том же компьютере, вы увидите, что сервер поя- 
вится в полосе задач. При задании Соппефе@ = #а]$е сервер завершит выпол- 
нение. Впрочем, нам не требуется сейчас задавать Соппесфед = фтие. Это свой- 
ство установится программно во время выполнения. 

Перед соединением с сервером и после него возникают события Веёоге- 
Соппес+ и АЁегСоппес+. В обработчике первого из них можно предварить со- 
единение какой-то процедурой, например, запросить имя и пароль пользовате- 
ля. Для этого можно использовать функции ВветофеГ. от П1а1о5, Гот О1а]1ох, 
Гот а]о5 Ех, объявленные в модуле ДВГоЕГМ=.срр. Например: 


#1ос1тоае <ОВГоар19. Ирр> 


уо+а __Еаз®са11 ТРГогш2; : РСОМСоппес® 1оп1ВеЕогеСоппесе ( 
ТОБ]ес®е *5епаег) 
{ 
Ап$15сг1па Раззмога, ОзегМаше = "Гость"; 
1Е (! Вемосероч1пр1а1о9 (ОзегМаме, Раззмога)) 
{ 
Арр11са®*1оп->МеззадеВох ("Вы не указали имя и пароль", 
"Приложение закрывается" 
МВ_ТСОМ$ТОР); 
Арр11са%*1оп->Теги1паее(); 
} 
е1зе <анализ имени и пароля или передача их на сервер> 


} 
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В этом примере функция ВетофеГ,о1иО1а1ой предъявляет пользователю 
диалог, показанный на рис. 11.6. В качестве аргументов в функцию можно пе- 
редать значения имени и пароля по умолчанию. И в этих же параметрах мож- 
но прочитать ответ пользователя. Если пользователь отказался от диалога, 
щелкнув на кнопке Сапсе|, нажав Е5с или закрыв окно системной кнопкой, 
функция возвращает Ёа|5е. 


Рис. 11.6 Кепто(е Год 


—- 


Из5ег Мата: они _ 


Диалоговое окно запроса Пароля 


Разина: = | 
ООО 
[=] еее | 


Имеется и иной способ запросить имя и пароль пользователя — устано- 
вить в ёфгие свойства [0511 Рготрё. Тогда перед соединением с сервером во вре- 
мя выполнения пользователю будет показано то же диалоговое окно, приве- 
денное на рис. 11.6. Перед показом окна возникает событие Оп(бе Озегпате, 
в обработчике которого можно задать имя пользователя, показываемое в окне. 
рис. 11.6 по умолчанию. После того как пользователь ввел в диалоговом окне 
информацию и щелкнул на кнопке ОК, происходит соединение с удаленным 
сервером и возникает событие ОпГодта. В его обработчике можно проанализи- 
ровать введенное пользователем имя и пароль и принять соответствующие 
меры, ограничивающие доступ пользователя к информации. В частности, 
можно передать имя и пароль удаленному серверу, на котором содержится ин- 
формация о пользователях, допущенных к базе данных. Если пользователь от- 
казался от диалога, щелкнув на кнопке Сапсе|, нажав Е5с или закрыв окно 
системной кнопкой, событие ОпГог1т не наступает. Это обстоятельство можно 
использовать, как в приведенной далее реализации приложения, для приня- 
тия в этом случае соответствующих мер. | 

В приведенной далее реализации приложения для запроса пароля исполь- 
зуется свойство ГобтРготрё. Так что установите его в ёгие. Но сделано это 
только для того, чтобы показать способы использования свойства ГоРт- 
Рготрй. А в целом надо сказать, что окно на рис. 11.6, конечно, не является 
наилучшим вариантом запроса, поскольку не русифицировано. Лучше запро- 
сить пароль в обработчике события Ве{огеСоппесф, как было описано выше, но 
не с помощью стандартных функций, а создав собственное диалоговое окно, ес- 
тественно, с русскими текстами. | 

Продолжим создание нашего приложения. Поместите на форму компо- 
нент СПепОаёа её со страницы библиотеки О/а Ассе$$ (в С++ВиП@ег 5 он рас- 
положен на странице Маз). Он будет служить в качестве клиентского набора 
данных. В его свойстве ВетофеЗегуег надо задать ссылку на имеющийся на 
форме компонент ВСОМСоппесй оп]. После этого откройте выпадающий спи- 
сок в свойстве Ргоу14егМаше компонента СПеш аа е 1. Вы увидите в нем 
имена двух провайдеров: ОЗРРег$ и ОЗРОер. Это те провайдеры, которые вы 
создали в удаленном модуле данных. Выберите из списка провайдер ОЗРРегз, 
так как наше приложение должно связываться с таблицей Рег®. 

Фактически, основа клиентского приложения создана. Осталось размес- 
тить на форме компоненты отображения данных, настроить их и настроить на- 
бор данных. Перенесите на форму компоненты БВаёабоогсе, ОВМамваог, 
ОВСна, ОВПпабе, ОВМето. Обычным образом Вафабоогсе связывается свой- 
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ством ВаёаЗеф с набором данных СПешОафа5 её 1. Остальные данные своими 
свойствами ОаёаЗопгсе связываются с Эаёабоигсе1. Кроме того, компоненты 
отображения данных связываются свойствами Оафа Ев 4 с соответствующими 
полями: ОВПпайе1 с полем Рвофо, а ОВМето1 — с СВвагас&. 

Займемся теперь настройкой набора данных СЙНеп Дафа её 1. Вызовите Ре- 
дактор Полей двойным щелчком на этом компоненте. Работа с редактором 
проводится так же, как при настройке других наборов данных. Правда, с уче- 
том того, что в данном случае не срабатывает словарь, обеспечивающий руси- 
фикацию и настройку полей (подобный словарь для базы данных ЧР есть на 
диске, приложенном к книге). Так что вам надо ввести в Редакторе Полей все 
поля и настроить их отображение, задав, в частности, русские заголовки. По- 
добная процедура подробно описана в [1] и [5], так что не будем на ней останав- 
ливаться. Обычным образом также вводится вычисляемое поле Арге, отобра- 
жающее возраст сотрудников, исходя из их года рождения и текущего года. 

Теперь остановимся на особенностях настройки, присущих именно СЦПепф- 
РаёфаЗеф. Прежде всего, эти особенности связаны с вычислением совокупных 
характеристик по всем записям или по группе записей. Но предварительно 
надо рассмотреть вопрос упорядочивания записей, так как без упорядочива- 
ния невозможно говорить о группах записей. 

У компонента СПешОафа5её имеется, как и у других наборов данных, 
свойство ш4ехМаште — имя индекса. Но провайдер не обеспечивает передачу 
в набор индексов, созданных в таблице базы данных. Так что индексы надо 
создавать в наборе СНешОафёазеф во время проектирования или программно во 
время выполнения. 

Индексацию можно установить, задав значение свойства ш4ехЕ1е|аМате$ 
в виде строки, перечисляющей поля с разделяющими из точками с запятой. На- 
пример, значение “Оер;Кат;Мат;Раг” соответствует упорядочиванию по назва- 
нию отдела, а внутри каждого отдела — по алфавитной последовательности фа- 
милий, имен и отчеств. Но для нашей задачи этого мало. Нам потребуется ин- 
декс, на который можно будет ссылаться по имени. Это имя задается в свойстве 
[14ехМате$. Но прежде, чем ссылаться на имя индекса, его надо определить. 
Это делается с помощью свойства ш@4ехОеё5. Щелчок на кнопке с многоточием 
около этого свойства в Инспекторе Объектов вызывает окно формирования кол- 
лекций объектов, использующееся в С++ВаИаег для формирования многих 
свойств. Нажав в этом окне кнопку Ада Мем,, вы создадите новый объект индек- 
са и увидите в Инспекторе Объектов его свойства. Свойство Мате определяет 
имя индекса, на которое в дальнейшем можно ссылаться. В свойстве Е1е14$ за- 
писывается строка перечисления полей, аналогичная описанной выше для 
свойства ш4ехЕ1е]ЧМате. Так что в нашем примере запишите в свойство Е1е]4$ 
эту строку и занесите в свойство Маше имя индекса — "4ер#о". 

После того как вы заполнили свойства Мате и Е1е]4$ индекса, можете вый- 
ти из редактора индексов и посмотреть свойство ш4ехМате компонента кли- 
ентского набора. Около этого свойства в Инспекторе Объектов появится выпа- 
дающий список, из которого надо выбрать имя введенного вами индекса 4ерйо. 

Теперь все готово для создания полей совокупных характеристик, содер- 
жащих числа сотрудников по отделам и число всех сотрудников в организа- 
ции. Эти вопросы рассмотрены в источниках [1] и [5], так что ограничимся, 
как и ранее, описанием последовательности шагов при проектировании наше- 
го клиентского приложения. 

Сделайте двойной щелчок на компоненте СПешОа{фа5е1, чтобы открыть 
Редактор Полей. В окне редактора сделайте щелчок правой кнопкой мыши 
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и выберите из контекстного меню раздел Мех Нез. Откроется окно, показан- 
ное на рис. 11.7. Оно отличается от аналогичного окна, например, компонента 
Тае двумя дополнительными радиокнопками: мета Со и Адогедае. Пер- 
вая из них определяет вычисляемое поле, которое не вычисляется динамиче- 
ски при чтении данных, а сохраняется в таблице в виде отдельного поля. 
А кнопка Адогедае позволяет определить поле совокупной характеристики. 
Для этого поля достаточно задать имя Мате, а тип поля автоматически устано- 
вится равным Адагедае. 


Рис. 11.7 


Задание поля совокупной А рр 


характеристики | те: [Сони СогпропеиЕ [Сетаабе Соии! 
[Аодгедае ы Сее: С 


{. ——=——щ——— = ———————— === ————————————————-—=———— 


г Аа и а 
с Ва Г Сасчаед С ШооКир 


= 


=—- 


| 
Вазы Рей. Г. - 


= ще А 


Сапсе! . |. Нер | 


Введите в окошко Мате имя создаваемого поля — Соипф. Это поле будет 
отображать в приложении число сотрудников по подразделениям. Щелкните 
на ОК. Вы вернетесь в окно Редактора Полей, в нижней части которого поя- 
вится имя нового поля. Выделите его и посмотрите в Инспекторе Объектов 
свойства объекта этого поля. Основное свойство, задающее значения поля, — 
Ехрге$510п. В нем вы должны записать выражение, задающее значение поля. 
Помимо обычных арифметических операций, скобок, имен полей и констант, 
выражение может содержать следующие функции: 


Сумма значений числового поля или арифметического 1 выражения. 


‚ Среднее значение числового поля, или поля даты и времени, или 
арифметического выражения. 


Число непустых значений указанного поля или выражения. Функ- 
‚ция Соцпё(*) возвращает общее число записей, независимо от значе- 
ний полей. 


Возвращает минимальное значение числового поля, строкового поля, 
‚поля дат и времени или соответствующего выражения. 


Мах. Возвращает максимальное значение числового поля, строкового 
| поля, поля дат и времени или соответствующего выражения. 


ОНО ОНИ и 


ИИ 


Для введенного нами поля в его свойстве Ехргез$1юп задайте строку 
"Соцчп(*)” — расчет числа записей. 

Выражения совокупных характеристик могут вычисляться по всем запи- 
сям таблицы, или по некоторой их совокупности. Если вы хотите вычислять 
по совокупности записей, в которых какое-то поле имеет определенное значе- 
ние, то набор данных должен быть индексирован так, чтобы интересующее вас 
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поле входило в этот индекс. Причем, этот индекс должен быть активным, т.е. 
на него должно ссылаться свойство ш4ехМаште компонента набора данных. 
Ссылка на индекс из поля совокупной характеристики осуществляется сле- 
дующим образом. В свойстве поля ш4ехМате надо задать индекс, на который 
опирается вычисление суммарной характеристики. А в свойстве Сгопрше- 
Геуе] надо задать число первых полей в индексе, совпадение которых выделя- 
ет группу записей, по которой вычисляется характеристика. Значение Сго- 
иршеГеуе! = 0 соответствует подсчету характеристик по всем записям набора 
данных, независимо от текущего индекса. 

В нашем примере мы хотим, чтобы в поле Соипф отображалось число со- 
трудников в отделе. Поэтому в свойстве агопршеГеуе] этого поля задайте зна- 
чение 1, а в свойстве шдехМаше — “аерЁо”. Тем самым вы указали, что при 
расчете значения данного поля записи будут группироваться индексом 4ерйо 
и при выделении группы будет учитываться совпадение значений только одно- 
го первого поля (первым в индексе 4дерйо указано поле Бер). 

Для того чтобы совокупная характеристика вычислялось, надо не забыть 
установить в фгае свойство АсЯуе данного поля. Но и этого мало — значение 
поля будет вычисляться, только если значение свойства АхогебавеАсйуе 
компонента клиентского набора будет установлено в фгае. Так что не забудьте 
установить значение этого свойства компонента СНеОафабе{1. 

Создайте еще одно поле совокупной характеристики для отображения об- 
щего числа сотрудников учреждения. Назовите его Соип 6 АП. В свойстве этого 
поля Ехрге$$10оп задайте строку "Соип\(Оер)". Это обеспечит расчет числа за- 
писей, в которых поле Оер не пустое. Свойство СгопршеГеуе] оставьте рав- 
ным нулю по умолчанию, а свойство ш4ехМате — пустым. Тем самым вы 
указали, что данное поле рассчитывается не по группе записей, а по всей таб- 
лице данных. 

В описании поля Соип в АП вместо строки “Соип(Оер)” можно было бы за- 
писать "Соип((*)” — общее число записей. В нашем примере различия не было 
бы. Но если база данных может содержать записи, в которых поле Вер не за- 
полнено (например, уволенных сотрудников или лиц, только поступающих на 
работу), то различие будет заметно. 

Вам осталось разместить на форме метки, отображающие совокупные ха- 
рактеристики. В примере на рис. 11.5 надписи “Сотрудников в подразделе- 
нии’ и "Всего :" обеспечены обычными метками ГаБе], а отображение имени 
подразделения ("Бухгалтерия” на рис. 11.5) и чисел сотрудников обеспечива- 
ется компонентами ОВТехё, настроенными на поля Оер, Соип{ и Соивё АП. 

Набор данных полностью настроен. Осталась небольшая настройка компо- 
нента ОВС1а1. Мы хотим, чтобы в столбце Отдел пользователь мог выбирать 
отдел из заданного списка и не мог по ошибке ввести какой-то отсутствующий 
в организации отдел. Для настройки столбцов сделайте двойной щелчок на 
компоненте ОВСт1а1 или щелкните на кнопке с многоточием около свойства 
Соити$з в окне Инспектора Объектов. В открывшемся окне редактора коллек- 
ций нажмите быструю кнопку Ада А! Не|4$ или выберите аналогичный раздел 
в контекстном меню. Удалите из списка поля, которые не должны отображать- 
ся в таблице. Далее выделите столбец ,ер, и в окне Инспектора Объектов 
щелкните кнопку с многоточием около свойства Р1еКТ1$%. В открывшемся 
окне редактора введите строки 

Бухгалтерия 


Цех 1 
Цех 2 
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Это список отделов, имеющихся в организации. Конечно; лучше было бы про- 
читать этот список из таблицы Шер базы данных @ЪР. Я не стал этого делать, 
чтобы не усложнять пример. 

Если заполнен список Р1еКГ1$%6, то при желании пользователя редактиро- 
вать значение данного поля в записи в таблице появится кнопка раскрываю- 
щегося списка, из которого он сможет выбрать значение (см. рис. 11.5). Прав- 
да, он все-таки сможет написать название отдела, а значит, сможет сделать ка- 
кую-то ошибку в нем. Исключить эту возможность нельзя, установив в фгае 
свойство ВеааОщу, так как тогда вообще нельзя будет редактировать данное 
поле. Одно из возможных решений этой задачи заключается в программном 
запрете редактирования, как будет показано далее при обсуждении кода дан- 
ного приложения. | 

Аналогичным образом имеет смысл задать список, содержащий строки 
"ми "ж” в свойстве Р1сЕГ1 $$ столбца $Зех. 

Нам осталось добавить в приложение окно редактирования ЕЯ], которое 
позволит осуществлять быстрый поиск записи, и три кнопки: В базу данных (ее 
имя в тексте модуля ВБааВазе), Отменить (имя ВКоШаеК), Обновить (имя 
ВКеЁ!ге5В). Далее можно приступать к программированию. 

Следует отметить, что в процессе настройки клиентского набора данных 
компонент ОСОМСоппесоп1 соединяется с сервером и запускает его. При 
этом свойство СоппефеЯ компонента ОСОМСоппесИоп1 становится равным 
фгие. Верните этому свойству значение #а]5е, так как соединение с сервером 
будет в данном приложении осуществляться программно. 


11.3.2 Программная реализация 


Ниже приведен код реализации описанного в предыдущем разделе кли- 
ентского приложения с некоторыми сокращениями, которые будут восполне- 
ны в следующем разделе. 


#1пс1и4е <дафеи®11$.Прр> 


106 МубауеРо1пЕ; 
Боо1 Мод1Е1еа =: Еа1зе; 
Боо1 Тоа1лп = Еа1$е; 


у©о14 . __ЕазЕса11 ТЕоги1 : : РогпСгеаее (ТОр]есе *бепаег) 
{ 

С11епЕРафа5е{1->Ореп (); 

МубауеРо1пЕ = С11еп*Пафабее1->бауеРо1пЕ; 


у01А __Еаз6са11 `ТРогш1 : : ОСОМСоппес& 1оп1бе 0зегпапе ( 
ТОБ]есе *бепаег, Ап$156г1па &Озегпапе) 
{ 


Озегпаме = "Гость"; 


уо1Аа __Еазфса11 ТЕГогш1 : : ОСОМСоппесЕ1оп1 Вод1п (ТОБ)]есЕ *5епаек, 
Ап5156©г1па Озегпате, Апз156г1па Раззмога) 

{ 

1Е(Озегпаще == "Гость") 

| 

ВРафаВазе->Епар1е = Ёа15е; 

ОВСг1а1->ВеаЯОп1]у = +гие; 

ОВМепо1->ВеаЯОп1у = %гие; 

} 
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е]1зе 1ЁЕ(! ((Ап$1ГомегСазе (Озегпаме) == "1") && 
(РаззмогЯ == "1"))) | 


{ 


Арр11сае1оп->МеззадеВох ("Неверное имя или пароль", 
"Приложение будет закрыто", 
МВ_ТСОМ$ТОР); 
Арр11са®*1оп->Теги1паее (); 


} 


.оа1п = $гое; 


\01А __Еаз®са11 ТРогм1: : РогабПом (ТОБ]есЕ *5епаег) 


1Е(! Года1п) 

{ 

Арр11са*1оп->МеззадеВох ("Вы не задали имя и пароль", 
"Приложение будет закрыто", 
МВ _ТСОМ$ТОР); 


С1озе (); 


\у01А __Газ®са11 ТРГогм1: : РогмС1озе (ТОБ)есЕ *5епаекг, 
ТС]1озеАсЕ1оп &АсЕ1оп) 


{ 
С11епЕПРафабе*1->С1озе(); 


у01А __Еаз®са11 ТГогм1: :ВрабаВазеС11сК (ТОБ)]есе *Збепаег) 


{ 
Егу 
{ 
С11епЕРафабее1->Арр1у0рааеез (-1); 
МубауеРо1п%Е = С11епеРафабее1->5ауеРо1пЕ; 
Мо91Е1еа = Еа15е; 
} 
сафср (...) 


Таре13->Сар*1оп = "Не удается связаться с сервером"; 


\01А __Еазеса11 ТКогп1:; :С11епРабабее1АЁЕекРоз% (ТРафабее *Рафа5еф) 
{ 


Моа1Е1еа = %гое; 


Уо1а __Еаз®са11 ТГогм1: : ГогмС1озеОчегу (ТОБ]есе *5епаег, 
роо1 &СапС1озе) 


{ 
1Е (Моа1Е1еа) 
зи1Еср (Арр11сае1оп->МеззааевВох ( 
"Данные были изменены. Сохранить их в базе данных?", 
"Подтвердите сохранение изменений", 
’МВ_УЕЗМОСАМСЕТ | МВ_ТСОМОЧЕЗТТОМ)) 
{ 
сазе ТОСАМСЕГ: СапС1озе = Еа1зе; 
ЬгеаКк; 
сазе ТРУЕЗ: С11епРафабеё1->Арр1у0Орадаф$ез (-1); 
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у01А __ЕазЕса11 ТЕогм1: :ВКо11раскС11сК (ТОБ]есЕ *5епаег) 
{ 

С11епсРафабеф1->5ауеРо1пЕ = МубауеРо1пе; 

МоЯ1ЕзеЯ = Еа15е; 


у01А _ Еазеса11 ТЁГогм1: : ВВеЁгезВС11ск (ТОБ)есе *5епаег) 
{ 
Ехгу 
{ 
ТЕ (Моа1 Езед) 
$м1Еср (Арр11саф1оп->МеззааевВох ( 
"Данные были изменены. Сохранить их в базе данных?", 
"Подтвердите сохранение изменений", 
МВ_УЕЗМОСАМСЕТ | МВ_ТСОМОЧЕЗТТОМ)) 
{ 
сазе ТРОСАМСЕГ: гебагп; 


сазе ТРУЕЗ: С]11епРафабе\®1->Арр1уОраакез$ (-1); 
ргеаКк; 
сазе ТОМО: С11епРафа5е*1->Сапсе1Ирдатез (); 


} 

// С11епЕБава$еЕ1->ВеЁгезПВ();. 
С11еп+Рафабе*1->С1озе(); 
С11еп{Рафа5еф1->Ореп (); 

МубауеРо1пЕ = С11епПафабее1->5ауеРо1пф; 
Моа1Е1еа = Еа1зе; 


} 
саесь (...) 


{ 


Тафе14->СарЕ1оп = "Не удается связаться с сервером"; 


Уу01А __Еаз®са11 ТРГогм]1 : : ОВбсг1А1КеуРгез$ (ТОБ]ес®& *Зеп4ег, сПпаг &Кеу) 


{ 
1Е((2Вбг191->5е1есфеаТптаех == 0) || 
(2ВСг1а1->5е1есфёеаТпаех == 5)) 
Кеу = 0; | 


У01А _ Еазса11 ТРогм1 : :С11епРафа5е*1Са1сЕ1е] 4$ (Трафабеф *Рафабеф) 


{ 
С11епеРафа5е*1Аде->\Уа1ае = УеагоОЕ (Рафе()) - 
С11еп Рафа5е*1Уеаг Ъ->Уа11е; 


} 
у01А _ ЕазЕса11 ТЕРоги1:; :Еа1®1СПапде (ТОР]есЕ *5епаек) 


{ 

ТЬосакеОр*1оп$ ЗеагсрОре1опз; 

ЗеагспОр$1о0оп$ < 1оРаг®1а1Кеу < 1оСазе1Тпзепз1Е1уе; 

С11еп < Ра*а5её1->Госа*е ("РГам",Еа1Е1->Техе, ЗеагсПОр®1опз$); 


} 


В функции ЕогтСгеже, являющейся обработчиком события формы Оп- 
Сгеже, набор данных СПепОафа5е{1 открывается методом Ореп. Открытие 
клиентского набора данных автоматически устанавливает в фгие свойство 
Соппес4е4 компонента ОСОМСоппеес оп1. При этом происходит вызов уда- 
ленного модуля данных. Если в момент обращения к модулю его нет в памяти 
сервера, то серверное приложение загружается в память. Если же экземпляр 
серверного приложения уже выполняется на сервере, то увеличивается на 
1 число ссылок на него — число клиентов, работающих с этим модулем. Сер- 
верное приложение будет находиться в памяти сервера до тех пор, пока число 
ссылок на него больше нуля, т.е. пока имеется хотя бы один клиент, работаю- 
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щий с ним. В нашем примере разрыв соединения с сервером происходит в про- 
цедуре Еогт(С]1о$е при закрытии клиентского приложения. | 

После соединения с сервером записи из удаленной базы данных переносят- 
ся в локальную копию данных на клиентском компьютере. Второй оператор 
функции ЕогтСгеже запоминает в переменной МуЗауеРошЕё состояние дан- 
ных на этот момент времени. 

В действительности между открытием клиентского набора и загрузкой. 
в него данных проходит довольно длинная череда событий. В частности, по- 
скольку в ОСОМСоппес10оп1 свойство Г051тРготр установлено в фгае, возни- 
кает событие ОпСе О5егпате. В обработчике этого события — функции 
ОСОМСоппесйоп1Се О егпате задается имя пользователя по умолчанию: 
в переменную Озегпате заносится строка "Гость". Затем пользователю пред- 
лагается диалоговое окно, показанное в разд. 11.3.1 на рис. 11.6. Если пользо- 
ватель после работы с этим окном щелкнул в нем на кнопке ОК, наступает со- 
бытие ОпГот. Функция ВСОМСоппесИоп1Т.051т является обработчиком это- 
го события. В ней проверяется имя пользователя и пароль. Если имя равно 
“Гость”, то делается недоступной кнопка В базу данных (В)аёаВазе) и свойство 
Веа4Ошу компонентов ОВС 91 и ОВМето1 устанавливается в фгие. Тем са- 
мым исключается возможность редактирования данных. Если имя пользова- 
теля не равно "1" или пароль не равен "1", то после соответствующего сообще- 
ния приложение закрывается, т.е. при неверном пароле или имени пользова- 
тель не допускается к работе. 

Событие ОпГ.о?1т наступает только в том случае, если пользователь завер- 
шил диалог, щелкнув в нем на кнопке ОК. Если же пользователь закрыл окно 
диалога системной кнопкой, или нажал клавишу Е5с, или щелкнул на кнопке 
Сапсе|, то это событие не возникает. Надо как-то поймать такого пользователя, 
отказавшегося от диалога. Для этого в приложении введена переменная Г.0511, 
по умолчанию равная Ё#а]5е. А в обработчике ОСОМСоппесйоп 11.0211 ей при- 
сваивается значение фгие, свидетельствующее, что пользователь нормально за- 
вершил диалог. В обработчике Еогт5Во\ события формы Оп$Во\ проверяет- 
ся значение переменной Гот. Если оно равно #а[5е, то после соответствующе- 
го предупреждения приложение завершается. 

Функция ВОаёаВазеСИсК — обработчик щелчка на кнопке В базу данных. 
В ней методом Арр!у0Ордафе$ содержимое клиентского набора данных перено- 
сится в удаленную базу данных. Аргумент метода — максимальное число оши- 
бок, после которого занесения в базу данных прекращается. Значение —1 пока- 
зывает, что занесение не будет прекращаться ни при каком количестве ошибок. 

После занесения изменения в базу данных текущее состояние клиентского 
набора запоминается в переменной МуЗауеРот+. Кроме того, задается значе- 
ние #а]5е переменной Мод Шед. Смысл этой переменной, введенной в приложе- 
нии, следующий. При завершении работы приложения может оказаться, что 
пользователь произвел какое-то редактирование данных и забыл сохранить их 
в базе данных. Переменная Мо1е4 призвана зафиксировать подобную ситуа- 
цию. В функции ВОаёаВазеСПсК ей присваивается значение #а]5е, свидетель- 
ствующее о том, что все результаты редактирования сохранены. А обработчи- 
ке СПешОафа5 е 1АЁвегРо5$ события АЁЙегРо${ переменной Мод \1е4 присваи- 
вается значение фгие, свидетельствующее о том, что в локальной копии дан-` 
ных проведены изменения. В функции ЕогтСозе0оегу, являющейся обработ- 
чиком события ОпС]о5ебиегу формы, проверяется значение Мод еда. Если 
есть несохраненные изменения, пользователь видит диалоговое окно, показан- 
ное на рис. 11.8. Если пользователь щелкнет в нем на кнопке Да, соглашаясь 
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с необходимостью сохранить изменения, изменения сохраняются описанным 
выше методом Арр!у0Ордае$. Если пользователь щелкнет на кнопке Отмена 
или нажмет клавишу Езс, закрытие приложения прекратиться, так как пара- 
метр СапС]о$е получит значение Ёа15е. Таким образом предотвращается слу- 
чайное, отибочное прекращение выполнения приложения. А если пользова- 
тель щелкнет на кнопке Нет, приложение завершится без сохранения данных. 


Рис. 11.8 

Окно сообщения о наличии 
несохраненных изменений 
данных 


_ Нет Отмена | 


Функция ВВоасКСИПсЕ является обработчиком щелчка на кнопке Отме- 
нить. В этой функции в качестве значение свойства ЗауеРо1щ заносится пере- 
менная МуЗауеРо1тё. Как ясно из уже проведенного обсуждения кода, эта пе- 
ременная хранит или начальное состояние набора данных, или состояние по- 
сле последнего сохранения в базе данных. Тем самым отменяются все резуль- 
таты редактирования, произведенного после запоминания значения МузЗауе- 
Рошф+. Описанной ранее переменной Мо4Ше4 присваивается значение #а[5е, 
свидетельствующее об отсутствии в наборе данных несохраненных изменений. 

Функция ВВеЁгез СЦсК является обработчиком щелчка на кнопке Обно- 
вить. Поскольку обновление отображаемых данных сопряжено с возможностью 
потери несохраненных результатов редактирования, то сначала проверяется 
знчение переменной Мод Шеа. Если оно равно фгие, то пользователю предлага- 
ется запрос о сохранении данных, который уже был рассмотрен при описании 
функции ЕогтСозебоиегу и окно которого показан на рис. 11.8. Если пользо- 
ватель щелкнет в нем на кнопке Да, соглашаясь с необходимостью сохранить 
изменения, изменения сохраняются описанным ранее методом Арр1уОрдафёе$, 
после чего данные будут обновлены. Если пользователь щелкнет на кнопке От- 
мена или нажмет клавишу Е5с, то выполнение функции завершается и обнов- 
леня данных не произойдет. А если пользователь щелкнет на кнопке Нет, ре- 
зультаты редактирования отменятся методом Сапсе Ордафе$, после чего вы- 
полнение функции продолжится. 

Для обновления данных можно использовать метод Ве#гезВ, обеспечиваю- 
щий пересылку записей из базы данных, т.е. отображение в клиентском набо- 
ре текущего состояния таблицы базы данных. Соответствующий оператор при- 
веден в коде, но закомментирован, так как более надежным является последо- 
вательное применение методов набора данных С10о$е и Ореп. 

Функция ОВСг191КеуРге$$ является обработчиком события ОпКеуРге5$ 
компонента ОВСг1а1. Назначение этой процедуры — разрешить пользовате- 
лю редактировать значение отдела, в котором работает сотрудник, и редакти- 
ровать пол сотрудника, только выбирая значения из выпадающих списков. 
В разд. 11.3.1 говорилось, что в первой и пятой колонках компонента 
0ВСг1а1 введены выпадающие списки значений. Но надо запретить пользо- 
вателю что-то писать в ячейках этих колонок. Эту функцию выполняет про- 
цедура ОВСг!191КеуРгез$5. Если пользователь редактирует ячейку в одной из 
этих колонок (0ВСг191->Зеесфе Шт4ех = 0 или 5), то все вводимые пользо- 
вателем символы заменяются нулевым символом. Так что текст в ячейке 
не изменяется. 
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Функция СНепДаёа5е1Са1сЕ1е14$ является обработчиком события Оп- 
Са1еР1е! 45. В этой функции устанавливается значение поля Абе — введенного 
в разд. 11.3.1 вычисляемого поля, отображающего возраст сотрудника. При 
расчете используется функция УеагОР, возвращающая год, извлеченный из 
текущей даты, определенной функцией Рае. Ради функции УеагОЁ, описан- 
ной в модуле Дае0113, этот модуль включен директивой шее, начинаю- 
щей рассматриваемый код. Впрочем, функция УеагОЁР и файл Дае0ИИ{$ име- 
ются только начиная с С++Ва!Паег 6. Если вы работаете с более ранними вер- 
сиями С++ВиАаег, расчет возраста надо оформить иначе: 

Мог Уеаг, МопЕП, Пау; 


Ресоаера*е (Рак е(), Уеаг, МопЪ®П, Вау); 
С11епРафабее1Аде->\Уа1ие = Уеаг - С11еп Пафа5её1Уеаг Ю->Уа1ае; 


Функция Еа&1СВапфёе является обработчиком события ОпСВапее окна ре- 
дактирования ЕЧЁ1. Этот обработчик перемещает методом Е.0сже курсор на за- 
пись, в которой первые символы фамилии (поля Кат) совпадают с символами, 
введенными в ЕЧИ1. 

Ряд фрагментов приведенного кода использует блоки фгу ... сафев. Это все- 
гда желательно делать, так как связь с удаленным сервером может по тем или 
иным причинам прерваться. И в подобных случаях приложение должно изве- 
щать об этом пользователя. 

Можете выполнить ваше приложение и опробовать его в работе. Если вам 
надоест во время тестирования вводить каждый раз имя пользователя и па- 
роль, задайте Ёа]5е в свойстве 1.051тРготрё компонента ОСОМСоппесйоп1 
и уберите в форме ссылку на обработчик события Оп5Во\у. 

Чтобы почувствовать возможность параллельной работы нескольких кли- 
ентов, можно запустить средствами \У/ш4о\з несколько экземпляров прило- 
жения. Если сервер расположен на том же компьютере, вы увидите, что он вы- 
полняется до тех пор, пока выполняется хотя бы одно клиентское приложе- 
ние. Вы сможете также проверить выполнение обновления данных и иные ре- 
жимы работы. 


11.3.3 Обработка ошибок 


При работе с удаленным модулем данных могут возникать различные 
ошибки. Одна группа ошибок связана с заданием значений, не удовлетворяю- 
щих заложенным в базе данных ограничениям. Например, в таблице Рег зало- 
жено ограничение на год рождения: 1917-2000. Так что если вы введете в ка- 
кой-то из записей год рождения, выходящий за эти пределы, возникнет ошиб- 
ка при попытке занести такую запись в базу данных (при щелчке на кнопке 
В базу данных). Это обычные ошибки, не связанные со спецификой приложе- 
ний, работающих со многими клиентами. Но при параллельной работе не- 
скольких клиентов с одной и той же таблицей базы данных могут возникать 
также ошибки иного рода. | 

Два клиента могут работать с одной и той же записью и по-разному ис- 
правлять в ней одно и то же поле. Если, как в нашем сервере приложении, опо- 
знавание записи ведется только по ключевому неизменяемому полю (в компо- 
ненте ВаёаЗе{ Ргоу14ег свойство ОрдаёеМоде равно ипр\’БегеКеуОдщуУ), это не 
вызовет ошибки. Просто в базу данных занесутся значения того клиента, кото- 
рый переслал их в базу последним. Но если опознание ведется, например, по 
всем полям, то такая ситуация будет расценена как ошибочная. В любом слу- 
чае появится ошибка, если один клиент редактирует запись, а другой клиент 
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в это время удалил эту запись из базы данных. Тогда в момент занесения пер- 
вым клиентом своих изменений в базу данных запись просто не будет найдена, 
так как она уже удалена. 

Если условия работы с базой данных таковы, что подобные ошибки воз- 
можны, необходимо принять меры для разрешения возможных конфликтов. 
Проще всего это делать в обработчике события ОпВесопсИеЕггог клиентского 
набора данных СНепОафа$ её 1. Событие ОпВесопсПеЕггог наступает при не- 
обходимости принятия решения относительно записи, вызвавшей ошибку при 
обновлении базы данных. События ОпВесопсЦеЕггог генерируются методом 
Весопе!е, который, в свою очередь, вызывается методом Арр!уОр9дафез, зано- 
сящим изменения в базу данных. Если обнаруживаются записи, вызывающие 
ошибки при занесении их в базу данных, то для каждой такой записи генери- 
руется соответствующее событие. 

Заголовок обработчика события ОпВесопсЦеЕггог имеет вид: 

у01А __Еаз®са11 ТГогп1 : :С11еп Рафабе*1Кесопс11еЕкгкгокг ( 


ТСазЕомС11еп  Рабазее *рРафабЗеф, ЕВКесопс11еЕггог *Е, 
ТОрадафеК1па ОрааЕеК1па, ТВКесопс11еАсе1оп &Асфе1оп) 


Параметр ВабаЗеё — это тот клиентский набор данных, записи которого 
вызвали ошибку. Если в приложении имеются связанные друг с другом набо- 
ры данных, и ошибка произошла во вспомогательном наборе данных, то 
Лафа5еф указывает этот набор, хотя событие генерируется для головного набо- 
ра данных. При обработке события можно использовать для разрешения кон- 
фликта такие свойства набора данных Вафа еф, как свойства полей МемУаШше, 
04Уаше, СигУаШе. Однако в обработчике событий нельзя изменять текущую 
запись Раёа5еф, применяя методы навигации (№ехё, Рог и т.п.). 

Параметр Е является указателем на объект типа ЕВесопе!еЕггог. Он со- 
держит информацию, которую можно использовать при обработке ошибки. 
Основные свойства объекта типа ЕВесопсПеЕггог: 


—. еее — —=- 
Свойство Тип ‚ Пояснение й 


у —- -— —_ —_ — О ОИ а ее _——щ — —— 


ЕггогСое_ | У ота ` Код ошибки, возвращаемый ВЕ, АО, `аБЕхргевз 
‹ или иными технологиями 


——_-- — - — р де. 4 аа. р —— 


| 
Рге\1оизЕггог М ога _ Код предыдущей ошибки в процессе их х обработки | 
(если ошибки не было — 0) 


ы—Ш——— ——— ИИ 


Сощехё Ап -ше  "Текот дополнительной информации (может ‘быть 
| | Мот) _ 


ЕЕ оо ди д Ета ЕЛЕ Ели ИР ТР а па Што опрЕ ро СЕ Е ПОЕТ ЕЕ. ЕЕ ы ЕЕ И 


Параметр обработчика ОрдаёфеКт4 указывает тип операции, вызвавшей 
ошибку: икКМодМу — изменение записи, аКТа$еге — вставка, иКОеее — уда- 
ление. 


В параметр АсЙоп надо занести. результат обработки ошибки: 


| - 
Пропустить обработку данной записи, т.е. оставить ее в списке | 


| незавершенных исправлений. 
— __— ООН 
гаАрбог& 
——- 


 Прервать все операции обработки ошибок. | 


-—-— = —-—+ 


гаМегге ‹ Объединить изменяемую запись с записями сервера (фактиче- 


_|ски,. добавить данную запись как новую). 
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Г Е о ЕЕ ЕЕ ИЕ ПЕН ЕЕ Л лот ЕЕ >= = ЕЕ 


гаСоггесь Заменить текущую  обновляемую запись записью, сформирован- 
| ной в обработчике события (это случай, когда вы можете испра- 
| ‘вить ошибку). 


гаСапсе] Отменить все исправления данной записи, вернувшись к перво- 
начальным значениям всех ее полей. 


ОНУ —- - рии Аи _ НВ 


гаВейгезЬ Отменить все исправления данной записи и заменить запись 
_| той, ‚которая хранится на сервере. 


= —-= р 


| 
| 
| 
| 
| 
| 
| 
| 
| 


1 
| 
р 


В обработчике события ОпВесопеПеЕггог надо предоставить пользователю 
всю доступную информацию о возникшей проблеме и дать возможность при- 
нять решение. Например, пользователь может изменить значение МемУаШше со- 
ответствующего поля набора ВаёаЗе{ (то значение, которое вызвало ошибку) 
и задать АеЙоп = гаСоггес+. В этом случае будет сделана попытка занести в базу 
данных исправленный вариант записи. Пользователь может выбрать Аейоп = 
гаВеЁ?гезВ, т.е. отказаться от сделанных исправлений и согласиться на ту за- 
пись, которая находится в данный момент в базе данных. Он может также вы- 
брать АсЯоп = гаСапсе], т.е. отказаться от сделанных исправлений и принять 
те значения полей, которые были перед началом редактирования. Наконец, 
пользователь может отказаться временно от принятия решения (АсЯоп = 
газк1р или гаАБог{) и продолжить работу по редактированию записей. 

Ниже приведен пример фрагмента обработчика события ОпВесопе!е- 
Еггог, в котором пользователю сообщается информация о возникшей пробле- 
ме. Информация заносится в окно Мето1. 

у01Я _ ЕазЕса11 ТРоги1 : :С11епРаса$ее1Весопс11еЕгкохг ( 


ТСизсомС11епЕРафа$ее *Рафбабее, ЕВесопс11еЕггог *Е, 
ТОраафеК1па ОрдаееК1па, ТВесопс11еАсе1оп &АсЕ1оп) 


Мепо1->С1еах(); 


Мепто1->11пез->Ааа ("Код ошибки: " + ТпЕТобег (Е->ЕггогСоае) ); 

Мето1->Ъ1пез->Ааа ("Прежний код: " + 
ТрЕТобЕк (Е ->Ргеузойо$Еггог)); 

Мепо1->1пе5->Ааа ("Сообщение: " + Е->Меззаде); 


1Е(Е->СопеехЕе != "") 
Мепо1->1пез->Ааа (Е->Сопфех®); 
Апз15ег1па $5 = "Операция: "; 
$и16еср (ОрдафеК1па) 

{ 


сазе ичКМоа1Еу:*$ = $ + "изменение записи"; 
Ьгеак; 

сазе аКТпзеге: 5 = $ + "вставка"; 
ЬгеаКк; 

сазе аКре1ефзе: $5 = $ + "удаление"; 


} 
Мепо1->1пез->Ааа (5); 
1Е (ОрааееК1па == аКМоа1Еу) 
Рог (10Е 1=0; 1 < Пабабее->Е1ле1аСоцп®; 1++) 


{ 


1Е ((БабабеЕе->Е1е1а$->Е1е1а$ [1] ->Е1е1АКлра != ЕКБаба) || 
УагтзЕтреу (Ратазет- >Е1е1а$->Е1е1а$ [1] ->Мем\Уа19ае)) 
сопе1пие; 


Мепо1->11пез->Ааа (""); 
Мепо1->11пез->Ааа ("Поле " + 
РафбаЗе*->Е1е1а$->Р1е1а$ [11 ->Е1е1АМапе); 


Мепо1->11пез->Ааа ("Прежнее значение: " + 
УагТоЗеЕг (Рабабее->ЕГ1е1а$->Е1е1а$ [1] ->01аУа1ае)); 
Мепо1->1пез->Ааа ("Записываемое значение: " + 


УагТобег (Рабабе*->Е1е1а$->Е1е1а$ [1] ->МемУа1ае)); 
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1Е (! УагТзЕтшреу (Рабабе*->Е1е1а$->Е1е1а$ [1] ->СогУа1ае)) 
Мепо1->11пез$->Ааа ("Значение в БД: " + 
УагТоЗег (РабабеЕ->ЕГ1е1а$->Е1е1а$ [1] ->СагУа1ае)); 


} 


// Операторы запроса пользователя о дальнейших действиях 


‚7 


Первые операторы приведенного кода заносят в Мето1 коды ошибок, 
текст сообщения об ошибке и характер проводимой операции. Отметим, что 
типичные сообщения 0б ошибках желательно перевести на русский язык 
(в коде это не делается). Затем, в случае, если выполнялась операция модифи- 
кации записи, организуется цикл по всем полям записи. Для тех полей, кото- 
рые содержат измененные данные (тип поля #Оафа — данные, и имеется зна- 
чение М№емУаШше) дается информация обо всех значениях этого поля. 

Далее в обработчике должна быть предусмотрена возможность выбора 
пользователем дальнейших действий, как указано в описании события ОпВе- 
сопсПеЕггог. 

В обработчике события ОпВесопеПеЕггог может быть успешно использо- 
ван диалог Кесопсйе Етог Оюод, содержащийся в Депозитарии на странице 
Оаоа$ в версиях С-++Ви!Паег, предшествующих 2006, или на странице С++Виу|- 
дег Ргоесв | С++Вийдег Ейез в С++Ви!Паег 2006. Этот диалог предоставляет поль- 
зователю подробную информацию о возникшей проблеме и дает полную воз- 
можность принять решение. В клиентском приложении, рассмотренном в пре- 
дыдущих разделах, для обработки ошибок используется именно этот диалог. 
Выполните команду Не | Ме\ | О!ег и в окне Депозитария выберите требуемую 
пиктограмму. Сохраните новый модуль, включившийся в ваше приложение, 
под именем, например, (ВесопсИеЕггог. Введите ссылку на него в основном 
модуле: 


#1п0с1цае "ОВесопс11еЕггог. р" 


Создайте следующий обработчик события ОпВесопсПеЕггог компонента 
СПешОафа5е1: | 
у01А _ Еаз®са11 ТРГогм1 : :С11епРафабе*1Весопс11еЕггохг ( 
ТСизбомС]11еп Рафабее *ПРафабЗеЕ, ЕВесопс11еЕггог *Е, 


ТОраакеК1па ОраафекК1па, ТВесопс11еАсЕ1оп &Ас&1оп) 


{ 
Асстоп = Напа1еВесопс11еЕггог (101$, ПБабабее, ОраафеК1па, Е); 


} 


Обработчик содержит всего один оператор, вызывающий функцию отобра- 
жения диалога и задающий возвращаемое ею значение параметру АсЙоп. 

Проверьте работу диалога на какой-нибудь ошибочной ситуации. Напри- 
мер, запустите средствами Уш@Чомз два клиентских приложения, введите 
в одном из них новую запись и перешлите ее в базу данных. Обновите набор 
данных в другом клиентском приложении. Теперь удалите эту запись с помо- 
щью первого клиента. А во втором приложении измените что-то в этой записи 
(например, отдел) и попробуйте направить измененную запись в базу данных. 
При этом возникнет ошибка, поскольку записи в базе данных уже нет. Перед 
вами появится диалоговое окно, показанное на рис. 11.9 а. 

Вид этого окна несколько изменяется в зависимости от того, какого типа 
ошибка произошла. На рисунке показан вид окна при описанной выше ошиб- 
ке. В случае, например, задания недопустимого значения года рождения, окно 
несколько изменится. В диалоговом окне пользователь может увидеть суть 
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возникшего конфликта, отредактировать конфликтующие данные и принять 
решение. 


Рис. 11.9 а) Ордаее Еггог - 
Окно диалога, рые Туре: Мофбед 
регулирующего Епог Меззаде: 
`‹ конфликтные 
ситуации: 


а — оригинальный 
вариант, 6 — частично 
русифицированный 


Глебов 
Глеб 


Глебович 


190 В : 


Тип операции Изменение о” | | [`Действие——^— 


Сообщение об ошибке | —- . (* Пропустить 
С Отменить 


ГС Исправить 
оС Обновить 
Ес Объединить 


ИА =————---щ 


В 
! 
| 
1 
} 
й 
я 
| 


Цех 2 
Глебов 
Глеб 


Глебович 


1980 >| | 


| Только конфликтующие поля Г”. Только измененные поля [Выютиь] _0 тменить | 


Недостатком окна, показанного на рис. 11.9 а являются английские тек- 
сты. Диалог желательно русифицировать. Для этого достаточно перевести над- 
писи меток на форме и определить следующим образом глобальные констан- 
ты, содержащиеся в модуле диалога ИКесопсЦеЕттог.срр: 


сраг *Асф1оп5ег[] = {"Пропустить", "Прервать", "Объединить", 
"Исправить", "Отменить", "Обновить"}; 

спаг *Ораа$еКлпа$ег[] = {"Изменение", "Вставка", "Удаление" }; 

спаг *5Сар®1оп = "Ошибка - "; 

србаг "ЗОпсвапаеа, = "<Не изменено>"; 

спаг *5В1пагу = "(двоичное)" 

сраг *5Е1е]АМаме = "Имя поля"; 

свВаг *$50г1491па1 = "Начальное значение"; 

срахг *$5СопЕ11СсЕ = "Конфликтное значение"; 

сраг *5\Уа1ае = " Значение"; 

сраг *5Морафа = "<Нет данных>"; 


сраг *5Мем = "Новое"; 


916 Глава 11. Работа с удаленными модулями данных 


После подобных изменений диалог примет вид, показанный на рис. 11.9 6. 
Для полной его русификации надо еще перевести надписи об ошибках, появ- 
ляющиеся в окне сообщений (на рис. 11.9 это текст: “Весог по%ф #оип4 ог 
спапее4 Бу апо ег изег” — "Запись не найдена или изменена другим пользо- 
вателем”). Я не стал этого делать, чтобы не усложнять пример второстепенны- 
ми деталями. 


11.4 Обмен данными между клиентом и сервером 


Сервер, созданный нами в разд. 11.1 и клиент, созданный в разд. 11.3, об- 
мениваются только данными таблицы. Посмотрим теперь, как можно организо- 
вать обмен между ними иной информацией. Давайте предположим, что за рабо- 
той сервера хочет иметь возможность наблюдать какой-то администратор. При 
этом ему хочется знать некоторые характеристики процесса работы с базой дан- 
ных: число клиентов, работающих в данный момент с сервером, число обрабо- 
танных запросов ЭОГ, последний момент времени, в который кто-то из клиен- 
тов изменил данные в базе. Кроме того, мы хотим, чтобы пользователь, рабо- 
тающий с клиентским приложением, получал информацию о том, когда в по- 
следний раз каким-то клиентом были произведены изменения в базе данных, и 
когда он сам получил в последний раз данные из базы. Иначе говоря, мы хотим, 
чтобы в клиентском приложении отображалась информация, которую вы види- 
те внизу на рис. 11.5. Тогда клиент может увидеть, что он работает с уже уста- 
ревшими данными, и, если ему требуется, может получить последнюю версию 
данных. А немного позднее (в разд. 11.5) мы захотим, чтобы клиент мог еще и 
передавать на сервер фильтр, для отбора интересующих его записей. 

Давайте сначала доработаем сервер, обеспечив на нем отображение требуе- 
мых характеристик. Добавьте на сервер метки, в которых будут отражаться ис- 
комые данные (рис. 11.10). Для этого поместите на форму метки, отображаю- 
щие тексты “Клиентов:", “"Запросов:", "Изменено:”. А рядом с ними поместите 
метки, в которых программно будут отображаться соответствующие значения 
(для дальнейшего предположим, что их имена Габе!1, Габе]2, ГаБе!З). 


Рис. 11.10 [-: удаленный моду 
Окно сервера с отображением характеристик 
работы с базой данных Клиентов: 2 


Запросов: 6 
Изменено: 09.03.2006 18-03:04 


Переменные, которые будут хранить отображаемые значения, объявим 
в классе формы: 


с1аз5$ ТЁГогм]1 : раб11с ТЕогм 
{ 
ручЮ11с: 
1пЕ №11епе, МОчегу; 
ТрасеТ1пе Т; 
}; 
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Переменные МСПепф и М№Очегу будут хранить соответственно число клиентов и 
число запросов к базе данных, а переменная Т будет хранить время последнего 
изменения данных. 

Дата последнего обновления данных может относиться не к текущему, 
а к какому-то из предыдущих сеансов работы сервера. Поэтому ее целесообраз- 
но запоминать в файле при закрытии сервера и читать при его открытии. То- 
гда обработчики событий ОпСгезфе и ОпС]озе формы можно сделать такими: 


// следующая директива нужна только в С++Ви1]1аег 2006 
#1п0с10о4е <5ЕА1о.В> 


уо1а __ЁЕа$еса1] ТЕогш1::ЕогиСгеафе (ТОБ]есе *5епаег) 


{ 
1Е( Е1]1еЕх156$ ("Т1тме.Заф")) 


{ 


ЕТЬЕ *Е = Еореп("Т1ие.Ча®", "гр"); 
Егеаа (&Т, з17е90Е (ТРафеТ1пе),1,Е); 


Ес1о$е (Е); 
е1зе Т = М№м(); 
Таре13->СарЕ1оп "0"; 
Таре14->Саре1оп = "0"; 
Таре15->Саре1оп РафеТ1тмеТоЗ ег (Т); 


у01Аа __ЕазЕса11 ТЕогм1:; : ЕогмС1озе (ТОр)]есе *5епаег, 
ТС1озеАсЕ1оп &Асет1оп) 


ЕТЬЕ *Е = Еореп("Т1те.Чае", "мр"); 
Емг1 ее (&Т, з17е0Е (ТРафеТ1пе},1,Е); 
Ес1озе (Е); 


} 


При работе в С++ВиИаег 2006 компилятор не поймет содержащихся 
в коде объявлений файловых переменных Е, если не подключить вручную 
к модулю директиву, ссылающуюся на файл 0.1. В предшествующих вер- 
сиях С++ВиИа4ег эта директива не требуется. 

В приведенном коде в обработчике РЕогтСгеафе сначала функцией 
ЕПеЕх!${$ проверяется, имеется ли в текущем каталоге файл с именем 
Ттпе.да. Если имеется, то в переменную Т читается записанное в файле значе- 
ние. А если файла Типе.аат нет, то в качестве Т заносится текущее время. 
Впрочем, такое может произойти только при самом первом сеансе работы сер- 
вера, так как по окончании работы сервера в обработчике ЕогтС]о5е файл соз- 
дается и в нем запоминается значение Т. 

Теперь надо обеспечить вычисление значений введенных нами перемен- 
ных МСЦепф, МОиегу и Т. Для этого надо использовать события модуля дан- 
ных, имеющегося в сервере. Перейдите в этот модуль, и вы увидите, что его 
объект имеет два события: ОпСгеафе при создании модуля и ОпОе$%4гоу при за- 
вершении его выполнения. Эти события можно использовать для учета числа 
связанных с сервером клиентов, поскольку подключение к серверу нового 
клиента вызовет событие модуля ОпСгезфе, а отключение клиента вызовет со- 
бытие модуля ОпОе$ёгоу. Так что добавьте в модуль обработчики этих собы- 
тий: 


#1пс10ае "ОтуВМО.В" 


У01А _ Еаз®са11 Тс1МУВМО: : СВетосерааМода1еСгеаее (ТОр)]ес® *5епаег) 
{ 


ГКоги1->М№С11еп++; 
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РГоги1->Таре13->СарЕ1оп = ТпЕТобег (Коги1->№С11еп®); 


\у01А __Еаз®са11 Тс1МУуВМО: ; СВетмокера®аМоаи1ерезегоу (ТОБ]ес® *5епаек) 


{ 
Рогм1->№С11епе-; 
Гоги1->Габе13->СарЕ1оп = ТпЕТобехг (Еогм1->М№С11еп®); 


} 


Вряд ли этот код нуждается в пояснениях. В нем включается директива, 
ссылающаяся на модуль главной формы сервера, изменяется соответствую- 
щим образом значение переменной МСЦЙепф, и результат отображается в метке 
главной формы. 

Остальные переменные М№@пегу и Т можно вычислять с помощью событий 
наборов данных Та е1 и Та Ше2. Число запросов 5 можно подсчитывать 
в общем для обоих наборов обработчике событий АЁйегОреп: 


У01А __Еазеса11 Тс1Мувмр2006: :Тар1е1АЕфегОреп (ТРафабее *Рафабеф) 


{ 

Гоги] ->МОцегку++; 

Коги1->Гаре14->Сар®1оп = ТпЕТо5зехг (Гогт1->МОчцегу); 
} 


Момент обновления данных в базе данных можно запоминать в общем об- 
работчике событий ОпОрдафеВесог4 обоих наборов: 
у01А _ ЁЕазса11 Тс1МУВМр: :;Таф1е1ОрааееВесога (ТРаба5еф *Рафабеф, 
ТОраафеКкК1па Ораа*еК1пта, ТИрааееАс®1оп &ОрафеАс&1оп) 


{ 
Когш1->Т = Мом (); 
Гоги] ->Гаре15->СарЕ1оп = РакеТ1меТоЗ ег (Роги1->Т); 


} 


Теперь надо обеспечить передачу запрошенных данных от сервера к кли- 
енту. Клиентское приложение посылает запрос серверу с помощью своего ме- 
тода ОаёаВедие$. В качестве аргумента в этот метод может передаваться стро- 
ка запроса. Вызов метода ВаёаКедиез клиентского набора автоматически 
приводит к генерации события ОпОафаВецие$6 провайдера в удаленном моду- 
ле данных. Заголовок обработчика этого события имеет вид: 


О1еУаг1апЕ __ ЁЕаз®са11 Тс1МувмЬ: : О5РРегзРафаКеачез* (ТОр]есЕ *бепаег, 
О1еУаг1апЕ &Тпруф) 


Параметр Эеп4ег — это указатель на объект провайдера. Параметр три — 

это значение, переданное клиентским приложением при вызове в нем метода 
ОПаёаКедие$$. Тип этого параметра О]еУатапф. Так что в обработчик могут по- 
ступать любые данные, которые допускают приведение к типу ФеУатап+. Об- 
работчик события должен вернуть данные типа О]еУатапф. В клиентском 
‘приложении эти данные воспримутся как возвращаемые методом ОаёаВе- 
4иез$. 
Поскольку мы решили, что на сервер могут передаваться запросы двух ви- 
дов: запрос момента последнего обновления данных и запрос данных таблицы, 
удовлетворяющих некоторому фильтру, надо договориться о простейшем про- 
токоле обмена. Предположим, что полученная сервером строка текста "За- 
прос” означает запрос времени. А любая другая строка — это фильтр, который 
нужно применить к набору данных. Тогда обработчик событий ОпОафаВе- 
ие провайдеров ОЗРРег5 и ОЗРО,)ер может иметь вид: 

О1еУаг1апЕ __Ёазеса11 Тс1МУувМмр: : О5РРегзрРафаВеаие${ (ТОБ]есЕ *бепаег, 


О1е\Уаг1ап® &Тпраф) 
{ 
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Е ((Апз1$ег1п9) Тприе == "Запрос") 
гебигп РБабеТт1меТтобеЕхт (Гогм1->Т); 
е1 зе 


{ 
((ТрРабабееРгоу1Аег *) бепаехг) ->Рафазее->С1оз$е (); 
((ТРабаЗееРгоу1Аег *)бепаег) ->Рафа5бее->Е1]1кег = (Ап$15ег1па)Тпроае; 
((ТРабабееРгоу1аАет *)}бепаег) ->Рафабее->Е11Ееге = гие; 
((ТРабазееРгоу1аег *) бепаег) ->Рафабе*->Ореп (); 
((ТРабабееРгоу1Аег *)бепаег) ->Рафабее->Е1г$® (); 
текигп ((ТРафабесРгоу1Аег *) беп4ег) ->Рафа; 


} 
} 


Если в обработчик поступила строка “Запрос”, то клиенту возвращается 
значение момента времени Т, преобразованное в строку функцией БафёеТ1- 
теТо5{:г. А при любом другом значении шрий полученный фильтр присваива- 
ется свойству Е\ег набора данных, связанного с провайдером. Затем свойство 
Е1Щеге4 устанавливается в фгае, чтобы новый фильтр был применен к данным, 
набор данных методом Е11`5$% переводится на первую запись, и функция возвра- 
щает отфильтрованные данные, находящиеся в свойстве афа набора данных. 

В приведенном коде обращение к набору данных осуществляется через 
свойство Вабёаеё провайдера. Поэтому обработчик события может быть об- 
щим для обоих провайдеров: ОЗРРег5 и ОЗРОер. 

Как видим, обработчик события ОпраёаВецие$& может возвращать совер- 
шенно разнородные данные: строку текста и множество записей. 

Проведите указанные доработки вашего сервера, сохраните его и откомпи- 
лируйте. Сервер не требуется повторно регистрировать, так как мы уже заре- 
гистрировали его в системе, когда создавали в разд. 11.1. 


Теперь можно доработать клиентское приложение. Это сделать достаточно 
легко. Добавьте на форму приложения, разработанного в разд. 11.3, две метки 
с текстами "Время последнего изменения в базе данных:" и “Время последнего 
обновления из базы данных:", как показано на рис. 11.5. Имена этих меток 
в последующем коде — Гафе! и ГаБе14. 

Для отображения в метке ГаБе!4 момента последнего получения данных 
из базы в обработчик события ОпСгезжфе формы и в обработчик щелчка на кноп- 
ке Обновить надо вставить операторы: 


Таре14->Сар®1оп = "Время последнего обновления из базы данных: " + 
ПРасеТ1теТо$ех (Мом ()); 


Они заносят в метку текущее время, полученное функцией Мом. 

В отношении запроса к серверу относительно момента последних измене- 
ний в базе данных надо решить, когда мы хотим его посылать. Можно ввести в 
приложение отдельную кнопку, при щелчке на которой будет посылаться со- 
ответствующий запрос серверу. А можно ввести в приложение таймер, кото- 
рый с определенной периодичностью будет посылать запросы серверу. Тогда 
информация в клиентское приложение будет поступать автоматически. 

Если вас устраивает второй вариант, надо перенести в форму клиентского 
приложения таймер Типег со страницы библиотеки оует. Его свойство 
Епае4 надо установить в #а]5е, чтобы при запуске приложения, пока пользо- 
ватель вводит свой пароль, запросы серверу не посылались. В свойстве 
Пфегуа| надо задать период, с которым будут посылаться запросы серверу. Ин- 
тервал задается в миллисекундах, так что, например, значение 1000 — это 
1 секунда. Конечно, в реальном приложении не стоит связываться с сервером 
так часто. Но для нашего тестового приложения это, пожалуй, допустимо. 
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Активизировать таймер можно после того, как проверен пароль пользова- 
теля. Так что это можно делать в обработчике события ОпТ.ойш компонента 
ОСОМСоппесйоп1, или в обработчике события ОпЗВо\/ формы. Активизация 
осуществляется оператором: 


Т1иег1->Епаб1еа = +гае; 


А обработчик событий ОпТ!ипег таймера может иметь вид: 


Уу01А _ Еаз®са11 ТРГогм1: :Т1мег1Т1мег (ТОБ)]есЕ *5епаег) 


{ 
гу 
{ 
Таре13->Сар®1оп = "Время последнего изменения в базе данных: " + 
(Ап$156к1па) (С11епРакабе%к1 ->РафаВеачезе ( (Апз15Ег1па) "Запрос")); 


} 
саесп(...) 


{ 


Тафе13->СарЕ1оп = "Не удается связаться с сервером"; 
} 

} 

Единственный оператор блока фгу вызывает метод ЭааВедцие$ клиентско- 
го набора данных СПеп(Оафа$е 1. В качестве аргумента в вызов передается 
строка “Запрос”, приведенная явным образом к типу Ап ичше. На сервере 
в ответ на такой запрос мы предусмотрели возврат строки, содержащей дату. 
Эта строка в клиентском приложении возвращается как результат вызова мето- 
да ОааКецие$. Результат явным образом приводится к типу Ап Ито и за- 
носится в метку ГаБе!3. 

Раздел сафеВ в приведенном коде совершенно необходим, так как если по 
каким-то причинам связь с сервером нарушится, то пользователь с интерва- 
лом в 1 секунду будет получать сообщения об ошибке и не сможет из-за них 
даже закрыть свое приложение. 

Преобразование нашего серверного и клиентского приложения завершено. 
Можете испытать их в работе. Лучше всего это сделать, запустив средствами 
У/1тао\з$ несколько экземпляров клиентских приложений и проверив их сов- 
местную работу. 
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Клиентские наборы данных СПеп( Оаёа5е{ обладают расширенными воз- 
можностями фильтрации записей. Сама фильтрация в них осуществляется 
так же, как в иных наборах данных, с помощью свойств Е ег, ЕЩегед 
и Е№егОрНоп$. Свойство Е\егей включает или выключает использование 
фильтра. А сам фильтр записывается в свойство ЕЩег в виде строки, содер- 
жащей определенные ограничения на значения полей. Все это подробно рас- 
смотрено в источниках [1], [3], [4], [5]. Но в клиентских наборах свойство 
ЕШег поддерживает множество операций и функций, недоступных, напри- 
мер, в таком традиционном наборе данных, как Та Ше и в локальных табли- 
цах (Рагадох, АВАЗЕ, Ассезз, ГохРго). В частности, поддерживается сравне- 
ние полей (например: "Е1е!а1 > Е1е1а2”), а также следующие операции: 
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Операция, Пример 


‚ функция 


18 МЫ, Пер 13 МОМ, | 
13 МОТ МОМ, |Бер [$ МОТ МО, ОВ 
+ Уеаг Ь +5 > 1970 для чисел, строк, дат (времени) + 
число 

— 2002 — Уеаг_Ъ <> 19 для чисел, дат, дат (времени) — 


число 


| ае11 * 100 > 20 
|1 Езе11 > ле? / 5 
'Оррег Оррег(Оер) = ‘ЦЕХ 1' 


Го\мег Гомег(Гат + Мат) = ‘ива- 
| новиван` 


Зибзигшя 3и6${гт&(Оер,5) = '1° подстрока, начиная с 5-го символа 
Зибзитя(Оер,1,3) = 'Цех’ |Подстрока с 1-го по 3-ий символ 
7? (могут быть проблемы с кирилли- 
цей) 


("Теши 'Тгио(Еаш + Маш) удаляет пробелы 
| Теа (Е1еа1, `—°) удаляет символы '—’в начале 


и конце строки 


Тена е#% | ТгипБе (ит 19а) 
Тенотеачеа1, '$°) <>" 


Тео — |ТеоваетиЗытееа) 
‘Теавевиеа1, '..) <> " 


`Уваг УТеаг(Раце Ее!) — 2000 


| Мо `| Мот (Оа%еЕ1е!а) <> 12 выделяет месяц 

Лау Пау(ОафеЕ1е]9а) = 1 выделяет день 

| Ноиг — Ноии(равенеа) < 16 выделяет час 

Мшие. Мшие(Оже е!а) = 0 выделяет минуту | 
_Зесо@ | Зесопа (рае) = 30 
`етаю — [бы  разтьм > 7 


‚рав раде = Разе(бей ние) 
Те |ТипеРа > Тыпе(бейра) 


ГлКе | Мешо ЫКЕ '% ИЦцегз% при применении к полям ВГОВ, 
свойство ЕегОрНоп$ определяет 
чувствительность к регистру 


т 6 
"2 Гап ш (`Иванов’,'Сидоров’) | отберет всех Ивановых и Сидоро- 
вых (второй операнд — список от- 
бираемых значений) 


ООН ОО 


Все эти возможности можно использовать при просмотре данных, содер- 
жащихся в клиентском наборе. Но при работе с удаленными базами данных 
часто возникает иная задача — фильтрация данных, поступающих с сервера. 
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Дело в том, что база данных может быть очень большая, и неразумно перека- 
чивать всю ее в копию на компьютер клиента, если реально требуется только 
некоторое подмножество записей. 

В разд. 11.4 уже говорилось, что с помощью метода ВаёаВецие$ можно 
послать серверу любой запрос. В частности, можно послать строку требуемого 
фильтра. В сервере мы уже ввели обработку подобного запроса. Так что оста- 
лось только реализовать отправку запроса из клиентского приложения. 

Фильтрация на сервере отличается от той, которая осуществляется свойст- 
вами ЕщЩег и Е\Щеге4 клиентского набора данных. Она обеспечивает получе- 
ние клиентом только тех записей, которые удовлетворяют фильтру. А свойст- 
ва Еег и ЕЩегеЯ могут осуществлять только фильтрацию записей, уже 
имеющихся в наборе. Так что если применена описанная выше фильтрация, то 
ЕЩег и ЕЩегед смогут осуществить только дополнительную фильтрацию пе- 
реданных в набор записей. 

Давайте создадим тестовое клиентское приложение, обеспечивающее 
двухэтапную фильтрацию данных. Можно было бы, конечно, взять за основу 
приложение, созданное в предыдущих разделах. Но чтобы более наглядно 
представить вопросы фильтрации, создадим новое, более простое приложение. 
Вид окна этого приложения показан на рис. 11.11 (проект СПетЕИег в группе 
проектов РаМу МР в каталоге Даа МоашЕез на диске, приложенном к кни- 
ге). Окно содержит два индикатора СвВесКВох1 и СвесКВох2, и два окна редак- 
тирования ЕЯ] и ЕаЦ2. Б верхнем окне ЕЯЁ1 пользователь может записать 
фильтр, который будет отбирать передаваемые с сервера записи. А в нижнее 
окно можно записывать фильтр, который на локальном наборе данных обеспе- 
чит дополнительную фильтрацию. Индикаторы включают и выключают при- 
менение того или иного фильтра. 


Рис. 11.11 {1 Фильтрация удаленных данных х. 


Клиентское приложение [(Оер = Цех“) ап (Теаг_Ь > 1960] 
с фильтрациеи | 
Г” Внутренний Фияьтр — [бех = ‘'ж 


[Отдел [Фамилия [Имя __ [Отчество  [гр. [Пол[Возраст| < 
Иванова Ирина Ивановна 1961 ж 
Павлов Павел Павлович 1975 м 
Иванников = Иван Иванович 1975 м 


Харитонов Харитон Харитонович 1962 м 


Чтобы построить такое клиентское приложение, надо поместить на форму 
компоненты СПепОафа5 её, ОжаЗопгсе, ДафаЗе Ргоу!14ег, ОСОМСоппесй оп, 
СПепОафа5 её, ОВСг9, и связать их друг с другом обычным образом: 
ОСОМСоппесНоп1 ссылается своим свойством ЗегуегМаше на удаленный сер- 
вер; СПеп{Оаф{а5е{1 ссылается свойством ВетофеЗегуег на ОСОМСоппесй оп 1 
и свойством Ргоу1ЧегМате на ОЗРРег$; ОаёаЗоигсе{ ссылается свойством 
Оаёа5её на СПешафа$ её 1; ОВСг1а1 ссылается свойством ОВафабоигсе на 
РаёаЗоигсе1. 
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Помимо этих связанных с данными компонентов на форме размещаются 


у01А _ Еаз®са11 ТЕГогм]1: : ЕогиСгеа®е (ТОБ)]есЕ *5епаег) 
{ 

гу 

{ 

С11епЕРафабеф1->Ореп (); 

} 

саесВ (...) 

{ 


ЗРромМеззасде ("Нет соединения с сервером"); 


у0о14 _ Еаз®са11 ТКГогм1: : ЕогиС1озе (ТОБ]ес® *5епаег, 
ТС]1озедАсЕ1оп &Асе1оп) 


гу 


С11епЕПафабе*1->С1озе (); 
} 

саёси (...) 

{ 


ЗпомМеззаде ("Нет соединения с сервером"); 


у01А _ Еаз®са11 ТЕоги1 : :СпескКВох1С11сКк (ТОБ)есе *5епаехг) 
{ 
Ап5156г1па 5; 
1Е (СрескВох1->Срескея) 
$ = Еа1&1->Тех®; 
е1зе $ = ""; 
гу 
{ 


С11еп < Рафа5ее1->рРафа = С11епЕРафабее1->РафаВеачез* (5); 


} 
саёсВ (...) 
{ 


ЗПомМеззасе ("Нет соединения с сервером"); 


Уу01А _ Еаз®са11 ТРГогм]1: : СрескВох2С11сК (ТОБ)ес® *5епаекг) 


{ 
1Е (СрескВох2->СтескКеча) 
{ , 
С11еп*ПРафабе*1->Е1]16ег = Еа12->ТехЕ; 
С11еп*Рафа5её1->Е11+егеЯ = +гае; 
} 


е1зе 
С]11епЕРафа$е®1->Е1]Еегеа = Еа15е; 
} 


{ 
С11еп Раф а5е*1Аче->Уа1ие = УеакгоОЕ (Баее()) - 


С11епРафа5е*1Уеаг Ю->Уа1ае; 


} 


у01А _ Еаз®са11 ТЕГогм1 ;: :С11еп < Рафа5е*1Са1сЕ1е145$ (Трафазбеф *Рафабе+) 
/ 


два окна редактирования и два индикатора. Ниже приведен с некоторыми не- 
принципиальными сокращениями код данного приложения. 


Обработчики событий формы ОпСгеа{е и Оп озе, как обычно, открывают 


и закрывают набор данных. Процедура СВесКВох1СПсК является обработчи- 


924 Глава 11. Работа с удаленными модулями данных 


ком щелчка на верхнем индикаторе. Если индикатор включился, то вызывает- 

ся метод ВааВецие$%, и в него передается строка фильтра, написанная поль- 
зователем в окне ЕЧИ1. Этот вызов после некоторой череды событий вызовет 
обработчик события ОпОааКецие$$, который мы ввели в сервер. Обработчик 
вернет отфильтрованные данные, и это возвращенное значение передается 
свойству СПешОаёа5 её 1->Оаёа, содержащему данные, отображаемые в кли- 
ентском наборе. 

Если индикатор СВесКВох1 выключился, то тем же методом ВаёаВедие$% 
на сервер передается пустая строка в качестве фильтра. 

Процедура СвесКВох2СПсК является обработчиком щелчка на нижнем ин- 
дикаторе. Если индикатор включился, то в свойство Е\ег клиентского набора 
передается строка, введенная пользователем в нижнем окне редактирования. 
Затем фильтрация активизируется заданием свойству ЕЩегей значения фгое. 

Если индикатор выключился, то фильтрация прекращается заданием 
свойству Е\Щеге4 значения Ёа[5е. 

Мы обсудили двухуровневую фильтрацию. Но с помощью компонентов 
СПешОафа$её нетрудно увеличить число уровней. Рассмотрим эту возмож- 
ность, причем в качестве третьего уровня фильтрации попробуем добавить ре- 
шение следующей задачи. В ряде случаев желательно иметь возможность ото- 
бражать только те записи, которые в многострочном поле, например, типа 
Мето, содержат какое-то слово или словосочетание. Сделать это непосредст- 
венно запросом 5@Г или с помощью свойства Е\ег невозможно. Однако, с по- 
мощью компонента СПеп(Оафа5е{ мы эту задачу решим. 

В таблице Рег5 нашей базы данных имеется поле типа Мето — характери- 
стика сотрудника. Пусть мы хотим, чтобы у нас была возможность отображать 
записи только тех сотрудников, в характеристиках которых имеется некото- 
рое заданное пользователем слово или словосочетание. Один из возможных пу- 
тей решения этой задачи следующий. Введем в набор данных вычисляемое 
поле и будем заносить в него "+", если в характеристике встретился нужный . 
фрагмент текста, и заносить "-", если такого фрагмента нет. Тогда можно было 
бы отбирать с помощью свойства Е ег только те записи, в которых в этом вы- 
числяемом поле занесен "+". Но напрямую это сделать невозможно, так как 
свойство ЕЩег не может ссылаться на вычисляемые поля. Обойти это ограни- 
чение можно, добавив в приложение еще один компонент СПетОафа5еф, кото- 
рый бы черпал данные из прежнего компонента СПеп&Оафа5 её. Тогда это вы- 
числяемое поле можно ввести в прежнем СПешафа5еф, и для нового набора 
данных оно не будет являться вычисляемым. Следовательно, в нем можно ис- 
пользовать это поле в фильтре. А если все компоненты отображения и редак- 
тирования данных связать с этим последним СПеп Фаёа5еф, то соответственно 
третий этап фильтрации в этом компоненте отобразится пользователю. 

Итак, введем в наше клиентское приложение, созданное в данном разделе, 
еще один компонент СПешОаёа5еф, который позволит решить сразу 2 задачи: 
обеспечит еще один уровень фильтрации среди записей, прошедших первые 
два уровня, и обспечит такой сложный вариант фильтрации, как фильтрация 
по полю характеристики. 

Давайте создадим такое приложение на основе созданного в этом разделе 
примера СПетЕИтег. Для этого достаточно, открыв прежний проект, выпол- 
нить последовательно команды Не | Зауе Ргоес! Ази Не | бауе Аз, сохранив про- 
ект и модуль соответственно под именами СПеп Г Ше2 и ОСПепГИт2. После 
этого можно вводить в новый проект еще один уровень фильтрации. Подобный 
проект имеется в группе проектов РОЕМуЕМЛ в каталоге Даа Моашез на дис- 
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ке, приложенном к книге. Окно приложения показано на рис. 11.12. В нем до- 
бавлено отображение характеристики и добавлено окно редактирования, в ко- 
тором пользователь может вводить искомый в характеристиках фрагмент тек- 
ста (на рисунке это текст "Иванов”). Если пользователь нажмет кнопку около 
этого окна, то произойдет соответствующая фильтрация. При отпускании 
кнопки этот уровень фильтрации исчезнет. Приложение отличается от преды- 
дущего еще отображением фотографии, но это сделано просто ради полноты 
картины и к фильтрации отношения не имеет. 


Рис. 11.12 ]:= Фильтрация удаленных данных о в А = 17] х] 


Приложение с третьим ПОер - Цех") апд (Уеаг Ь > 1960) 


уровнем фильтрации, | | 
обеспечивающим г Внутренний Фильтр СС" ии 
поиск в поле Мето | | | 

| [Стдел___ [Фамилия [Имя [Отчество — [гр. [Пол Возраст М] =] 


В Бухгалтерия Антонова Антонина Антоновна 1965 ж 
|| Бухгалтерия ° Иванов Иван Иванович 1950 м 


|| Цех 1 Иванова Ирина Ивановна 1961 ж 
|| Цех 1 Петров Петр Петрович 1960 м 


Характеристика 
Антоновой Антонины Антоновны, 
1961 г.р.. 


сотрудницы бухгалтерии 


А.А. Антонова совсем не работает, но прекрасно 
организует вечеринки и культпоходы. 


Начальник ОК И.И. Иванов 


Перенесите на форму приложения СПетГИЕ2, созданного на основе 
СпепГШше, еще один компонент СНепОжфа5её2, провайдер ВаёаЗе{Ргох!14ег1, 
окно редактирования Е9ЩЗ, кнопку Зрее4Ва воп1 и компонент ОВ®В1е ЕЕ 
или ЮВМето{ для отображения характеристики. Он нам нужен будет для 
проверки правильности фильтрации. Провайдер РаёаЗе Ргоу!4ег1 его свойст- 
вом Эаёа5еф свяжите с имеющимся на форме компонентом СПепОаёа5е 1. А 
новый компонент СНешОафа5е2 свяжите свойством Ргоу1егМаше с 
Оафабе{ Ргоу!4ег1. Таким образом, компонент СПеп Оафа5е{2 будет получать 
данные от компонента СПешОа{а$ её 1 и может дополнительно фильтровать 
‘эти данные. — | | 

Компонент ЮВВ1е6ЕЗЦ1 или ОВМето1 свяжите свойством ОафаЗопгсе с 
имеющимся на форме источником данных ФаёаЗоогсе1 и свойством Вафа Ре! 4 
свяжите с полем СВагасф. А источник данных Вафа$опгсе1 свяжите свойст- 
вом ОаёаЗе с СПеш аа е{2. Таким образом, вы переключите все компонен- 
ты отображения данных но последний набор данных СПешОа4а5е{2. 

Теперь введите:в промежуточный набор данных СЦеп{Оажфа5 её 1 вычисляе- 
мое строковое поле У. В обработчик событий ОпСа1е Е 1е! 4$ этого набора добавь- 
те оператор: 
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1Е (С11епеРафабее1СВагас®->Аз5ег1па.ОррегСазе () .Роз ( 
Еа13->Техе.0ОррекгСазе ())) 
С11епВа*а5ее1\У->Азбг1па = "+"; 
е15е С11епЕРафабее1\У->Аз5Ег1лпа = "-"; 


В операторе # текст поля характеристики СПешОабаЗе{ 1СВагас{ сначала 
переводится в верхний регистр функцией-элементом ЧррегСазе класса 
АпяЭе`ше. Это позволяет проводить поиск независимо от регистра текста. 
К тексту, возвращенному функцией ОррегСазе, применяется функция-элемент 
Ро$, определяющая индекс вхождения переданного в нее аргумента — текста 
окна ЕЯИЗ, приведенного к верхнему регистру. Результат отличен он нуля, если 
фрагмент найден. В этом случае в вычисляемое поле СПеп ОаёаЗе{ 1У заносит- 
ся символ "+". В противном случае в него заносится символ "-". 

Теперь надо дополнительно настроить компонент СПепОаёа5еф2. С помо- 
щью его Редактора Полей русифицируйте отображение всех полей записи. 
Поля Маш, Свагасв и РБофо, очевидно, надо сделать невидимыми, чтобы они 
не отображались в компоненте ОВСт1а1. Поле У тоже надо было бы сделать не- 
видимым. Но, как показывает рси. 11.12, я его оставил видимым, чтобы мож- 
но было наглядно проверять работу фильтрации. В свойство Е\ег компонента 
СПешОа{а5её2 занесите фильтр: 


\7='+! 


Но свойство Е\еге4 оставьте равным #а[5е, так как в первый момент фильтр 
не должен действовать. 

В кнопке 5Зрее4ЯВиНЙоп]1 установите в фгие свойство АПомАПОр и задайте 
СгопрШдех равным 1. Эти свойства обеспечивают возможность кнопки перек- 
лючаться из свободного состояния в нажатое и обратно. В обработчик щелчка 
на кнопке занесите код: 

С] 1еп Раф а5ее2->КеЕгезв (); 

1Е( брееЯВиеоп1->Ромп) 


С]11епРаба5еф2->Е1]+егеЯ = +гие; 
е1зе С11епЕДафбабеф2->Е1]16егеа = ЁЕа15е; 


Первый оператор обновляет данные, чтобы они отображали правильное 
значение поля У. А оператор Ё# включает или выключает фильтрацию в зави- 
симости от состояния кнопки. 

Фактически, это все, что нужно сделать в новом приложении. Остаются 
некоторые достаточно очевидные дополнения, которые выделены жирным 
шрифтом в приведенном ниже полном коде всех функций: 


уо1а _ Еа$еса11 ТРогт1 : : РохтСгеаке (ТОБ-ес+ *бепает) 
{ 

ху 

{ 

С11еп Раф а5е®1->Ореп(); 

С11епРафа5ее2->Ореп (); 

} 

саесрь (...) 

{ 


зпомМеззасде ("Нет соединения с сервером"); 


у01А _ Еаз®са11 ТКогм1: : ГогиСТоз5е (ТОБ)]есе *5епаег, 
ТС1озеАс&1оп &Асё1оп) 
{ 
гу 
{ 
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С]11епЕРафабе*1->С1озе (); 
С11епРафа5беё2->С1озе(); 
} 

саеср (...) 

{ 


ЗЛомМез$заае ("Нет соединения с сервером"); 


у01А _ Еаз®са11 ТЕГогм1 ; : СВесКВох1С11сК (ТОБ]есе *5епаег) 
{ 

Ап5156г1па 5; 

1Е (СпескВох1->СрескКеа) 

$ = Еа1 6 1->Техе; 

е1зе $ = ""; 

гу 

{ 

С11еп с Рафабее1->рРафа = С11еп* Рак а5беё1->РакаКеаиезе (5); 

С11епРафабе+2->КеЁгезь (); 

} 

сафсв (...) 

{ 


ЗРомМе$5ачае ("Нет соединения с сервером"); 


у014 _ Газфса11 ТЕогм1 : :СпескКВох2С11сК (ТОБ)есе *5епаег) 
{ 

1Е (СрескВох2->СЪескКея) 

{ 

С11еп<ПРафабефё1->Р1]+ехг = Еа1Е2->Тех&; 

С11епеРафа5её1->ЕР1]16егеа = +гаое; 

} 

е1зе 

С11еп-Рафабее1->Р1]1фегхеа = Ёа15е; 
С11епРафаЗеё2->ВеЁгезВ (); 


Уу01А _ Еазфса11 ТРогм1 : :С11епРафа5е*1Са1сЕ1е1а$ (ТРабабее *Рафа5еф) 
{ 
С11еп-Пафабе 1Азе->Уа1цие = УеагоОЕ (Рафе()) - 
С11епРафабе*1Уеах Ъ->Уа1ае; 
1 (С11еп6Рафа5бее1Свагас+->Аз5&г1па.ОррегСазе ().Роз ( 
Еа1+3->Техе.ОррегСазе ())) 
С11еп Рафа еЕ1У->Аз5Ег1па = "+"; 
е1зе С11епРафабее1У->Аз5Ег1па = "-"; 


\01А __ЕазЕса11 ТГоги1: : ЗреедВиеоп1С11сК (ТОБ)]есЕ *5епаег) 


{ 
С11еп6Рафабе*2->Веёгезь (); 
1Е( ЗрееаВоеЕоп1->)омпт) 
С11еп{Рафабее2->Е11+егеа = +$гое; 
е]1зе С11епеРафа5бее2->Р11$егеа = #а]1зе; 
} 
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Вряд ли требуются дополнительные комментарии к этому коду. Запустите 


приложение и проверьте его в работе. 
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11.6 Индексация клиентского набора 


Клиентские наборы данных обладают расширенными возможностями по 
упорядочиванию их отображения. Одна из них — задание списка полей в свой- 
стве ш4ехЕ1е!ЧМате$. Эта возможность уже использовалась для индексации 
в разд. 11.3.1. Но существенно более широкие возможности открывает метод 
АЗЯТдех. Он позволяет добавлять индекс, задавая при этом для каждого поля 
направление сортировки: нарастающее или убывающее. Индексы, добавляе- 
мые этим методом, поддерживают группировку и вычисление совокупных ха- 
рактеристик. | 

Метод АЧЯТтаех объявлен следующим образом: 

Уу01А __Еазса11 АааТпаех (сопзЕ Ап$15егЕ1па Мате, 

соп5Е Ап$1бЕгалпа Е1е194$, 
ОБ: :ТТпаехОре1оп$ Ор%®т1оп$, 
соп5Е Ап$15Ег1лпа ПезсЕ1е1а$ = "", 


соп5Е Апз156г1па Сазе1Тп$Е1е14а$ = "", 
сопзе 1пе Сгопр1тпаЬеуе1 = 0); 


Параметр Мате задает имя создаваемого индекса. Параметр Е1е]14$ задает 
список полей, по которым проводится индексация. Имена полей отделяются друг 
от друга точками с запятой. Параметр ОрНоп$ задает множество опций сортиров- 
ки, которое может включать значения 1хСазештзеп$ уе — нечувствительность 
к регистру при сортировке строковых полей, и 1хШезсееп т — сортировка в по- 
рядке убывания значений полей. По умолчанию обе опции отсутствуют. 

Параметры ОезсЕ1е!4$ и Сазе[1$Е1е!45$ дают альтернативный вариант за- 
дания опций сортировки. Параметр ОезеЕ1е]14$ может содержать строку, в ко- 
торой перечисляются через точку с запятой те поля, по которым сортировка 
должна проводится в порядке убывания значений. А параметр Сазет$Е1е]4$ 
может содержать строку, в которой перечисляются через точку с запятой те 
строковые поля, по которым при сортировке не должен учитываться регистр. 
Таким образом, параметры ВезсЕ1е14$ и Сазет$Е1е14$, в отличие от параметра 
ОрНоп$, позволяют задать разные опции сортировки по разным полям. 

Параметр СгоиршеГеуе] задает уровень группирования по умолчанию 
и может принимать значения от 0 до числа полей в индексе. Этот уровень име- 
ет смысл, если формируемый индекс будет использоваться при подсчете обоб- 
щенных характеристик (см. разд. 11.3.1). 

При вызове метода А9ЯТт4ех набор данных должен быть открыт. Индекс 
добавляется только на текущий сеанс связи с данными. Как только набор бу- 
дет закрыт, при следующем его открытии индекс уже не будет существовать. 
В частности, индекс не сохраняется методом ЗауеТоЕ Пе в портфельных набо- 
рах данных, которые будут описаны далее в разд. 11.8. 

Рассмотрим на примерах описанные приемы индексации. Можно создать для 
этого новое клиентское приложение, проще взять, например, приложение 
СпетЕШег, созданное в разд. 11.5, и расширить его возможности за счет введения 
упорядочивания данных по указанию пользователя. Для этого достаточно, открыв 
прежний проект, выполнить последовательно команды Не | бауе Ргоес! Аз и НЕ | 
Зауе Аз, сохранив проект и модуль соответственно под именами СПетЕШе та и 
ОСПпещЕШе!"та. После этого надо удалить ссылку на индекс 4ерйо, содержащийся 
в свойстве ш4ехМате компонента СНешДаца$ ей 1, чтобы этот индекс не мешал ин- 
дексации, выбираемой пользователем. Теперь можно вводить в него возможности 
оперативной индексации. Подобный проект имеется в группе проектов РРМуАМО 
в каталоге Даа Моашез на диске, приложенном к книге. 
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Добавьте в приложение выпадающий список СошфоВох1, который будет 
содержать имена тех полей, по которым можно индексировать набор данных. 
Задайте стиль списка (свойство 54е) равным ©$Огоро\пГ.1$$, чтобы пользо- 
ватель не мог в нем указать какобв-то неправильное имя поля. Мы хотим запол- 
нить СотшфоВох1 именами полей набора данных и предоставить пользователю 
возможность, выбрав в списке нужное поле, обеспечить индексацию данных 
по этому полю. 

Для решения этой задачи в обработчик события формы ОпСгеже надо 
вставить операторы: 

С11еп Рафа5еф1->Ореп (); 

СопЬоВох1->Темз->Азз1ап (С11еп<Рафа5её1->Е1е1АВеЕТ1 5+); 

СопроВох1->ТЕемз->ре1 еее (СопБоВох1->Тетм$->ТпаехоЕ ("РВобо")); 


СопроВох1->1$ещ$->ре1еее (СопбоВох1->Т+етз$->1ТпаехоОЕ ("СВагас®")); 
СопбоВох1->ТфещТпаех = 0; 


Первый оператор открывает набор данных. Второй заносит в СотБоВох1 
список полей, предоставляемый свойством Р1е190е{Т1$%. Обратите внимание, 
что в данном случае надо использовать именно свойство Е1е9)ей11$%, а не 
Е1е19Т.15$. В Е1е149Т15% содержатся, все поля, включая вычисляемое поле Аге 
(см. примеры разд. 11.3). А индексация по вычисляемым полям невозможна. 

Невозможна также индексация по полям РВофо и СВагасф, содержащим 
фотографию и характеристику сотрудника. Поэтому третий и четвертый опе- 
раторы приведенного кода удаляют эти поля из списка. 

Для обеспечения индексации по выбранному пользователем полю в обра- 
ботчик события ОпСвапхе компонента СотфоВох1 можно вставить оператор, 
задающий значение Га4ехЕ1е]аМатез: 


С]11еп Рафа5е*1->ТпаехЕ1е1АМапез = СопроВох1->Техе; 


Запустите приложение, и увидите, что пользователь получил возможность 
упорядочивать информацию по своему выбору. 
То же самое можно сделать, используя метод АдЧдех: 
ТТраехОр®1о0оп$ оре$; 
орЕ$ << 1хСазе1Тп5еп$1%1уе; 
С11епеРабабее1->АааТпаех (СопБоВох1->ТехЕ + "Тптаех", 
СопроВох1->ТехЕе, орз, 


ии ип 0 ) ° 
/ Га ; 
С] 1еп(РафабеЕ1->ТраехМаме = СопбоВох1->ТехЕ + "Тпаех"; 


Сначала формируется множество опций, включающее опцию 1хСазетзеп- 
$1Ятуе. Затем формируется индекс с именем "<имя поля>т4ех”". В список ин- 
декса заносится имя выбранного поля (СошфоВох1—>Тех%), задается опция, 
обеспечивающая нечувствительность сортировки к регистру. Последний опе- 
ратор индексирует набор по сформированному индексу. 

В приведенном примере сортировка всегда осуществляется в направлении 
увеличения значения выбранного пользователем поля. Добавьте в приложение 
группу радиокнопок ВаФюоСгоир1, которая позволит пользователю выбирать 
направление сортировки: нарастание или убывание. Тогда приведенный выше 
обработчик события ОпСВапрфе компонента СошфоВох1, использующий А9@@9- 
[пдех, можно изменить так: 

ТТпаехОре1оп$ орёз ; 

ор*5 << 1хСазеТптп5еп$1&1уе; ' 

Ап5156г1лпа 5резс = ""; 

// Формирование строки параметра ПРезсЕ1е1а$ 


1Е (Ваа1оСбгоцр1->ТеетТпаех == 1) 
5Везс = СопБоВох1->ТехЕ; 
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С11епРафа5е*1->АааТпаех (СотЬоВох1->Тех+ + $0езс, 
СомроВох1->Техе, орф$, 
5Безс, "",0); 

С11епЕРафабе+1->ТпаехМаме = СопьоВох1->ТехЕ + $0езс; 


На этот же обработчик надо сослаться в событии ОпСВапее компонента 
ВБаФюоСгоир1. В приведенном коде несколько изменено имя индекса, но глав- 
ное отличие от предыдущего варианта — задание направления сортировки не 
опциями, а параметром ВезсЕ1е]4$, в который заносится строка ЗОезс: пустая 
или с именем поля в зависимости от выбранной пользователем радиокнопки 
в компоненте Ка#юоСгоир1. | 

Теперь еще усложним задачу, предоставив пользователю возможность фор- 
мировать индекс с двумя ключами, независимо выбирая для каждого ключа на- 
правление сортировки. Для этого добавьте на форму еще один список СошБоВох2 
и группу радиокнопок Ка@оСгопр2. Форма может приобрести вид, показанный 
на рис. 11.12 (проект СПет Ге] т4 на приложенном к книге диске). Располо- 
женный внизу список Индексы будет рассмотрен позднее. Списки СотБоВох1 
и СошБоВох2 надо загрузить именами полей так же, как описано выше. 


Рис. 11.12 
Приложение 

с фильтрацией 
и индексацией 
данных 


Бухгалтерия !Антонова Антонина !Антоновна 1965, ж | 


ими ——щ--еьх ———+ — к ——- ее = 3 + к ааа! 
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При использовании свойства ш4ехР1е!9Матез общий обработчик событий 
всех списков может иметь вид: 


11.6 Индексация клиентского набора 931 


С11еп*ПРафабее1->ТпаехРГ1е1АМатез$ = СопроВох1->ТехЕе + 
";" + СопроВох2->Техё; 


Но в этом варианте нельзя выбирать направление сортировки. Это можно 
сделать методом АаЧт@Фех. В этом случае общий обработчик событий всех спи- 
сков и групп радиокнопок может иметь вид: 


ТТпаехОре1оп$ орз ; 

оре$ << 1хСазеТптзеп$1е1уе; 

Ап515©г1па 50езс = "", ЗМаме = СопбоВох1->Техе; 

1Е (КаЧа1оСбгопр1->ТеетшТпаех == 1) — 

{ 

// формирование имени и строки параметра ПезсЕ1е]1а5$ 
5Резс = СопроВох1->Техе + ";"; 
5Маме = $Маме + "_Пезс"; 

} 

1Е (СотроВох2->ТехЕ == СопроВох1->Тех+) 

{ 

// если ключи одинаковы, второй ключ игнорируется 
Ваа1оСгоир2->Т$етГпаех = ВКаЯ1оСгоцр1->Т%&ептТпаех; 
Ваа1оСгопр2->Епаб]1еа = Ёа1зе; 

} 

е1зе 

{ 

// Формирование имени и строки параметра ПезсЕ1е]1а$ 
ЗМаме = 5Маме + СопБоВох2->Техё; 
Ваа1оСгопр2->Епаб1еа = +гае; 

1Е (ВКаазобгоир2->ТЕемТпаех == 1) 

{ 

$Резс 5$Везс + СопроВох2->ТехЕ; 

ЗМаше = 5Маме + "_Пезс"; 

} 

} 

С11еп Паб а5е*1->АааТпаех (5Маше, СотЬоВох1->Техе + ";" + 
СомроВох2->Техе, орф$, 
5резс, "",0); 

С11епЕРафабеё1->ТпаехМаме = 5Мапе; 


Приложение можно дополнить выпадающим списком, содержащим все 
индексы, определенные пользователем в данном сеанса. С его помощью поль- 
зователь может легко переключаться между разными индексами. Введите та- 
кой список и назовите его СВШФех. На рис. 11.12 он расположен внизу фор- 
мы. Для первоначального заполнения этого списка индексами по умолчанию 
в обработчик события формы ОпСгезфе надо добавить операторы: 


С11епера+а$е*+1->СеетпаехМамез (СВТпаех->Т%емз); 
СВТлаех->Т+епТпаех = 0; 


В первом из этих операторов используется метод Се пдехМатез для по- 
лучения списка индексов. Этот список загружается в объект, переданный 
в него в качестве аргумента, т.е. в СВШфех. 

В конце обработчика события ОпСВапфе компонентов СошфоВох1 и Сот- 
ъоВох2 надо добавить операторы: 

С11еп*Рафабе*1->СеТпаехМапез$ (СВТпаех->Т+етз); 


СВТпаех->Т+ещТпраех = 
СВТпаех->ТЕемз->ТпаехоЕ (С11еп=Вафабе*1->ТпаехМаме); 


Для получения списка индексов в них используется то же метод Се пдехМатез. 
В обработчик события ОпСВапее компонента СВШаеех надо вставить оператор: 


С11епРафа5е*1->ТпаехМаме = СВТпаех->Тех*; 


который заменяет текущий индекс тем, который выбрал пользователь. 
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11.7 Приложение со связанными таблицами 


Все рассмотренные ранее приложения связывались только с одной табли- 
цей Регз. Поскольку в нашем сервере МуВМО имеется второй провайдер 
О5РОер, связанный с таблицей Шер, нетрудно в любое разработанной ранее 
приложение ввести отображение и этой таблицы. Давайте сделаем это на при- 
мере приложения СПеп МуЕМО, разработанного в разд. 11.3 и 11.4. Расши- 
рим это приложение, введя в него отображение второй таблицы базы дан- 
ных — Оер. Введем возможность независимой работы с каждой из этих таб- 
лиц, а также работы с ними как со связанными таблицами: чтобы при переме- 
щении по таблице О[Оер в таблице Рег$ отображались только записи, соответст- 
вующие подразделению, указанному в текущей записи Оер. 

Если вы хотите воспроизвести это усовершенствованное приложение, от- 
кройте прежний проект СПеМуЕМО, выполните последовательно команды 
Не | Зауе Ргдес! Ази Не | Зауе Аз и сохраните проект и модуль соответственно под 
именами СПет МуКМО2 и ОСПеп1 МуЕМП2. Подобный проект имеется в груп- 
пе проектов РоМуЕМР в каталоге Даа Моаиез на диске, приложенном к кни- 
ге. Форма этого приложения показана на рис. 11.13. Верхняя ее часть совпадает 
с рассмотренной ранее в приложении СПеп1 МуЕМО. А ниже расположен ком- 
понент ОВС192, отображающий таблицу Оер. Если включить индикатор Свя- 
зать таблицы (его имя в приведенном далее коде СвесКВох1), то таблицы в верх- 
ней и нижней частях формы оказываются связанными. В примере на рис. 11.13 
этот индикатор включен, и курсор в таблице подразделений стоит на записи, со- 
ответствующей подразделению “Цех 1". Соответственно в верхней таблице ото- 
бражаются только записи сотрудников этого подразделения. 
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Рис. 11.13. Приложение со связанными таблицами 


11.7 Приложение со связанными таблицами 933 


Чтобы реализовать подобный пример, добавьте на прежнюю форму компо- 
ненты СПеп )афа$е! 2, ПОжаЗопгсе2, 0ВСг1 92, СЬескКВох1. Компонент 
0ВСг!92 свяжите свойством ВаёаЗоигсе с источником данных Ожфаоигее2. 
Компонент ОаёаЗоигсе? свяжите свойством ОБаёфа5е с клиентским набором 
данных СПешОаба5е{2. В клиентском наборе СПешОафа$ её? в свойство 
Кето{еЗегуег укажите ссылку на компонент ОСОМСоппесйИоп1, а в свойстве 
Ргоу14егМате укажите провайдер ОЗРОер сервера. Обработчиками событий 
АЁегРо${ и ОпВесопс!еЕггог в компоненте СЦешОафа$е{2 назначьте те же 
обработчики, что и в СПешОафа$е{1. 

В исходном состоянии связь наборов данных СПешОафа$е{1 и СПеш Фа- 
фа5её2 друг с другом не предполагается. Поэтому свойства МазегЗоигсе и 
Маз егЕ1е]!9$ компонента СПешОафа$ е{1, устанавливающие связь с головным 
набором данных, остаются пустыми. Соответственно и индикатор СВесКВох1 в 
исходном состоянии не включен (свойство СВескКе4 равно #а[$е). 

Ниже приведен код основных процедур модуля главной формы проекта. 


#1пс1иае <дафеое11$.Прр> 
#1пс1оае "0С11епМуВМр2.В" 
#1п0с10Ае "ОВесопс11]еЕггог.В" 


106 МубауеРо1пе, МуЗауеРо11пЕ2; 
Боо1 Моа1Е1еа = Еа15е; 
Боо1 Тоад1п = Еа1з$е; 


у01Аа __Еаз®са11 ТГогш1: : ГогаСгеафее (ТОБ)]ес® *5епаег) 
{ 
гу 
{ 
С11епПРафа5еф1->Ореп (); 
С11епРафаЗее2->Ореп (); 
МубауерРо1пе = С11еп*Пафабеф1->5ауеРо1пф; 
МубауеРо1пе2 = С11епЕРафабее2->$ауеРо1п*; 
Таье14->СарЕ1оп = "Время последнего обновления из базы данных: " + 
РасеТт1теТо$ех (Мом ()); 
} 
саесВ (...) 
{ 


ЗПомМез5асве ("Нет соединения с сервером"); 


У01А __Еаз®са1] ТЕГогп\1 : : ОСОМСоппес® 1оп1бееОзегпаме (ТОр)есЕ *5епаег, 
Ап$156г1лпа &ОУзегпапме) 


{ 


Озегпаще = "Гость"; 


уо1А __Еаз®са11 ТГоги1 ; : ОСОМСоппес®1оп1То91п (ТОБ]есе *5епаег, 
Ап5156г1па Озегпатше, Апз156г1па Раззмога) 

{ 

1Е(Озегпаше == "Гость") 

{ 

ВРрафаВазе->Епар1еа = Ёа15е; 

ОВСсг1а1->ВеаЧОп1у фгое; 

ОВМемо1->ВКеаа0Оп]1 у сгце; 

} 

е1зе 1ЁЕ(! ((Ап$1ГомегСазе (Озегпате) == "1") && 

(Раззмога == "1"))) 


{ 


Арр11са&1оп->МеззадеВох ("Неверное имя или пароль", 
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"Приложение будет закрыто", 
МВ_ТСОМ$ТОР); 
Арр11са*1оп->Тегт1паее (); 

} 

Гоа1п = &гие; 

Т1пег1->ЕпаЪ1еа = +гое; 

} 
Иена ---------------- 


Уу014 _ Еаз®са11 ТРГогм1; :Рогтбпом (ТОБ]есе *5епаег) 


{ 
1Е(! Год1п) 
{ 


Арр11са*1оп->МеззадеВох ("Вы не задали имя и пароль", 
"Приложение будет закрыто", 


МВ_ТСОМ$ТОР); 
С1озе (); 


01а _ Еаз®са11 ТКГоги1: : РогаС1озе (ТОБ)ес® *5епаег, 
ТС1озеАс®1оп &Ас®1оп) 


{ 

гу 

{ 
С11еп{ПРафабе*1->С1о5е(); 
С11епРафбаЗее2->С1озе(); 

} 

саёсв (...) 

{ 


ЗПомМе$з5асе ("Нет соединения с сервером"); 


У01А __Еаз®са11 ТКогп1 : :ВРафаВазеС11ск (ТОБ)есЕ *5епаег) 


{ 

ф гу 

{ 
С11еп=ПБафабее1->Арр1у0рдаеез (-1); 
МубауеРо1пЕ = С11епРафабе*1->5ауеРо1п{; 
С11епРафабе*2->Арр1у0раа+ез (-1); 
МубауеРо1пе2 = С11епрафабе+2->бауеРо1п*; 
МоЧ1ЁЕ1еа = Еа1зе; 


} 


сафср (...) 
Таре13->Сар®1оп = "Не удается связаться с сервером"; 

} 

} 

Инннннннннннннннннннннн+============================ 

у01А __Еаз®са11 ТГогм1 : :С11епРафа5е*1АЁЕфегРоз* (ТРафабеЕ *Рафабеф) 


Моа1Е1еа = +г1ае; 


%01А __Еаз®са11 ТЕГогм1: :ГогиС1озеО0чцегу (ТОБ]есе *5епаег, 
Боо1 &СапС1озе) 


{ 
1Е (Моа1Е1еа) 
$м1ЕсВ (Арр11сае1оп->МеззачевВох ( 
"Данные были изменены. Сохранить их в базе данных?", 
"Подтвердите сохранение изменений", 
МВ УЕЗМОСАМСЕТГ | МВ ТСОМОЧЕЗТТОМ)) 


11.7 Приложение со связанными таблицами 935 


{ 
сазе ТОСАМСЕГ: СапС1о5е = Ёа15е; 


Ьгеак; 
сазе ТРУЕЗ: С11еп(Рафа5её1->Арр1у0рдаеез (-1); 
С11епРафабее2->Арр1у0Ораа*ез (-1); 


Иен -------------- 
У01А _ Еаз®са11 ТЕГогш1: :ВКо11расКкС11сК (ТОБ]есе *5епаег) 
{ 
С]1еп*ПРафабее1->5ауеРо1п®е = МубауеРо1п%; 
С11епРафа5бее2->5ауеРо1пЕ = МубауеРо1п+2; 


Моа1Е1еа = Еа15е; 


1Е (Моа1Етеа) 

$м1Еср (Арр11сае1оп->МеззааевВох ( 
"Данные. были изменены. Сохранить их в базе данных?", 
"Подтвердите сохранение изменений", 
МВ _УЕЗМОСАМСЕТ | МВ_ТСОМОЧЕЗТТОМ)) 


{ 
сазе ТОСАМСЕГ: гебагп; 


сазе ТРУЕЗ: С11еп*Рафабеё1->Арр1у0раа®ез (-1); 
С11епРафа5е+2->Арр1у0рда+ез (-1); 
Бгеак; 

сазе ТОМО: С] 1еп-Ракабе*1->Сапсе1Ордаеез (); 


С11епРафабее2->Сапсе1Орааеез (); 
} 
С11епРафа5бе*2->С1озе(); 
С11еп Рафабе+2->Ореп (); 
МубауеРо1пе2 = С11епЕБафа5бе+2->5ауеРо1п*; 
С11еп*Рафа5еф1->С1озе (); 
С11епеРафа5е®1->Ореп (); 
МубауеРо1пЕ = С11еп*ПРафабеф1->5ауеРо1пЕ; 
Таре14->Сар+1оп = "Время последнего обновления из базы данных: " + 

РафеТт1теТобег (№ом ()); 

Моа1Е1е = Еа1з$е; 
} 


сафесп (...) 
Таре14->Сар®1оп = "Не удается связаться с сервером"; 
} 
} 
Ии-=--нннн======================================---- 
у01Аа __Еаз®са11 ТГогм1 ; : ОВбг1А1КеуРгез$$ (ТОБ)есе *беп4ег, спаг &Кеу) 
{ 
1Е( (0ВСг1а1->5е1есееаТпаех == 0) || (0Вбг1а1->5е1есееаТраех == 5)) 
Кеу = 0; 
} 
ИИ--===============-==---------=-----===---==---===-===--=------- 


у0о1А _ Еаз®са11 ТКогм1: :С11епРафа5е*1Са1сЁР1е145$ (ТРакабее *Рафабеф) 


{ 
С11епеРафа5бе*1Азе->Уа1ае = УеагоОЕ (Ра*е()) - 
С11еп&Рафа5 её 1Уеаг_Ь->Уа]1ае; 


у01А __Еаз®са11 ТРогм1:; :Е 91 1Срапде (ТОБ)]есЕ *5бепаег) 


{ 
Тросафе0р+1опз беагсрпОр*1оп$; 
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беагспОр®1оп$ < 1оРагё1а1Кеу < 1оСазе1Тптзеп$1%1уе; 
С]11еп*Пафабе*1->Госафе ("Гам",Еа1+*1->Техе, ЗеагсвОре1оп$); 


у01А __Еазеса11 ТРГогш1: :С11епРафа5бе 1Весопс11еЕгкгохг ( 
ТСазфомС11епРавабеЕ *Рафабее, ЕКесопс11еЕггог *Е, 
ТОрЯафхеКк1па ОраафеК1па, ТВесопс11еАс®1оп &АсЕтоп) 


АсЕ1оп = Напа1еВесопс11еЕггог (%51$, Рабабее, ОраакеК1па, Е); 


нянннннннннннннняннннннннннн+--=============-======= 
у0о1А __Еаз®са11 ТКогм1: :Т1мег1Т1мег (ТОБ]есЕ *5бепаег) | 
{ 
Е гу 
{ 
Таре13->Сар®1оп = "Время последнего изменения в базе данных: " + 
(Ап$15Ег1па) (С11епеПафабе®е1->рафаКеадиез® ( 
(Апз15ег1па) "Запрос")); 
} . 
саесв (...) 
{ 
Тафе13->Саре1оп = "Не удается связаться с сервером"; 
} 
} 
Иннннннннннннннннннннн-===========================-==- 


у014 __Еаз&са11 ТГоги1: ; СМескВох1С11сК (ТОБ]есе *Зепаег) 


1Е( СВесКВох1->СВескеа ) 
{ 


С11епДафабе*1->МазЕегЗоцгсе = Бабабопгсе2; 
С11епРафа5е*1->МазЕегР1е1Аз = "Бер"; 


} 
е1зе С11епеШафаЗе{1->Мазфегбо<цгсе = №11,; 


} 


. В приведенном коде жирным шрифтом выделены операторы, добавленные 
для осуществления работы со второй таблицей. Но отличий от кода, приведен- 
ного в разд. 11.3.2, гораздо больше. В код введены дополнения, рассмотрен- 
ные в разд. 11.3.3 и 11.4, и введена обработка исключений, которые всегда мо- 
гут возникнуть при попытках установить связь с удаленным сервером. 

Остановимся на функции СВесКВох1СПеК, являющейся обработчиком 
щелчка на индикаторе Связать таблицы. Если индикатор включается, то свойст- 
во МазегЗопгсе компонента СПепОафа$ её 1 заносится ссылка на компонент 
ОаабЗопгсе2. В результате компонент СПепОафёа5 её! становится вспомога- 
тельной (детализирующей) таблицей, а компонент СЦПешОаёа$ её 2 становится 
головной таблицей. В свойство МазфегЕ1е]!4$ компонента СПепОафа$е{1 зано- 
сится имя поля головной таблицы, по которому осуществляется связь со вспо- 
могательной — “Пер”. 

Если индикатор выключается, то свойство МазегЭоигсе компонента 
СПепОафа5 её 1 заносится МОГГ. Тем самым связь таблиц друг с другом раз- 
рывается. 


11.8 Портфельные наборы данных 


Рассмотренные в предыдущих разделах клиентские приложения позволя- 
ли просматривать данные, полученные с удаленного сервера, и редактировать 
их на протяжении одного сеанса работы. Но часто желательно дать пользова- 
телю возможность работать с данными, полученными с сервера, на протяже- 
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нии нескольких сеансов или нескольких дней. А потом, когда все данные отре- 
дактированы, послать их на сервер. Такая локальная копия данных, сохра- 
няемая на компьютере пользователя, называется портфельным (Бте{сазе) на- 
бором данных. | 

Создается портфельный набор данных с помощью компонента СЙепа- 
фа Зе очень просто. У компонента есть свойство ЕИеМате. Это имя файла (мо- 
жет указываться с путем), в котором хранится база данных. Свойство 
ЕПеМаште задается, если компонент должен всегда читать и записывать дан- 
ные одного определенного файла. Если файл, указанный в ЕИеМате, сущест- 
вует, то при каждом открытии набора данных в него будут загружаться дан- 
ные из этого файла, а при каждом закрытии набора данных в него будут запи- 
сываться данные из набора. Так что достаточно указать в свойстве ЕИеМате 
имя файла, и при окончании сеанса работы с клиентским приложением в этот 
файл автоматически будет заноситься портфельный набор данных. А в новом 
сеансе работы данные будут автоматически читаться из этого файла, а не из 
удаленной базы данных. 

Можно также осуществлять чтение данных из файла методом Гоа@ЕготЕПе: 


\01А __Еаз®са11 ГоааЕгомЕ11е (соп5Е 'Апз156г1па Е11еМаме = ""); 


Если параметр ЕИеМате — пустая строка или вообще не указан, то чтение про- 
изводится из файла, заданного свойством Е!еМате. Таким образом, оператор 


С11еп*Рафабе*1->ГоаЯЕгомР11е (); 


обеспечит чтение данных из того же файла, из которого производится чтение 
при открытии набора. Отличие в том, что это чтение можно произвести в лю- 
бой момент, а не только в момент открытия набора. А введя в приложение диа- 
лог открытия файла, можно с помощью ГоааЕготшЕ Пе организовать чтение из 
любого выбранного пользователем файла таблицы, т.е. из любого портфельно- 
го набора данных. 

Метод ЗауеТоЕЦе позволяет в любой момент сохранить данные в файле. 
Он объявлен следующим образом: 


Уу01А _ Еаз®са11 ЗауеТоЕ11е (сопз+ Ар5156г119 г11еМаше = 
ТрафаРаске®Еогта® Еогта® = — аевапагу); 


Параметр ЕПеМатше аналогичен  рассмотренному для — метода 
Гоа4ЕготЕ1е. А параметр Еогта& указывает формат файла и может прини- 
мать одно из следующих значений: 


АРВтагу двоичный формат 


АХМГ, формат ХМГ с расширенным набором символов езсаре-последо- 
вательности 


ЧРХМГОТЕ8 |формат ХМЕЬ с расширенным набором символов, использующим 
ОТЕ8 


Ввести в любое клиентское приложение портфельный набор данных доста- 
точно легко. Рассмотрим это на примере приложения СПет1 МуАМЬО, создание 
которого обсуждалось в разд. 11.3 и 11.4. Если вы самостоятельно создавали 
проект СИепМуВМЬ, то сохраните его (команда Не | Зауе Ргоес! Аз) под новым 
именем СПетВпте[сазе. Далее перейдите в Редакторе Кода в текст модуля 
ОСйет ВМО, выполните команду НЕ | бауе Аз и сохраните файл под новым име- 
нем ОСПетВте{сазе. Теперь у вас файлы проекта и основного модуля не связа- 
ны с прежним проектом, и можно проводить изменения в ОСПетВте[сазе 
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(см. пример СПетВте]{сазе в каталоге Дааа Моаше группе проектов РРЕМуЕМО 
на приложенном к книге диске). 

В свойстве ЕПеМате компонента СПеп{Оафа$е{1 надо бы задать имя фай- 
ла, желательно, со стандартным расширением .хт[, в котором должны хра- 
ниться данные портфельного набора. Задать его можно в Инспекторе Объек- 
тов. При этом для выбора каталога можно воспользоваться диалогом, вызы- 
ваемым кнопкой с многоточием около этого свойства. Но тут надо быть осто- 
рожным. Если вы заложите в приложение имя файла с путем, то ваше прило- 
жение нельзя будет перенести на другой компьютер с другими каталогами. 
Даже если вы зададите имя файла без каталога, С++Виаег автоматически до- 
бавит путь к имени файла. И вы опять получите непереносимый проект. По- 
этому лучше не задавать свойство ЕИеМате во время проектирования. Сдела- 
ем это программными средствами. 

В форму приложения стоит добавить кнопку В файл (имя ВТоЕПе), кнопку 
Из файла (имя ВЕгошЕПе), кнопку Изменения БД? (имя ВЕготЕЦ1е), обеспечи- 
вающую запрос о времени последнего изменения в базе данных. Имеет смысл 
также заменить надпись Обновить на кнопке ВВеёгезВ надписью Из БД, так 
как иначе будет непонятно, что значит “Обновить”. Все эти внешние измене- 
ния формы вы можете видеть на рис. 11.14. 


‘Антонина — Антоновна 

Иван Иванович 1950 

Николай Николаевич 1930. 
‚Борисов Борис | Борисович 1937 
_ Иванова Ирина Ивановна 1961' 


`Павлов Павел Павлович 1975 
Характеристика 

Антоновой Антонины Антоновны, 
1961 г.р.. 

сотрудницы бухгалтерии 


Петров Петр. Петрович 1960 
Андреев Андрей Андреевич 1 930 


. Иванников Иван Иванович 1975 


Сидоров = Сидор _ Сидорович 1955 
Харитонов — Харитон ‘Жаритонович 1962 


А.А. Антонова совсем не работает, 
но прекрасно организует 
вечеринки и культпоходы. 


$55555 


Начальник ОК И.И. Иванов 
Сотрчаников в подразделении Бухгалтерия 3 Всего : 11. 


Время последнего изменения в базе данных. 12.03.2006 13:34:34 
Время последнего обновления из базы данных: 12.03.2006 14:21:53 


Рис. 11.14. Приложение для работы с портфельным набором данных 


В приложении надо сделать также ряд других изменений. Надо устано- 
вить в #а]5е значение свойства Г.051тРгошр* компонента ОСОМСоппесйоп] и 
удалить обработчик события формы ОпЭВом, который проверял ввод пользо- 
вателем пароля. Заодно имеет смысл удалить обработчики событий 
ОпСе Озегпате и ОпГ.огш компонента ОСОМСоппес 10оп1. Дело в том, что в 
портфельном приложении, вероятно, надо спрашивать пароль, независимо от 
того, читаются ли данные из базы данных, или из файла. А стандартный диа- 
лог запроса пароля, инициируемый свойством Г051тРготрё, будет вызываться 
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только при первом соединении с базой данных. Так что, если требуется, надо 
защищать данные паролем программно с помощью собственного, а не стан- 
дартного диалога. 

Надо также удалить из приложения таймер и связанный с ним обработчик 
события ОпТ1тег. В портфельном наборе данных не имеет смысла постоянно 
обращаться к серверу, так как приложение может работать вообще без связи с 
сервером. А если пользователю потребуется узнать время последнего изменения 
в базе данных, он может воспользоваться для этого кнопкой Изменения БД. 

Ниже приведены те фрагменты кода, которые отличаются от кода, создан- 
ного в приложении ранее в разд. 11.3 и 11.4.Полужирным шрифтом выделены 
новые операторы. . 

У014 _ Еаз®са11 ТГогш1: :ГогиСгеате (ТОр)]есе *5епаег) 


{ 

С11епРафа5ее1->Р11еМате = "ОВР_Регз.хш1" 
С11еп*Рафабее1->Ореп (); 
С11епРафабее1->ЗауеТог11е("", аехмГ); 
МубауеРо1пе = С11еп*Пафабеф1->5ауеРо1пе; 


Уу01А _ Еаз®са11 ТГогм1:; : ГогаС1озебцегу (ТОБ]есе *5епаег, 
Боо1 &СапС1оз$е) 
{ 
1Е (Моа1Е1еа) 
$м1Еср (Арр11са&1оп->МеззааевВох ( 
"Данные были изменены. Сохранить их в файле?", 
"Подтвердите сохранение изменений", 
МВ_УЕЗМОСАМСЕЪЬ | МВ _ТСОМОЧЕЗТТОМ)) 
{ 
сазе ТОСАМСЕГ: СапС1о5е = Ёа1з$е; 
Бгеак; 
сазе ТОМО: С11епРафа5е*1->Г11еМаме = ""; 


у014 __Газ®са11 ТКогм1: :ВрабаВазеС11скК (ТОр)]ес® *5епаег) 
{ 
суу 
{ 
С11еп*ПРафа5е*1->Арр1у0Ораа*ез (-1); 
МубауеРо1п& = С11еп®Ра*абее1->5бауеРо1п*{; 
Моа1Е1еа = Еа15е; 
Таре13->Сар®*1оп = "Время последнего изменения в базе данных: " + 
(Ап815Ег119) (С11еп&Рафа5е{1- >рафаКеачезе ( 
(Апз15$Е:г1п9) "Запрос")); 
} 
саесь (...) 
{ 


Таре13->Сар®1оп = "Не удается связаться с сервером"; 


уо1А __Еаз®са11 ТЕГогп1: : ВВеЁгезпС11сК (ТОр)]ес& *5епаег) 
{ 
ху 
{ 
1Е (Моа1Е1еа) 
$м1ЕсВ (Арр11сае1оп->МеззачевВох ( 
"Данные были изменены. Сохранить их в базе данных?", 
"Подтвердите сохранение изменений", 
МВ _УЕЗМОСАМСЕТ | МВ_ТСОМОЧЕЗТТОМ)) 
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{ 
сазе ТОСАМСЕГ: гефагп; 


сазе ТРУЕЗ: С11епЕРафа5ее1->Арр1у0Орааеез (-1); 
БгеаКк; 
сазе ТОМО: С11епсРафабеф1->Сапсе1Ораафез (); 
} 
С11еп{Бафа5е*1->7Р11еМаме = ""; 
С11еп*Рафабеф1->С1озе (); 
С11еп<Рафабеф1->Ореп (); 
С11епРафа5ее1->Е11еМаме = "ОВР _Рег$.хи1"; 
С11еп Рафа еЕ1->ЗауеТоЕ11е("", аЕхмМт); 
МубауеРо1п® = С11епеРафабее1->5ауеРо1п%; 
Таре14->Сар®1оп = "Время последнего обновления из базы данных: " + 
РафеТ1меТоб ег (Мом ()); 
Моа1Е1еа = Еа15е; 
саеспв(...) 
{ 


Таре14->Сар&1оп = "Не удается связаться с сервером"; 


у01А __Еаз%са11 ТРоги1: : ВТоЕ11еС11сКк (ТОБ]есе *5епаег) 
{ 

МуЗауеРо1пеЕ = С11епЕШафабее1->бауеРо1пе; 

Моа1Е1еа = Еа]1зе; 


%01А _ Еаз%са11 ТЕоги1: : ВЕгомЕ11еС11сКк (ТОБ)есЕ *5епдег) 
{ | 


ин 


С11еп(Рафабее1->Рг11еМаме ; 
С11епРафабее1->С1озе(); 
С11епБафа5её1->Е11еМаме = "ОВР_Регз .хп1"; 
С11епРафса5ее1->Ореп (); 


Ииннннннннннннн-нн================================== 
у01А __Еаз&са11 ТЕоги1: :ВТС13сК (ТОБ]есЕ *5епаег) 
{ 
гу 
{ 
Гаье]13->Сар*1оп = "Время последнего изменения в базе данных: " + 
(Апз156г1па) (С11епРафабек1->рафаВеаоез* ( 
(Апз15Ег1па) "Запрос")); 
} 
саеёсь (...) 
Тафе13->СарЕ1оп = "Не удается связаться с сервером"; 


} 
} 


В функции ЕогтСгеа{е добавлен оператор, задающий имя файла в свойст- 


во ЕПеМаше. Поскольку это делается до открытия набора данных, то при на- 
личии в текущем каталоге этого файла во время открытия набора даных мето- 
дом Ореп данные прочитаются из него. Если файла на диске нет, то данные 
прочитаются из удаленной базы данных. 


Третий оператор сохраняет в файле данные из клиентского набора. Если 


такого файла не было, он создается этим оператором, и в него заносятся теку- 
щие данные. Этот оператор не является необходимым, так как при закрытии 
проекта данные в файле все равно сохранятся автоматически. Так что такой 
оператор можно вводить в приложение просто ради страховки от каких-то ка- 
таклизмов на компьютере. Например, при зависания системы данные автома- 
тически в файле не сохранятся. 
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Последний оператор запоминает текущее состояние набора данных в пере- 
менной МуЗауеРотё. 

В функции ЕогтСюозе@опегу несколько изменен вопрос к пользователю — 
теперь он относится к сохранению в файле, а не в базе данных. Соответственно 
изменена и реакция на ответ пользователя. Если пользователь ответил “Да”, 
то никаких действий не требуется, так как данные будут сохранены в файле 
автоматически после завершения приложения. А если пользователь ответил 
"Нет", то в свойство ЕИеМате набора данных СПепОжфа$ е{1 заносится пус- 
тая строка. Тогда сохранение данных в файле не произойдет. | 

В функцию ВОаёаВазеСИЦсК, срабатывающую при щелчке на кнопке В базу 
данных, добавлен запрос о времени последнего изменения в базе данных. Ранее 
можно было обойтись без этого запроса, так как такой запрос регулярно посы- 
лался на сервер таймером. 

Функция ВКе!гез В СПекК, обеспечивающая чтение данных с сервера, изме- 
нена существенно. Ограничиться, как ранее, просто закрытием и открытием 
набора данных в данном случае невозможно, так как при открытии набора 
данные прочтутся из файла. Поэтому первый оператор функции, срабатываю- 
щий после диалога о сохранении данных, задает в качестве значения свойства 
ЕПеМаше пустую строку. Второй оператор закрывает набор данных, а третий 
его открывает. Поскольку в момент открытия имя файла не указано, данные 
читаются из удаленного модуля данных. Затем имя файла восстанавливается, 
и новые данные заносятся в файл. Сохранение в файле введено просто для 
страховки от возможных последующих сбоев в компьютере. В принципе, этот 
оператор не нужен — при завершении выполнения приложения данные авто- 
матически сохранятся в файле. 

Функция ВТоЕПеСПсК является обработчиком щелчка на кнопке В файл. 
Ее операторы тривиальны — просто текущее состояние набора фиксируется в 
переменной МуЗауеРой\. Если вы хотите обезопасить данные от возможных 
последующих сбоев компьютера, вы можете дополнить эту функцию операто- 
ром, сохраняющим данные в файле с помощью метода ЗауеТоЕ 1е, как это 
было сделано в предыдущей функции. 

Функция ВЕготЕПеСПск является обработчиком щелчка на кнопке Из фой- 
ла. Первый оператор функции стирает в наборе данных имя файла. В результате 
следующий оператор, закрывающий набор данных, не сохранит данные в фай- 
ле. Четвертый оператор восстанавливает имя файла, так что последний опера- 
тор, открывающий набор данных, обеспечит чтение данных из файла. 

Функция ВТСИсК является обработчиком щелчка на кнопке Изменения 
БД?г. Она посылает запрос серверу о времени последнего изменения базы дан- 
ных и заносит полученный ответ в метку. 

Все остальное в клиентском приложении остается без изменения. Так что 
можно выполнять новое приложение и исследовать его работу. 


11.9 Клиентское приложение с запросами $О1 


В предыдущих разделах мы работали с удаленным модулем данных, постро- 
енным на компоненте ТаШе. Теперь коротко рассмотрим возможности модуля 
данных, способного воспринимать произвольные запросы 591. Такой модуль рас- 
смотрен в конце разд. 11.1. Он реализован в серверном приложении ту МР$ОГ 
в каталоге Даа Моаше в группе проектов РОЕАМО5ОГ на приложенном к книге 
диске. В модуле в свойство ОрИоп$ провайдера Ожазе Ргоу14ег1 включена оп- 
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ция роАПо\СоттапаТехё. Это позволяет клиентскому приложению передавать 
на сервер свои запросы БОГ. 

Передача запроса на сервер строится по следующей схеме: клиентский на- 
бор данных закрывается, в свойство СоттапАТехё заносится текст запроса, 
и клиентский набор опять открывается. На рис. 11.15 приведен вид простого 
тестового приложения, использующего запросы БОГ (проект СПепь ФЕ в ката- 
логе Раю Моаше в группе проектов РОКМГШФО на диске, приложенном к кни- 
ге). Чтобы создать подобное приложение, поместите на форму уже многократно 
использовавшееся сочетание компонентов СПешОафа5е, ОСОМСоппесйоп, 
Оажабопгсе, ОВСг14. Свяжите их обычным образом друг с другом, ОСОМСоп- 
пес 1оп1 свяжите с удаленным сервером ти,уКМОБЕОГ, а набор данных СНепОа- 
фа5её 1 свяжите с ОСОМСоппесНоп1 и с провайдером сервера. 


Рис. 11.15 

Клиентское приложение | 

с произвольными в Борисов 
запросами $01 о 1 == Иванова’ 


Павлов 


| [Баес = Пот Регз \Кеге Оер = 'Цех 1" Огдег Бу Гат | 
[Рагл 


Перенесите на форму также окно ЕЯ, в котором пользователь сможет. 
формировать свои запросы, и кнопку ВиЙоп (выпадающий список справа вни- 
зу на рис. 11.15 будет рассмотрен позднее). 

В обработчик события ОпСгеже формы введите оператор открытия набора 
данных, а в обработчике события ОпСТозе закройте набор. В обработчик щелч- 
ка на кнопке введите операторы: 

С11епеРафа5е*1->С1о5е(); 


С11епсРафа5бе*1->СоттапаТехЕ = Еа1&1->Техе; 
С11еп{Рафабе®1->Ореп(); 


Эти операторы по рассмотренной выше схеме передают на сервер запрос, 
содержащийся в окне ЕаЦ1. 

Как видите, записав всего несколько операторов, вы получили мощное 
приложение. Выполнив его, вы убедитесь, что можете формулировать самые 
разнообразные запросы к серверу. В частности, вы можете связаться с ка- 
кой-то другой таблицей, содержащейся в базе данных. Например, написав за- 
прос “Беес{ * {гот Оер”, вы получите данные не из таблицы Рег$, с которой 
работали до этого, а из таблицы ,ер. 

Спроектированное приложение отличается от рассмотренных ранее воз- 
можностью обрабатывать произвольные запросы БОГ. А в остальном все, рас- 
смотренное в предыдущих разделах, можно реализовать и в данном приложе- 
нии. Вы можете, например, соединить с сервером тиуКМОЗОГ приложения, 
разработанные в предыдущих разделах, и они будут нормально работать, если 
только добавить на сервер обработку запроса о времени обновления данных. 
Просто некоторые операции фильтрации и индексации можно, а иногда и про- 
ще, реализовать через соответствующий запрос. 
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В качестве примера введите в свое приложение выпадающий список (вни- 
зу справа на рис. 11.15), в котором пользователь смог бы выбирать поле, по ко- 
торому хочет индексировать данные. Заполнение этого списка именами полей 
делается так же, как рассматривалось в примерах разд. 11.6. А обработчик со- 
бытия ОпСВапре списка СошфоВох1 можно оформить следующим образом: 

С11еп=Пафа5е®1->С1о5$е (); 

С11еп*Рафабе*1->СомтапаТех* = "5е1есе * Егом Регз огаег Бу " + 

СопроВох1->Тех*; 


С11епРафабе+1->Ореп(); 
С11еп*Рафа5е*+1->ВеЁгезН (); 


Первый оператор закрывает набор данных. Второй формирует текст Сот- 
шапЯТех&, используя имя поля, выбранное пользователем. Последний опера- 
тор открывает набор данных. Поскольку в нем задано значение СоттапТехф, 
то именно этот запрос будет выполняться. 
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В наше время нередко приложения, обеспечивающие работу с удаленными 
базами данных, реализуются в виде серверов УТеБ. Такой сервер может быть 
размещен на каком-то сайте в Интернете или локальной сети, работающей 
с протоколами, принятыми в Интернете. Соединение с таким приложением 
осуществляется с помощью любого стандартного браузера У еБ. 

Доступ к данным из сервера УГеь может быть организован различными 
способами. Если сервер размещен на том же компьютере, на котором находит- 
ся база данных, то никаких проблем нет. Для доступа к базе данных может ис- 
пользоваться любой компонент набор данных, начиная с простейшего компо- 
нента ТаШе. Создание таких серверных приложений, работающих с базами 
данных в Интернете, достаточно подробно рассмотрено в книгах [1], [5] и иной 
литературе. Там же изложены основы языка НТМГ. Так что я буду полагать, 
что читатель знаком с этими вопросами и умеет проектировать серверы У№еь, 
работающие с данными. Но иногда сервер и база данных могут располагаться 
на разных компьютерах. В этом случае можно использовать технологию рабо- 
ты с удаленными модулями данных, описанную в предыдущих разделах, ком- 
бинируя ее с технологией построения серверов \УТефЪ. В данном разделе рассмат- 
ривается именно такой вариант. Но для простоты пусть ваш компьютер высту- 
пает сразу в трех ипостасях: на нем мы зарегистрируем сервер с удаленным 
модулем данных, на нем же мы спроектируем и установим сервер У№еБ, рабо- 
тающий с этим модулем, и на нем же вы будете вызывать этот сервер \У№еБ. 

Построим простое приложение (проект РУ’еБ или РУ’еб2006 в каталоге 
ДазаМоашЕе на приложенном к книге диске), которое должно давать возмож- 
ность пользователю только просматривать таблицу в браузере УТеь (возможно- 
сти редактирования данных рассмотрены в [1] и [5]). В качестве таблицы бу- 
дем использовать ту же таблицу Регз, которую использовали в предыдущих 
разделах. В качестве сервера с удаленным модулем данных будем использо- 
вать проект туАМО, разработанный в разд. 11.1. Если этот сервер не зарегист- 
рирован на вашем компьютере, зарегистрируйте его сейчас. А мы далее сосре- 
доточимся на проектировании сервера \У№еЬ. Хотя выше я говорил, что рассчи- 
тываю на ваши знания в вопросе построения серверов У№ерь, на всякий случай я 
достаточно подробно опишу шаги по его созданию, не вдаваясь при этом в по- 
яснения. 
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Создайте новый сервер У№еЪ. В С++Ви!аег 6 и в предшествующих версиях 
выполните для этого команду Не | Мем | О\ег и в диалоговом окне Меми !етз на 
странице Ме\м/ выберите пиктограмму \\еБ Зегуег Аррйсаноп. В С++Ви!аег 2006 
эта пиктограмма находится в том же окне на странице С++Видег Ргодесь | 
\/еБВгоКег. При выборе этой пиктограммы перед вами откроется окно выбора 
типа модуля. Это окно в С++Ви!аег 6 показано на рис. 11.1ба. В С++ВиПаег 5 
оно выглядит несколько иначе, но достаточно похоже. В С++Ви!аег 2006 
в этом окне отсутствуют третья и четвертая радиокнопки. Выберите в этом 
окне тип модуля СС Зюпа-аюпе ехесмае — выполняемый модуль СОСТ. После 
этого С++Ви!@аег создаст в Редакторе Кода заготовку соответствующего моду- 
ля, и вы увидите окно модуля. 


а) Мезу \уеЬ бегуег Аррйсаноп ^^ — 


мау заес{ Нот опе ое фонит урез ори ойа 
ме А - зегиег эррёсайол$. 


г |бАРИМЗАР Бупалус Ник Быалу 


[о ИЕ В И" 


ва == 
Сет аабеН ОСОМСонпесной1 


с \уМи-сб б4апа-аюле ехесщаЫе | 
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Рис. 11.16. Выбор типа модуля (а) и окно модуля \Мер в С++Вийаег 6 и 2006 (6) 
ив С+-+Вийаег 5 (в) 


Это окно в С+-+Ви!@ег 6 и 2006 существенно отличается от окна в С++Ви!-- 
ег 5. В С++Ви|АЕег 6 или 2006 вы увидите просто пустое в первый момент окно 
(рис. 11.166), в котором можно размещать компоненты, создающие страницы, 
осуществляющие связи с базами данных и т.п. В С++Ви!аег 5 окно модуля 
УТеь является гораздо более информативным (рис. 11.16 в). В его левой панели 
отображается дерево введенных вами действий. Правда, вначале вершина 
АсНоп$ в этой панели будет пустой. Но в дальнейшем, по мере ввода в модуль 
новых действий, они будут синхронно отображаться в левой панели окна моду- 
ля У\еь. Правая панель модуля имеет две страницы. На страницу Сотропеп{ 
вы можете в дальнейшем переносить различные компоненты так же, как 
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в окно модуля в С++ВиПаег 6 или 2006. А страница Шо О'адгат позволяет 
строить диаграммы связей между компонентами. 

В окне Инспектора Объектов вы можете видеть свойства модуля У\УМеь 
(в СЕ+ВиПаег 5 вы увидите их, если выделите в окне рис. 11.16 вершину 
\МеьМо4дше1.). Основное свойство модуля — Ас#1оп$. Это собрание действий — 
объектов типа Т\еБАсйопЦет. Заполняется это список специальным редак- 
тором действий, вызываемым щелчком на кнопке с многоточием в окне Ин- 
спектора Объектов рядом со свойством Ас{10п$. То же окно редактора дейст- 
вий откроется, если вы щелкнете в окне модуля (в С++Ви!аег 5 — на вершине 
\М/еьМодуе1) правой кнопкой мыши и выберете из контекстного меню раздел 
АсНоп Едйог. В открывшемся окне вы можете создавать действия быстрой кноп- 
кой Ада Меч. Нам надо создать в сервере всего одно действие. Создайте его. Вы 
увидите в окне Инспектора Объектов его свойства. Назовите ваше действие 
"Ре!аи{” (свойство Маше) и установите его свойство ОеЁап 4 в фгие. 

Перенесите в окно вашего модуля Уеб компоненты ОЮСОМСоппесйоп, 
и СНешОаёа5е{. Они знакомы вам по предыдущим разделам. Свяжите их 
обычным образом друг с другом и с сервером туАМО. В наборе СПепа- 
фа5её 1 обычным образом, как неоднократно делали в предыдущих разделах, 
настройте поля и введите вычисляемое поле Аже — возраст. В обработчик со- 
бытия ОпСа]еЕ1е14$ введите также рассмотренный ранее текст: 


С11еп*Рафабе*1Аче->Уа1ае = УеакгОЕ (Рафе()) - 
С11епРафа5е*1Уеаг р->Уа14е; 


обеспечивающий расчет возраста сотрудников, и директиву: 


#1п0с1а4е <Чакей®11$.Прр> 


(для версий С++ВиИдег, младше С++Ви!аег 6, в разд. 11.3.2 был показан 
иной способ расчета возраста). 

Теперь, когда в приложении создан набор данных, можно добавить в мо- 
дуль компонент РааЗе Та ШеРгодисег со страницы [п{ете!. Свяжите этот ком- 
понент с набором данных СПеп Дафа е{1, задав его свойство ВабаЗеф равным 
"СПеп{ДафаЗеф1”. 

Свойство Неа4ег компонента ЭаёаЗе Та еРгодисег определяет команды 
НТМЕ, которые должны располагаться в документе перед таблицей. В нашем 
случае это могут быть следующие команды: 

<В м1 > 


<р1>Кадровый состав</ь1> 
<Боау> 


Свойство Еоофег определяет команды НТМГ, которые должны следовать 
после таблицы. В нашем случае это могут быть команды: 

</роау> 

</пЕт1> 

Свойство СарНоп определяет заголовок таблицы. Свойство МахВо\'$ уста- 
навливает максимальное число строк таблицы. Если число записей окажется 
меньше, то число строк таблицы определиться числом записей. Но если число 
записей в таблице больше, то на экран будет выдано только МахКом$ первых 
записей. 

Остальные свойства компонента РаёфаЗеГаеРгодисег легче задавать не 
в Инспекторе Объектов, а в специальном редакторе, который вызывается 
двойным щелчком на компоненте, или из контекстного меню (команда 
Кезропзе ЕдНог). Окно редактора представлено на рис. 11.17. 
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Рис. 11.17 мне ИИ >Сойии$ 
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Основное, что вам надо сделать — указать поля набора данных, которые 
должны отображаться в таблице. Это можно сделать или быстрой кнопкой Ааа 
Ме\ми — добавить поле (левая на рис. 11.17), или кнопкой Ада А| Нез — доба- 
вить все поля (вторая справа на рис. 11.17). Впрочем, эта кнопка будет доступ- 
на, только если при создании объектов полей в СПеп Даёа5е{1 вы воспользо- 
вались редактором полей. При этом все атрибуты отображения полей, введен- 
ные вами в редакторе полей, автоматически перенесутся в отображаемую таб- 
лицу. Если же вы редактором полей не пользовались, вам доступна только 
кнопка Ада Ме\. Причем, при вводе очередного элемента в таблицу вы долж- 
ны будете выделить его в списке на рис. 11.17 ив Инспекторе Объектов уста- 
новить свойство Е1еаМаште — имя поля, а в подсвойстве Сарйоп свойства 
"1 е задать надпись. | 

Элементы в левой панели рис. 11.17 позволяют установить общие свойства 
таблицы. В частности, окошко Вог4ег позволяет задать сетку таблицы 
(на рис. 11.17 ее ширина 1). Окошко У1 определяет ширину таблицы 
в процентах от ширины страницы. Если установить 100%, то при просмотре 
в браузере ширина таблицы будет выбираться автоматически, исходя из ши- 
рины окна браузера, и будет изменяться при изменении ширины таблицы. 
Если задать \14 < 100%, то ширина таблицы будет фиксированной. 

Вот, собственно, все о настройке приложения. Осталось занести в обработ- 
чик события ОпАеИоп единственного действия модуля операторы 

С11еп Рафа5е®1->Ореп (); 


Кезропзе->Сопфепе = РафабееТар1еРгоаисег1->Сопееп® (); 
С]11еп-Рафа5беф1->С1озе (); 


Эти операторы включают и выключают соединение с базой данных и возвра- 
щают в качестве ответа серверного приложения результат, формируемый ком- 
понентом РааЗе Га МеРго4исег1. Сохраните ваш проект под именем РУ’ев 
или РИ’еб2006, скомпилируйте его и перенесите модуль .ехе в исполняемый 
каталог вашего сервера \У’еь. При вызове модуля из браузера (например, 
"ВЫр: //шусотрщег/с51-Ы1шт /РУ\УТеь.ехе", если имя вашего компьютера “ту- 
сотрщег”) вы увидите страницу У\еЪ, представленную на рис. 11.18. 
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Рис. 11.18 
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Мы построили очень простой сервер УТеф. В книгах [1] и [5] показано, как 
его можно усовершенствовать, добавив отображение характеристики и фото- 
графии, введя возможность упорядочивать и фильтровать записи по критери- 
ям, указанным пользователем, обеспечив возможность редактировать данные. 
Не будем останавливаться на этих вопросах. Рассмотрим только возможность 
отображения в сервере совокупных характеристик, которые позволяет вычис- 
лять компонент СПеш ава е{. Само создание полей совокупных характери- 
стик уже было описано в разд. 11.3.1. Посмотрим, как их можно использовать 
в нашем приложении. 

Пусть мы хотим, чтобы форма просмотра данных приобрела вид, пока- 
занный на рис. 11.19. Перед таблицей должна отображаться информация об 
общем числе записей в таблице и о среднем возрасте сотрудников. Для под- 
счета числа записей в таблице введите в компоненте СПеп{Оа{фа$е{1 поле со- 
вокупной характеристики с именем Соипф. Его свойство Ехрге5$10п задайте 
равным "Соцп%(*)". Подсчитать непосредственно средний возраст сотрудни- 
ков мы не можем, так как возраст отображается вычисляемым полем Абе, 
а вычисляемые поля не могут фигурировать в выражениях для совокупных 
характеристик. Поэтому ограничимся пока расчетом среднего года рожде- 
ния. Так что введите поле совокупной характеристики с именем МУеаг 
и свойством Ехргез$1оп равным “`Ауё(Уеаг _Ъ)”. Конечно, можно было бы за- 
писать в свойстве Ехргез$1оп, например, такое выражение: “2004 - 
Ау&(Уеаг Ъ)”. Оно вычисляло бы средний год рождения, но только в 2004 
году. Мы сделаем более универсальный расчет среднего возраёта, но несколь- 
ко позднее и иными средствами. 

Не забудьте установить в фгие значения свойств Аейуе обоих полей обоб- 
щенных характеристик и свойство АротеравезАсйуе компонента СПепОафа- 
Зе. 
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Теперь займемся отображением совокупных характеристик. Для этого до- 
бавьте в модуль компонент ВаёфаЗе{РагеРгодисег со страницы |егте! и свяжи- 
те его свойством Оафа$её с набором данных СШешОафа$ е\. В свойстве 
НТМГОое компонента ЭаёаЗе РагеРгодисег1 напишите текст: 

<ВЕп1><Боау> 

<в1>База данных сотрудников</1> 

<Габ1е м1аЕр="100%" АТ1ап="ЪеЕе"> 

<Ег> 

<Еа><5Егопа>Записей - <#Соцп®></зЕгопа></6а> 
<&а><5&гопа>Средний возраст - <#АуАде></зЕгопа></Еа> 

</Ег> 

</Еар1е> 

<р>&пюзр;</р> 


Этот текст формирует таблицу с двумя ячейками, в одной из которых бу- 
дет отображаться число записей, а в другой — средний возраст сотрудников. 
Вместо значения числа записей в тексте записан шаблон <#Сойпф> (см. о шаб- 
лонах в [1] или [5]). Поскольку имя шаблона совпадает с именем поля совокуп- 
ной характеристики, программа автоматически заменит его значением соот- 
ветствующего поля. А вместо среднего возраста записан шаблон <#АуАхе>. 
Это нестандартный шаблон, который нам надо программно заменить значени- 
ем среднего возраста. Для этого надо написать следующий обработчик события 
ОпНТМГТах компонента ОжаЗе РареРго4исег1: 

Ууо1Аа __Еаз®са11 Т\еБМоац1е1 : ; Рабабе РадеРгоапсег1НТМ!Тач ( 

ТОБ]есЕ *бепаег, ТТад Тад, 
соп5е Ап$156г1па ТаабЗег1па, 
Т5Ег1па$ *ТааРагамз, 


Ап$156г1па &Вер1асеТех®) 
{ 
1Е (Тач5®г1па == "АуАде") 
Вер1асеТех® = ТпЕТоЗ&г ( (116) (УеагкОЕ (Рафе()) - 
С11еп<Рафа5еф1МУеаг->Уа11е)); 
} 


Этот код анализирует параметр Тай5&гтх — имя шаблона. Если это имя 
равно “АуАбе”, то в качестве текста, замещающего шаблон (параметр Вер/а- 
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сеТех{) задается текущий год минус средний год рождения. В С++ВиЙ4ег 5 
код аналогичного обработчика события ОпНТМЕТай может иметь вид: 

1Е (Таа5ег1лпа == "АуАде") 

{ 

Мог Уеаг, Моп®Б, Пау; 

Ресоаераке (Рафе(), Уеаг, МопЕПВ, Вау); 

ВКер1асеТех* = ТпЕТоб%г ( (11%) (Уеаг - С11епеРафабе*1МУеаг->Уа1ае)); 

} 


Для того чтобы текст страницы содержал текст, отображаемый компонен- 
том ЭаёаЗе РасеРго4дисег1, плюс текст таблицы, отображаемый компонентом 
РафаЗе Та ]ерРгодисег1, надо изменить обработчик события ОпАсеНоп дейст- 
вия Ое?аи: 

С11епРафа5беф1->Ореп (); 

ВКезропзе->Сопфеп® = РафабееРадеРгодасег1->СопеепЕ () + 


РабабеЕ Та ]1еРхгоацсек1 ->Сопфеп® (); 
С11еп*Рафабеё1->С]1озе (); 


Этот код суммирует тексты, поставляемые компонентами ОаёфаЗе{Расе- 
Ргодисег1 и ОжаЗе Та МеРго4дисег1. Откомпилируйте приложение и помес- 
тите его в исполняемый каталог локального сервера УТеь. Открыв его браузе- 
ром, вы увидите страницу, показанную на рис. 11.19. 
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На странице библиотеки |тегпе!Ехргез$ имеются два компонента — ХМГ- 
ВгоКег и ше ХРагеРгодисег, обеспечивающие существенное расширение воз- 
можностей сетевых приложений, работающих с удаленными серверами дан- 
ных. Эти компоненты используют язык ХМГ (Ежепаеа МагКир Гапбиаее — 
расширенный язык разметки). Язык ХМ является развитием языка НТМГ. 
Он основывается на той же идее тегов. Только набор тегов ХМ открыт для до- 
бавлений, что и обеспечивает его мощность. Рассматривать язык ХМИ — это 
тема отдельной книги. Да вам и не потребуется знание ХМГ, так как весь код 
С-+-+Ви!аег будет создавать сам. 
` В версиях младше С++ВоПаег 6 вместо компонента ТшеХРагеРгодисег 
на странице |тегпе!Ехргез$ имеется компонент М14азРагеРгодисег. Впрочем, 
и в С++ВаПаег 6 имеется компонент класса ТМ14азРахеРго4дисег, оставлен- 
ный для обратной совместимости. Просто он не включен в страницы палитры 
библиотеки. Но его можно использовать в проектах, включив в проект дирек- 
тивой шие модуль МаРтоа: 


#1пс1иае <МлаРгоа.Врр> 


и добавив в описание класса формы в раздел рмуафе оператор: 


ТМ1АаазРааеРгоасег *М1АазРадеРго@исек1; 


Давайте рассмотрим работу с компонентами ХМ ВгокКег, ше ХРахеРго- 
Чисег и М14азРасеРго4дисег. Будем работать все с тем же сервером данных 
тиуКМО или туйМО2006, который построили в разд. 11.1, и создадим для 
него новое клиентское приложение (проект РХМГ или РХМГ.2006 на диске, 
приложенном к книге). Приложение будет намного мощнее рассмотренного 
в предыдущем разделе. Причем для его реализации нам не придется написать 
ни одного оператора. 
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Создайте, как описано в разд. 11.8, новый сервер УТеь, перенесите в него 
компонент ОСОМСоппесйоп и свяжите его с нашим сервером данных туйМО 
или туВМЛО2006. Но вместо набора данных СПеп Оафа5 её, использовавшего- 
ся в предыдущих разделах, перенесите в модуль компонент ХМЕВгоКег со 
страницы |тчегте!Ехргез5. Этот компонент осуществляет обмен данными между 
приложением У\еь и сервером. Полученные от сервера пакеты данных этот 
компонент преобразует в формат ХМГ и передает браузеру вместе с тегами 
языка НТМГ и командами Дауабсг!р%, отображающими интерфейс пользовате- 
ля. Свяжите ХМГВгокКег его свойством Ветое$егуег с компонентом ОСОМ- 
Соппесйоп и свойством Ргоу14егМате с поставщиком ОЗРРег$ на сервере. 
Свойство Соппес%е4 устанавливает и разрывает связь ОВСОМСоппесйоп с по- 
ставщиком данных. Все это не отличается от того, как мы вводили в модули 
предыдущих приложений компонент СПешОафа5еф. 

Теперь добавьте в модуль компонент шеХРазеРгодисег или М!9аз- 
РасеРго4дисег (в версиях младше С++ВаИ4ег 6), который будет генерировать 
страницы для браузера. Поскольку в этих страницах используется язык 
«ауазсг1р®, в свойстве а4еРа ВОВТ, этого компонента нужно указать полный 
путь к библиотекам ауаЗсг1р% на вашем компьютере. Например, в С+--+Ва!Паег 6: 


.../Ргодгам Е11]ез/Вог1апа/СВи114ег6/5оигсе/Иерм1ааз/ 


или в С++Воа!аег 2006: 


.../Ркоагкам Е11ез/Вог1апа/ВО$/4.0/зочгсе/М1п32/Мерм1Ааз / 


На конкретном компьютере путь может быть иным. Важно, что библиоте- 
ки лежат в каталоге СВа!аег... /\УМебт1Аа$/. 

Добавьте в модуль действие Оеаи Ц, работающее по умолчанию, и в его 
свойстве Ргодисег дайте ссылку на компонент шеХРасеРгодисег или М19аз- 
РагеРго4исег. Теперь осталось только настроить форму выдачи результатов 
компонентом ше ХРагеРгодисег или М1д4азРагеРгодиеег, и приложение бу- 
дет закончено. 

Настройка шеХРагеРгодиеег или М14азРагеРгодисег производится спе- 
циальным редактором, который вызывается двойным щелчком на компоненте 
или щелчком на кнопке с многоточием около свойства УебРагеЦетз в окне 
Инспектора Объектов. Окно редактора показано на рис. 11.20. В левой верх- 
ней панели окна формируется дерево основных блоков отображения. В правой 
верхней панели отображаются элементы, входящие в блок, выделенный в дан- 
ный момент в левой панели. Нижняя панель состоит из двух страниц. Страни- 
ца Вгоуузег позволяет видеть результаты проектирования в том виде, в каком 
их будет видеть пользователь в окне браузера. На этой же странице в процессе 
проектирования будут отображаться замечания, указывающие, в частности, 
для каких вводимых вами элементов не заданы все необходимые свойства. 
Страница НТМ( показывает текст формируемой страницы. Впрочем, этот текст 
вы можете только видеть, но редактировать его невозможно. 

Для начала разработки страницы У\УеЬ выделите в левой панели окна вер- 
шину [пе!ХРадеРгодусег1 и нажмите в окне редактора быструю кнопку Ме\м 
Сотропеп: (левая на рис. 11.20), или выберите соответствующий раздел из кон- 
текстного меню, всплывающего при щелчке правой кнопкой мыши в окне ре- 
дактора, или нажмите клавишу быстрого доступа |пзей. Всплывет окно 
(рис. 11.21 а) со списком, содержащим три раздела: Ос!аГогт — форма пред- 
ставления данных, ОоегуГогт — форма ввода и вывода каких-то параметров, 
передаваемых по ссылке какой-то другой странице, |[ауо\\Сгоур — следующая 
группа блоков отображения. 
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Рис. 11.21. Окна выбора блоков и элементов отображения 


Выберите раздел РаюГогт. В левой верней панели окна рис. 11.20 появит- 
ся вершина ОсаГогт1. Выделите ее, и опять нажмите быструю кнопку Ме\м 
Нем, или выберите соответствующий раздел из контекстного меню, всплываю- 
щего при щелчке правой кнопкой мыши в окне редактора, или нажмите кла- 
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вишу быстрого доступа |пзей. Перед вами появится окно (рис. 11.21 6), содер- 
жащее элементы, которые могут быть размещены на форме. Мы хотим, чтобы 
наша страница \У!еЬ имела вид, представленный на рис. 11.22. Для этого нам 
потребуются РааСпа — таблица, отображающая заданное число записей набо- 
ра данных, ОаюМамааюг — навигатор по набору данных и Не4Сгоур — группа 
полей, отображающих указанные поля текущей записи набора данных. Выбе- 
рите эти элементы и нажмите ОК. На левой панели окна рис. 11.20 появятся 
соответствующие вершины. Поскольку мы хотим, чтобы вверху страницы 
(см. рис. 11.22) размещался навигатор, ниже — группа полей, а еще ниже — 
таблица, установите в окне рис. 11.20 требуемую последовательность вершин, 
используя кнопки со стрелками. 
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В нижней панели отобразятся замечания, связанные с тем, что многие 
свойства введенных блоков отображения пока не определены. Начнем уточне- 
ние характеристик и состава этих блоков с таблицы — вершины ВаюСпа1. Вы- 
делите эту вершину и посмотрите в Инспекторе Объектов ее свойства. Основ- 
ное свойство, обеспечивающее связь таблицы с набором данных — ХМ Вго- 
Кег. Выберите в этом свойстве набор данных ХМ ВгоКег{. Свойство Р1зрау- 
Во\м$ задает число строк таблицы. Свойства НеадтеА г ще$, Ком А т- 
ше и ТаеА г ще$ определяют соответственно объекты атрибутов заго- 
ловка, строк и таблицы в целом. Атрибуты таблицы в основном подобны тем, 
которые рассматривались в разд. 11.10 для компонента ОаёаЗе{ГТаеРго4и- 
сег. А остальные атрибуты мы рассмотрим позднее. Пока можете принять все 
их значения по умолчанию. 

После того как вы установили свойство ХМ ВгоКег, в нижней панели 
окна рис. 11.20 под окном со все еще имеющимися замечаниями появится вид 
отображаемой таблицы. По умолчанию в нее включены столбцы всех полей. 
набора данных плюс столбец состояния, о котором будет сказано ниже. Заго- 
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ловки столбцов совпадают с именами соответствующих полей. Все это, конеч- 
но, не устроит пользователя. Так что надо отобрать нужные столбцы и русифи- 
цировать заголовки. Щелкните на вершине ВаюСиа!] правой кнопкой мыши. 
Во всплывшем меню вы увидите, в частности, раздел Ада А! Нез — добавить 
все поля и раздел Ааа Нез — добавить поля, выбранные из списка. Можете 
воспользоваться любым из них для добавления нужных полей. В нашем при- 
мере нам в таблице будут нужны все поля, кроме Ми (это поле пользователю 
не интересно), Эех, СВагас& (эти поля мы отобразим отдельно) и графического 
поля РВофо. Можете выбрать нужные поля из списка раздела Ааа Нез, или 
добавить все поля разделом Ада А! Небф$, а затем удалить ненужные клавишей 
Оеее. 

В правой верхней панели окна рис. 11.20 появятся имена полей. Если вы 
использовали для ввода полей раздел А! Не|‹$, то среди понятных имен вы уви- 
дите имя {а 1$Соитп1. Если вы использовали раздел Ада Нез, то еще раз 
выполните эту команду и добавьте Эа и$Соитп. Это будет колонка состоя- 
ния, в которой отобразится состояние данной записи. Если значения полей за- 
писи пользователем не изменялись, значение в этой колонке будет пустым. 
Если значение какого-то поля изменялось пользователем, но это изменение 
еще не зафиксировано в базе данных, то в колонке состояния в соответствую- 
щей строке появляется символ “М” (см. первую ячейку первой строки табли- 
цы на рис. 11.22). У новых вставленных записей в колонке состояния появля- 
ется символ “[". 

Выделите какое-то поле в правой верхней панели окна и посмотрите его 
свойства в окне Инспектора Объектов. Вы увидите свойства, позволяющие оп- 
ределить вид отображения в таблице данного поля: Сарйоп — надпись в заго- 
ловке таблицы, которую можно русифицировать, О1$р1ау 14 — число сим- 
волов, определяющее ширину колонки, КеаЯОп]у — запрещение пользовате- 
лю редактировать данные. Сделайте для всех колонок русские надписи и уста- 
новите желательную ширину колонок. 

Давайте посмотрим, какие еще колонки можно включать в таблицу. Выде- 
лите в левой панели вершину ОоюСпа|] и нажмите кнопку Мом Нет. Перед 
вами появится окно (рис. 11.21 в), содержащее типы колонок, которые вы мо- 
жете включить в таблицу: ТехСоштп — текстовое однострочное окно, ТехАгеа- 
Соутп — многострочное текстовое окно, ЗеесЮрноп$Соитп — выпадающий 
список. Многострочное окно подошло бы нам для отображения характеристи- 
ки. Но его неудобно размещать в строках таблицы, так как оно займет много 
места. Мы используем в дальнейшем этот элемент вне таблицы. А выпадаю- 
щий список очень полезен, например, для отображения отделов, в которых ра- 
ботают сотрудники. Тогда для перевода сотрудника из одного отдела в другой 
пользователю не надо будет писать название нового подразделения, а достаточ- 
но выбрать его из списка. Это гарантирует от ошибок в написании наименова- 
ний отделов. Так что выберите в окне рис. 11.21 в) раздел З@аесОрноп$Соитп. 
В правой панели появится вершина 5еесЮрНоп$Соитп1. Выделите ее. Вы уви- 
дите в окне Инспектора Объектов ее свойства. В свойстве Е1еаМате вам надо 
задать для этой колонки поле Оер (чтобы задать поле просто выбором его из 
списка, серверное приложение должно в этот момент выполняться). В свойст- 
во Цетб$ занесите список возможных отделов. Замените этой колонкой введен- 
ную ранее колонку Отдел, как это показано на рис. 11.20 и 11.22. 

Проектирование таблицы можно считать завершенным. Теперь давайте 
обратимся к проектированию навигатора. Выделите в левой панели вершину 
ОааМамдаюг] и посмотрите в Инспекторе Объектов ее свойства. Основное 
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свойство ХМГСотропеп — элемент, которым будет управлять навигатор. 
В нашем случае навигатор относится к спроектированной вами таблице дан- 
ных. Так что в свойстве ХМЕСотропеп& надо установить ВаёйаСга1. Теперь 
посмотрите в нижней панели вид навигатора. Он не очень удачен. Вы увидите, 
что помимо обычных кнопок навигации он содержит кнопки с надписями 
"Опао” (отмена результатов редактирования), “Роз” (пересылка изменений 
в базу данных), "Арр!у Ор4жез” (фиксация изменений в базе данных). Все это 
очень полезные функции, но вряд ли английские надписи порадуют ваших 
пользователей. 

Чтобы русифицировать навигатор, выделите его вершину и нажмите 
кнопку Ме\уи ем. Перед вами появится окно, содержащее список всех кнопок 
навигатора. Выделите их все, кроме |[ауоСгоур, и щелкните на ОК. Внешне 
ничего не изменится, так как вы оставили в навигаторе все кнопки. Но теперь 
при выделении в левой панели вершины ОаюМамааюг] вы увидите в правой 
панели список кнопок. Выделив любую из них, вы увидите в Инспекторе Объ- 
ектов ее свойства. Для кнопок ОпдоВиЙопв1, РозВиНвЙоп1 и Арр!уОрдафе5- 
ВиНоп1 следует указать русские надписи — СарИоп. Например, "Отменить", 
“Переслать”, “Записать”. Если хотите, можете удалить какие-то из кнопок на- 
вигатора. Например, если вы не хотите разрешать пользователю удалять су- 
ществующие записи и вставлять новые, вам надо убрать клавишей Вее!е кноп- 
ки шзегВиЙоп1 и ВеаееВиИЙоп1. 

Вам осталось настроить группу полей Не4Стоур, которая пока пуста. 
А в соответствии с рис. 11.22 мы хотим разместить в этой группе многостроч- 
ное окно, отображающее характеристику сотрудника, соответствующего теку- 
щей записи таблицы, и группу радиокнопок, отображающую пол сотрудника 
(не лучшее решение, но мне хотелось разнообразить пример и показать этот 
элемент). 

Выделите в левой панели вершину Не9Сгоур и посмотрите в Инспекторе 
Объектов ее свойства. Прежде всего, вам надо связать через свойство ХМЕГ- 
ВгоКег эту группу полей с набором данных ХМГВгоКег1. Теперь нажмите 
кнопку Ме\и !№е\и. Перед вами появится окно (рис. 11.21 г), содержащее список 
возможных типов полей группы. Выберите из него НеЗТех!Агеа для отображе- 
ния характеристики и Неа КааюСгтоур для отображения пола. 

Многострочное окно НеТежАгеа надо связать его свойством Е1е]ЧМаше 
с полем СВагасе%. Размеры окна задаются свойствами О15р!ауКо\м$ — число 
строк и О1$р1ау 14 — число символов в строке. Задайте в нашем примере 
015 р1ауВо\м5$ = 10 и Оз рау 14 = 50. Свойство СарИоп определяет надпись, 
появляющуюся около окна. Ее естественно записать по-русски, например, 
Характеристика”. Свойство СарИопРо510оп определяет, с какой стороны от 
окна появится надпись: сарГеЁё — слева, сарВлеВ — справа, сарАБоуе — 
сверху, сарВе!о\ — снизу. Свойство Угар определяет правила переноса 
в окне длинных строк. Оно определяет параметры тега ТЕХТАКВЕА и может 
принимать значения: | 


——_ — 


Значение ‚‘араметр тега | Пояснения 
| УГО ОРЕ 


В тексте сохраняются переходы на новую строку, 
которые в нем содержатся, но никаких дополни- 
тельных переносов не делается. При этом часть 
текста длинных строк может быть не видна. 

В этом случае в окне появляется полоса горизон- 
|. — — | тальной прокрутки. 


11.11 Компоненты, работающие с ХМЕ 955 


Значение (Параметр тега | Пояснения 


мгР|Вуз1са! |РНУЗТСАГ 


Длинные строки переносятся так, чтобы не оказа- 
лось невидимого текста. Вновь введенные перехо- 
ды на новую строку заносятся в исходный текст. 


Длинные строки переносятся так, чтобы не оказа- 
лось невидимого текста, но исходный текст не из- 
меняется, т.е. вновь введенные переходы на но- 
вую строку не заносятся в него. 


мгУп{иа1 (УЩВТОАГ, 
| 


Группу радиокнопок НезКаЧюСгтоир надо связать свойством Ее 9 Мате 
с полем Зех. Свойства СарИоп и СарНйопРо$10п определяют так же, как 
в НеаТежАгеа, надпись, появляющуюся около группы радиокнопок. Свойство 
Цетз типа Т56гше$ содержит список надписей радиокнопок. Сколько строк 
занесено в этот список, столько радиокнопок появится в группе. В нашем слу- 
чае, очевидно, должны быть две кнопки: “м” и “ж”. Свойство Уаез$ типа 
Т5Иите$ содержит список значений поля, соответствующих кнопкам. значе- 
ния записываются в текстовом виде в той же последовательности, в которой 
записаны надписи кнопок в списке Цетз. В нашем случае свойство Уаше$ 
можно не заполнять, так как значения в свойстве Цетз совпадают со значе- 
ниями поля. Но можно было бы, например, в свойстве Цетз$ записать названия 
кнопок "мужской" и "женский". Тогда в свойстве Уаше$ надо было бы напи- 
сать “м“и "ж”". 

Проектирование приложения закончено. Можете откомпилировать его, 
поместить файл .ехе в исполняемый каталог локального сервера и выполнить. 
Вы увидите (рис. 11.22), что с помощью навигатора можете перемещаться по 
таблице базы данных. При этом в поле характеристики и группе радиокнопок 
будут отображаться данные, соответствующие текущей записи. Если вы что-то 
измените в текущей записи и перейдете к другой записи или нажмете кнопку 
Переслать, то в колонке состояния соответствующей строки таблицы появится 
символ "М". При нажатии кнопки Отменить результаты редактирования отме- 
нятся, и пометка в колонке состояния исчезнет. Можете проверить и другие 
режимы работы. Вы убедитесь, что, не написав ни одного оператора, создали 
мощное приложение для работы в Интернете с удаленной базой данных. 

В заключение остановимся на некоторых особенностях оформления отобра- 
жаемых результатов, которые мы пока пропускали. Вы можете задать заголо- 
вок отображаемой страницы документов и вставить на нее любые компоненты 
и тексты. Для этого выделите в окне редактора шеХРагеРгодисег корневую 
вершину пе!ХРавеРгодусег! или просто выделите сам этот компонент. В окне Ин- 
спектора Объектов вы увидите свойство — НТМГ.Оос. Это код НТМГЕ докумен- 
та, составленный автоматически. Но вы можете его изменять, как хотите. На- 
пример, между тегами <НЕАО> и </НЕАУ> вы можете вставить заголовок: 


<р2>База данных сотрудников</В2> 


В результате вы получите заголовок, который можете видеть на рис. 11.20 
и 11.22. 

Во всех элементах отображения: колонках, окнах, кнопках вы могли ви- 
деть свойство Сизфот. Оно же в качестве подсвойства фигурирует в свойствах 
Неа тгА г ще$ (атрибуты заголовка), ВомА тг! ез$ (атрибуты строк), 
Та еАНгЬще$ (атрибуты таблицы) таблицы данных ОаёаСн@4, в свойствах 
СарйопАИгЮще$ колонок таблицы и окон группы полей. Это свойство имеет- 
ся также в группе полей НезСгочур и в форме ВаёаЕогт. Если в них задать это 
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свойство, то оно будет относиться сразу ко всем элементам, входящим в груп- 
пу или форму элементам. В свойство Си$от можно записать параметры соот- 
ветствующих тегов НТМЕ, определяющих форматирование. Эти параметры 
записываются в свойстве Сизбот в виде 


<параметр>=<значение> 


Пробелы в этой записи недопустимы. А если требуется записать несколько па- 
раметров, то они разделяются пробелами. Например, приведенный ниже текст 
в свойстве ТаЁеА г ще$ таблицы приведет к уничтожению разделительных 
линий между колонками: 


ЕКАМЕ=НсТрЕЗ КОТЕ$=ВОИ5 


Теперь рассмотрим свойство 5$Уе, которое также фигурирует в таблице, 
колонках, полях, надписях, группах, формах. В это свойство можно записы- 
вать параметры, которые будут включаться в генерируемый текст как значе- 
ние свойства ЭТУГЕ. Например, если вы запишете в свойстве 5&е вершины 
НеСтоур значение: 


Еоп&-ЁЕам11у: сочк1ег; ЕопЕ-метзав®: ро1а; ЁЕоп&-$12е: 20рх 


то надписи многострочного окна редактирования и группы радиокнопок будут 
отображаться жирным шрифтом "соитег” размером в 20 пикселов. 

В ряде случаев одни и те же стили могут фигурировать в разных частях 
отображаемой страницы. Чтобы выдержать стилистическое единство страни- 
цы, удобно один раз описать стили, которые вы будете использовать, а. затем 
ссылаться на них в различных частях вашей страницы. Это делается следую- 
щим образом. Выделите в окне рис. 11.21 корневую вершину пеХРадеРго- 
Чосег! или просто выделите сам этот компонент. В Инспекторе Объектов вы 
увидите свойство 5{Уе$ типа Т5&г1те$. В это свойство вы можете занести стро- 
ки, определяющие вводимые вами стили, в формате: 


.<имя стиля> {параметры} 


Определение начинается с символа точки. За ним следует произвольный 
идентификатор, который вы присваиваете стилю. А затем через пробел запи- 
сываются в фигурных скобках параметры стиля, отделяемые друг от друга 
точками с запятой. Например, вы можете определить следующие стили: 


.Во1Аа {Еопе-мелайе: Бо1а} 
.Неааег {ЁЕопе-Еам1]у: сочг1ег; Еопе-мезав®: рРо1а; оп $172е: 20рх} 


Первый из них соответствует жирному шрифту, не определяя его имя 
и размер, которые будут взяты по умолчанию. А второй стиль определяет кро- 
ме этого имя и размер. 

Далее вы можете использовать введенные вами стили в любой части про- 
екта. Для этого служат свойства 9$Уе В ще элементов \У\еЬ. Например, если вы 
установите для вершины НезСгоур! значение 54УеВ ще, равное “Во]4” или 

`Неа4ег”, то надписи элементов этой группы будут определяться одним из 
описанных выше стилей. 

Другой вариант задания стилей — запись их в текстовый файл по тому же 
формату, который описан выше для свойства 5%Уе5. Эти стили можно исполь- 
зовать, если вместо свойства 54е$ задать свойство 5е5ЕЙе — файл, содер- 
жащий определения стилей. Использование файла позволяет обеспечить един- 
ство стилей не только внутри одной страницы У/еБ, но и в различных страни- 
цах и в различных приложениях. 


Предметные 
и тематические указатели 


Предметный указатель 


Ниже дается алфавитный указатель основных функций, классов, свойств, 
методов, терминов, рассмотренных в книге. Сначала дается соответствующий 
идентификатор, потом выделенная жирным шрифтом дается ссылка на 
раздел, в котором содержатся основные сведения о нем, а затем — ссылки на 


разделы, содержащие дополнительную информацию. 
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В$ НАТСНЕЮ, гл. 8, 5.5.1 

В НОШОМ. В МОШ,, гл. 8 

В РАТТЕВМ. ВЗ РАТТЕВМ8Х&8, гл. 8 

В$_ЗОПЮ, гл. 8 

САШВАСК СНОМК_ЕИМЗНЕЮ, гл. 8 

САШ.ВАСК БТВЕАМ_БУТТСН, гл. 8 

Са]Мех&НооКЕх, гл. 8, 4.3 

СапсеЦо, гл. 8, 6.7.1 

Сапсе1\ММаЦаеТ!1тег, 3.6 

СВВ‚, 2.5.1 

СЕ ВТМАЬР, гл. 8, 3.11 

СЕ СОМРОМЕМТ, гл. 8, 3.11 

СЕ МЕТАЕП.ЕРТСТ, гл. 8, 3.11 

СЕ РИСТОВЕ, гл. 8, 3.11 

СЕ _ТЕХТ, гл. 8, 3.11 

СВапеСПрЬоагаСВа1т, 3.11 

СПапёеП!т, 10.4.1 

СрапееП1гОр, 10.4.3 

СВагТоОеш, гл. 8 

СВагТоОетВуы{Ё, гл. 8 
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СЬГу:, 6.6.5, 6.6.2 | Сгеа{еРо|уРо!убопВ т, гл. 8 
СБескМепиЦе, гл. 8 Сгеа$еРгосез$, гл. 8, 3.7, 1.4 

Срога, гл. 8 СгеафеКес& В, гл. 8, 5.3.1.1, 5.3.1.2 
СеагСоттВгеак, гл. 8, 2.5.2 Сгеа{еКес&Вепта1гес%, гл. 8, 5.2.2.1 
С!еп{)афа5еф, 11.4, 11.3.1 Сгеа&еКоипаВес* Во, гл. 8, 5.2.2.1 
СМР _РЕРАОГТ РВЕСТУ, 1.14 СтеафеЗетарроге, гл. 8, 3.4 
СИрьЬоага, 3.11 СтежезопаВгазВ, гл. 8 

СПрСигзог, 2.4.2 Сгеа{$еТ\геаа, гл. 8, 3.8, 6.6.4 
С]озеНапа@е, гл. 8, 2.5.1, 6.1.2, 6.1.2, 6.7.1 | СгежеТооШе!р3 25 парзВо%$, 3.10 
С]озе\М/14о\м,, гл. 8, 5.1.4, 5.1.1 Сгеафе\МаЦца]еТ1тег, гл. 8, 3.6 
Со{!#2От{.ехе, 4.2.5 | сгМоРоз$, 10.5.4 

СошштеВеп, гл. 8, 5.2.2.1 сгТетрОпауаЦае, 10.5.4 
СотрагеТехф$, 5.1.3 СШ ВГТВОСКЕТ, гл. 8, 6.2 


СОМРВЕЗЗ!ОМ ЕОВМАТ ОЕЕАТОГТ, гл. 8 | СЫШОГ СОМТВОГУ, гл. 8, 6.2 
СОМРВЕЗОМ _ЕОВМАТ_ГАМТ1, гл. 8 СШ, РЕЗКТОР, гл. 8, 6.2, 6.5 
СОМРВЕЗЗЮМ_ЕОВМАТ_МОМЬ, гл. 8 СБШГ РЕЗКТОРОЬЩВЕСТОВКУ, гл. 8, 6.2 


Сору, 6.8 СШ РЕУЕФ, гл. 8, 6.2 
СОРУ ЕП.Е КАП, ТГ ЕХТЬ, гл. 8 СЫТОГ. РОМТЬ, гл. 8, 6.2 
СОРУ_ _ЕП.Е ВЕБТАВТАВИГЬЕ, гл. 8 СБОГ МЕТНООКЮ, гл. 8, 6.2 
СоруЕ Пе, гл. 8 СШ МЕТУОВК, гл. 8, 6.2 
СоруЕПеЕх, гл. 8 СЫГОГ. РЕВЗОМАТ, гл. 8, 6.2 
СоруЕ!еТо, гл. 8 СЫТОГ РЕМТЕКВЪ, гл. 8, 6.2 
СоруЕгош, 6.9 СЗТОГ РВОСВАМО, гл. 8, 6.2 
со$, 5.5.3 СЫТОГ, ВЕСЕМТ, гл. 8, 6.2 
сгАц$ И Веаигеа, 10.5.4 СБШГ, БЕМОТО, гл. 8, 6.2 
сгСапРоз$, 10.5.4 СОВЗОВ, 4.1.3 

СВЕАТЕ_ АГУ\УГАУЬ, гл. 8, 6.71.1, 6.7.2 ПаёаВеццез$, 11.5 

СВКЕАТЕ РЕКГАОТТ_ЕВВОВ_МОГПЬЕ, гл. 8 | РафаЗеф, 11.3.1 

СВЕАТЕ МЕ\М,, гл. 8, 6.7.1, 6.7.2 Пафабе{Рго\1аег, 11.3.1 
СВЕАТЕ МЕХМ/ СОМБОГЕ, гл. 8 Дафабопгсе, 11.3.1 


СВЕАТЕ_МЕ\М_РЕОСЕЗ$ СВОТР, гл.8 | Га, 11.5 
СВЕАТЕ ЗЕРАВАТЕ_\/О\/ УШМ, гл. 8 | РафеТииеТоЗ@ Театр, 1.15.1 


СВЕАТЕ ЗНАВЕР \УО\’ УШМ, гл. 8 ОабеТ!пеТоз%е, 1.15.2, 6.6.1 

СВЕАТЕ_ БОЗРЕМОЕЮ, гл. 8, 3.8 Оа{еТипеТоби1то, гл. 8, 1.15.3, 2.3.5, 3.17 
СКЕАТЕ ОМ1СОРЕ_ЕМУ1ВОММЕМТ, гл. 8 | ОаёеТппеТоБузетТие ‚ гл. 8, 1.15.1 
Сгеж{еВгиз тА1гесф, гл. 8, 5.5.1 ОаёеТ!пеТоТипе $аштр, гл. 8, 1.15.1 


Стеа{е Е рИсВогт, гл. 8, 5.2.2.1, 5.3.1.3 Рау, 11.5 
Сгеа&еЕШрисВопштА1гес%, гл. 8, 5.2.2.1 ОВСи1а, 11.3.1 


СгежфеЕуепф, гл. 8, 3.5, 2.5.3 ОВГлтаёе, 11.3.1 

СгежеЕ\е, гл. 8, 2.5.1, 6.1.2, 6.7.1 ОВМешо, 11.3.1 

СгеафеГопф, гл. 8, 1.14 ОВМау!афюог, 11.3.1 
Сгеа$еКоп М пА1гесф, гл. 8, 1.14 ОСВ, 2.5.1 

СгеафеНа{& с ВгизЬ, гл. 8 ОСОМ, 11.1 

СтеафеМуфех, гл. 8, 3.3 ОСОМСоппес оп, 11.3.1 

Сгеа4еРа “егпВгизВ, гл. 8 РЕВОС_ОМГУ_ ТН! РКВОСЕБУ, гл. 8 
СгеафеРеп, гл. 8, 5.5.1, 1.6, 5.5.3 - РЕВОС _РВОСЕБЬ, гл. 8 


Сгеа&еРо|узопВ ог, гл. 8, 5.2.2.1, 5.3.1.3 РЕКГАОГТ_СНАВБЕТ, 1.14 


Предметные и тематические указатели к книге 


РЕКАОГТ СОТ РОМТ, гл. 8 
РЕГАОТТ_РТТСН, 1.14 
РЕРАОГТ ООАШТУ, 1.14 
еее, 5.5.3 

еще, 10.4.1, 10.4.3 
Оее$еАфот, 1.16 

ОеееЕ\!е, гл. 8, 6.8, 1.1 
РевеМепл, гл. 8, 5.2.1, 2.4.2 
ОеефеОБесф, гл. 8, 1.14 
Оез$гоу\/ т9о\, гл. 8 
ОЕТАСНЕО РВОСЕБУ, гл. 8 
РЕУ[ГСЕ РЕРАОТТ РОМТ, гл. 8 
еу1сеТоСопф$го/|, гл. 8, 6.1.2 
АРХМГ, 11.4 

АРХМГОТЕ8, 11.4 

ОГ СОМРАТ, 5.4.3 

ОТ РЕРГАОГСТЬИЕ, 5.4.3 

ОЗ САВЛАВИЕ, 4.1.3 

ОЗК СЕОМЕТВУ, 6.1.2 
01$КЕгее, гл. 8 

01$3Кб1те, гл. 8, 6.1.1 
ОКСКАУ_ВКОБН, гл. 8 

ОМ, РВОСЕБЗЗ АТТАСН, 4.2.2 
ОМ, РВКОСЕЗЗ ПЕТАСН, 4.2.2 
ры, ТНКЕАО АТТАСН, 4.2.2 
ОГ, ТНВЕАО ПЕТАСН, 4.2.2 
ОПЕп%гуРо!1%, 4.2.2 
ОоСоштапа, 10.4.1 

По\шоаа, 10.4.1 
Помп]оааВезфоге, 10.4.1 
ОКБАЕТ ООАШЫТУ, 1.14 
ОгахАссер Е 1ез, гл. 8, 6.11 
Ога&Е1т13В, гл. 8, 6.11 
Ога@иегуЕ Це, гл. 8, 6.11 
ОгауМсоп, гл. 8, 5.4.3, 5.4.1 
Огам[сопЕх, гл. 8, 5.4.3 
Ога\м/Тех+, 5.5.1, 1.6 

ОВТГУЕ СОВОМ, 6.1.1 

ОВТУЕ _ЕТГХЕО, 6.1.1 

ОНУЕ ВАМПОГЗК, 6.1.1 
ОВТУЕ ВЕМОТЕ, 6.1.1 
ОВТУЕ ВЕМОУАВГЕ, 6.1.1 
ОТ ВОТТОМ, 5.5.1 

ОТ САГСВЕСТ, 5.5.1 

ОТ СЕМТЕВ, 5.5.1, 1.6 

ОТ ЕОГТСОМТВБОГ, 5.5.1 

ОТ ЕМО ЕМЛРЬГ, 5.5.1 
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ОТ ЕХРАМОТАВУ, 5.5.1 

ОТ ЕХТЕВМАГГЕАОГКС, 5.5.1 

ОТ ГЕЕТ, 5.5.1 

ОТ МОРОТЕУБТЕТМС, 5.5.1 

ОТ МОСЫР, 5.5.1 

ОТ_МОРВЕЕ[Х, 5.5.1 

ОТ_РАТН_ЕШИЛРЗУГ, 5.5.1 

РТ ВСОНТ, 5.5.1 

ОТ УМОГЕШЪЬ, 5.5.1 

ОТ ТАВБЕТОР, 5.5.1 

ОТ ТОР, 5.5.1 

ОТ УСЕМТЕК, 5.5.1 

ОТ_\УОВОВВЕАК, 5.5.1, 1.6 

Ам’Ргосез$@, 3.7 

А\мТЬгеаа1Та, 3.7 

ЕАССЕВ, 6.8 

Есро, 10.2 

ЕШрезе, гл. 8, 1.6 

ЕМ СЕТЗЕГТЕХТ, 5.1.1 

ЕМ ЭТВЕАМГТУ, 5.1.1 

ЕМ ЭТВЕАМОСОТ, 5.1.1 

Епа ]еМепиЦеа, гл. 8 

Епа ]е\119до\,, гл. 8, 1.7 

Епсо4е)афеТ!те, 3.6 

ЕМОБЗЕЗЗОМ ГОСОЕГЕ, 2.2.1 

ЕпашСЬПа\/1т доу, гл. 8, 5.1.2 

ЕпитВезопгсеМатез, гл. 8, 4.4.1 

Епит М 119 о\, гл. 8, 5.1.3 

ЕВКОВ АГКВЕАОУ_ЕХТЗТЬ, 3.3, 3.4, 3.5, 
3.6 

ЕВКОКВ 1МУАБО НАМОЕГЕ, 3.3 

ЕВКОВ ТМУАПГО РАКВАМЕТЕК, 2.1.5 

ЕВВОВ ТО ТМСОМРЕЕТЕ, 6.7.1 

ЕВКОВ ТО _РЕМОГУС, 2.5.3 

ЕВКОВ МОТ БОРРОВТЕФ, 3.6, 6.1.1, 
6.7.2 

ЕУ ВВЕАК, гл. 8, 2.5.3 

ЕУ _СТЬ, гл. 8, 2.5.3 

ЕУ ОББ, гл. 8, 2.5.3 

ЕУ ЕВВ, гл. 8, 2.5.3 

ЕУ ВМС, гл. 8, 2.5.3, 2.5.5 

ЕУ ВТО, 2.5.3 

ЕУ ВХСНАК, 2.5.3 


ЕУ ВХЕГАС, 2.5.3 


ЕУ_ТХЕМРТУ, 2.5.3 
ЕУЕМРАЕ!ТУ, 2.5.1 
ЕУЕМТ АШ, АССЕБЗВ, 3.5 
ЕУЕМТ МОРТРУ _Б5ТАТЕ, 3.5 


960 


ЕХУХ _РОВБСЕ, гл. 8 

ЕМУХ ГОСОЕЕ, гл. 8, 2.2.1 

Е\МУХ РО\МЕВОЕЕ, гл. 8, 2.2.1 

ЕХМУХ_ВЕВООТ, гл. 8, 2.2.1 

ЕУМУХ ЗНОТРООУХМ, гл. 8, 2.2.1 

Ех! Ргосез$, гл. 8, 3.17 

Ех ТЬгеаа, гл. 8, 3.8 

Ех \М/ пом Ех, гл. 8, 2.2.1 

Ех%СгеафеВез1оп, гл. 8, 5.2.2.1 

ехфегп, 4.2.2 

Ехфгас& Аззос1афеЧТсоп, гл. 8, 5.4.1 

Ех{фгасЕПеПлт, 1.5, 1.14, 2.2.2 

Ехфгас$ЕПе)уе, 6.6.5 

Ех4гасЕПеЕхф, 1.5 

Еж{гас%Е\еМате, 1.4, 1.5 

Ех&гас Мсоп, гл. 8 

!{аАпуЕЦе, 6.6.1 

 ТаАгсШуе, 6.6.1 

{аП1гес%огу, 6.6.1 

ГаН1А4еп, 6.6.1 

{аВеааОщу, 6.6.1 

КАВРКОС, 1.15.4 

ТазузЕПе, 6.6.1 

ГаУ\Уо[атеТО, 6.6.1 

<озе, 2.3.5 | 

{се3, 2.3.5 

ЕШЕ, 2.3.5 

ЕПЕ_АТТЕ1ТВОТЕ_МОВМАГ, 6.7.1, 6.7.2 

ЕП.Е_ВЕСЛУ, гл. 8, 6.7.1 

ЕЕ СОВВЕМТ, гл. 8, 6.7.1 

ЕЕ ЕМО, гл. 8, 6.7.1 

ЕЕ ЕГТАС_ВАСКОР ЗЕМАМТГС$, гл. 8. 

ЕП.Е ЕГАС ОЕГЕТЕ_ ОМ_СГОЗЕ, гл. 8 

ЕШЕ ЕГАС_ МО ВОЕЕЕВТЖМС, гл. 8, 6.7.1 

ЕШЕ_ ЕГАС_ОУЕВГАРРЕЮ, гл. 8, 2.5.3 

ЕП.Е_ЕГАС РОЗГХ_ ЗЕМАМТ!С$, гл. 8 

ЕП.Е ЕГАС ВАМОРОМ_АССЕ$З$, гл. 8 

ЕП.Е_ЕГАС_ЗЕФОЕМТТАТ, САМ, гл. 8 

ЕП.Е_ЕТАС_УВТТЕ_ ТНВООСН , гл. 8, 
6.7.1 

ЕП.Е МОТГУ СНАМСЕ_АТТЕ]ВОТЕ$, 
гл. 8, 3.9 | 

ЕП.Е_МОТРУ_СНАМСЕ ОВ МАМЕ, 
гл. 8, 3.9 = | 

ЕП.Е МОТТРУ СНАМСЕ_ ЕПЕ_ МАМЕ, 
гл. 8, 3.9 | 

ЕП.Е_МОТТЕРУ СНАМСЕ_ГАЗТ УЕТЕ, 
гл. 8, 3.9 
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ЕП.Е_МОТТРУ_СНАМСЕ_ЗЕСОВГТУ, 
гл. 8, 3.9 

ЕП.Е МОТТРУ_СНАМСЕ_ ИЕ, гл. 8, 3.9 

Е.Е. ЗНАВЕ ОЕКБГЕТЕ, гл. 8, 6.7.1, 6.7.2 

ЕПЕ_ЗНАВЕ_ВЕДЮ, гл. 8, 6.7.1, 6.7.2 

ЕШЕ БНАКБЕ УВПТЕ, гл. 8, 6.7.1, 6.7.2 

ЕПер)афеТтоОжщеТ!те, 6.6.1 

ЕПеЕх!3%5, гл. 8, 2.3.5, 6.13 

ЕШЕТТМЕ, 3.7, 1.15.3 

ЕПейтеТо!1464, 1.15.3 

ЕЦеТиаеТоГ.оса| Е ПеТ1 те, 1.15.2 

ЕПеТ1теТобузетТише, 1.15.1, 3.7 

ЕШВесф, гл. 8, 1.6 

Е1пААфощ, гл. 8, 1.16 

Е1таС]озе, 6.6.1, 1.4, 1.5 

ЕпаСозеСпапхеМойЙсайон, 6, 3.9, 6.6.4 

Е1шаЕхесиваЫе, гл. 8, 5.4.1 

Е1оаЕ!т3%, 6.6.1, 1.4, 1.5 

ЕшаЕ1т5СпапееМон!1сайоп, гл. 8, 3.9, 
6.6.4 

ЕпаМ№ехф, 6.6.1, 1.4, 1.5 

ЕшЧМех&СВапееМонсайоп, гл. 8, 3.9, 
6.6.4 

Ешла\/1т9дом, гл. 8, 5.1.2, 5.1.3, 5.1.4, 
5.1.1, 1.8 

Ешау\/шаомЕх, гл. 8, 1.7 

ЕТХЕЮ, 4.1.3 

ЕХЕР РИГТСН, 1.14 

НазВ\У/шт9дом, гл. 8, 5.2.5, 9.3 

Ел ЕПеВиегс, гл. 8, 6.7.1, 2.5.2, 2.5.3 

!тСгезе, 6.9, 9.4 

пОрепВаеаа, 6.9, 9.4 

Г{пОрепВеаа\гце, 6.9, 9.4 

1тОреп\У/гЦе, 6.9, 9.4 

ибрагеСотраф, 6.9, 9.4 

по Ваге)епуМопе, 6.9, 9.4 

ибВаге)епуВеаа, 6.9, 9.4 

ГтбЭрагеОепу\гцЦе, 6.9, 9.4 

тоВагеЕхс ауте, 6.9, 9.4 

ГО_СОРУ, гл. 8, 6.10 

КО _РЕЦЕТЕ, гл. 8, 6.10 

КО_МОТЕ, гл. 8, 6.10 

ГО _ВЕМАМЕ, гл. 8, 6.10 

КОК АГГОУГОМОО, гл. 8, 6.10 

КОР СОМЕВММОСЗЕ, гл. 8, 6.10 

КОР ЕШЕЗОМГУ, гл. 8, 6.10 

РОГ МОГТШЕЗТЕПЕ®, гл. 8, 6.10 

ГОГ МОСОМЕТВМАТТОМ, гл. 8, 6.10 
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РОЕ_МОСОМЕВММКПХ, гл. 8, 6.10. СеАгиеВоаду, 10.5.2 
КОЕ КЕМАМЕОМСОЦИЛЬТОМ, 6.10 СеАгиеНеадег, 10.5.2 
РОГ ЭПЕМТ, 6.10 Се$АзупсКеу $ афе, гл. 8, 2.3.2 
КОРЕ 51МРЬЕРВОСВЕЗУ, 6.10 Се А$отМаште, гл. 8, 1.16 
КОЕ У/АМТМАРРИГМСНАМОГЕ, 6.10 Се СаззМате, гл. 8, 5.1.1, 5.1.2 
{ореп, 2.3.5 | СеСПеп{ Вес, гл. 8 
Гогта{Ра4еТ1те, 9.3 Се СоттМазК, гл. 8 
Гогта&Меззаее, гл. 8, 1.1 Се {Сотшт $ а4фе ‚ гл. 8 
реш, 2.3.5 Се СошшТИтеоц&$, гл. 8, 2.5.1 
ЕгатеКесф, гл. 8 Се СотрщегМате, 2.1.5 
ЕгееЕпу!1гоптеп{ $ &г115$, гл. 8 СеСиоггеп О, 2.2.2 
ЕгееГлЬгагу, гл. 8, 4.2.4, 4.4.1, 1.4. Се Сиггеп&Ргосез$, 3.7 
Е САЗЕ 15 РВКЕБЕКУЕЮ, гл. 8 Се Сиггеп&Ргосез 4, 3.7 
Г САБЕ БЕМЗГТУЕ, гл. 8 Се$СиггепТЬгеа4, 1.15.3 
Е ЕШЕ_ СОМРКВЕБЗЗТОМ, гл. 8 Се{СигзогРоз, гл. 8, 2.4.2, 1.10 
Е РЕВЗБЗЭТЕМТ АСГЬ, гл. 8 СеОафе, 11.5 
Е ОМТСООЕ ЭТОВЕОР_ ОМ ПБК, гл. 8 Се ОС, гл. 8, 5.5.1, 5.5.3 
ЕСТЬ ОЗМООМТ УОГОМЕ, гл. 8 Се{ОезсирИоп, гл. 8, 6.12 
ЕСТЬ СЕТ СОМРКЕБЗТОМ, гл. 8 Се ОезК4ор\/т9дох,, гл. 8, 1.6 
ЕСТЬ ГОСК_УОГОМЕ, гл. 8 Се{015КГЕгееБрасейх, гл. 8, 6.1.1 
ЕЗСТЬ БЕТ СОМРВЕБЗЗОМ, гл. 8 Се О1зр]ауМатеОТ, гл. 8 
ЕСТЬ ОМГОСК_УОБОМЕ, гл. 8 Се{ОшуеТуре, гл. 8, 6.1.1 
ЕТР, 10.4 Се{Епу1гоптеп 1115$, гл. 8, 1.13 
КУ’ ВГАСК, гл. 8 СефЕпу1гоптепт УатаЫе, гл. 8, 1.13 
Е\УУ_ВОГЬ, гл. 8 Се Ех Со4еРгосез$, гл. 8, 3.7 
КУ’ РЕМТВОГЬ, гл. 8 Се Ех Со4еТЬгеаа, гл. 8, 3.8 
РУ’ ПОМТСАВЕ, гл. 8 Се Еогеггоипа\! т 9до\,, 5.1.3 
РУ’ ЕХТВАВО, гл. 8 Се Неадег, 10.5.4 
ГКУ’ ЕХТВАШСНТ, гл. 8 Се${Но%Кеу, гл. 8, 6.12 
Е\У/_ НЕАУТУ, гл. 8 Се сопГосайоп, гл. 8 
РУ’ ЦСНТ, гл. 8 Се{КеуБоага же, 2.3.1 
КУ’ МЕОГОМ, гл. 8 Се КеуБоагаТуре, 2.1.4 
КУ’ МОВМАТГ, гл. 8 Се Кеу$афе, гл. 8, 2.3.1 
ЕК\/ КЕСОЦАЖ, гл. 8 Се{Газ%Еггог, 1.1, гл. 8, 2.1.5, 2.5.3, 3.3, 
Е\У/_БЕМ1ВОГО, гл. 8 6.7.2 
Е\/_ТНПУ, гл. 8 Се{Госа1Т1 те, 1.15.1 

‚ РУ’ ОБТВАВОГГЬ, гл. 8 Се Гог1са\Оуе и 1штез, гл. 8, 6.1.1 
ЕУ\’ ОГТВАЫСНТ, гл. 8 Се{Мепт, гл. 8, 5.1.2 
СТ, 5.5 Се МепиЦетСоцпф, гл. 8, 5.1.2 
СЕМЕВТС_ВЕАЮ, гл. 8, 6.7.1, 6.7.2, 2.5.1 | Се МепиЦетТЮ, гл. 8, 5.1.2 
СЕМЕБВ!С_У\/ВТЕ, гл. 8, 6.7.1, 6.7.2, Се{МепиЦет то, гл. 8, 5.1.2 

2.5.1 Се Мепа $ же, гл. 8 

Сеф, 10.4.3 Се Мепи ито, 5.1.2 
СЕТ_ГЕМСТН_ГПМРГОВМАТТОМ, 6.1.2 Се{Ме\Сгойпрз1л3%, 10.5.4 
Се$АгсПО1гесй оп, гл. 8 Се МемМемз1 3%, 10.5.4 
Се Агхитет%$, гл. 8, 6.12 Че Ме\узегопрм$%, 10.5.4 


Се Агие, 10.5.4 Се Мех \М/1тдо\,, гл. 8, 5.1.3 
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Се{Оуегарре4Вези\%, гл. 8, 6.7.1 НС _АСТТОМ, 4.3 

Се{Рагецф, гл. 8, 5.1.2 НС_МОВЕМОТХЕ, 4.3 
Се{Ра\{, гл. 8, 6.12, 1.15.3 ` | НОС, 5.5.3 

Се РиогЦуСаз$, гл. 8, 3.7 НЮН_РЕОВТТУ _СГА$ЗЬ, гл. 8, 3.1 
Се{РгосА9а@гезь, гл. 8, 4.2.4 НКЕУ СГАЗЗЕБ ВООТ, 1.11 
Се РгосеззТитез, гл. 8, 3.7 НКЕУ СОВККЕМТ ОБЕВН, 1.4, 1.11 
Се Вей1оп)афа, гл. 8, 5.2.2.1 НКЕУ ГОСАГ МАСНИУЕ, 2.1 
Се$ЗБомСта, гл. 8, 6.12 НОЦШОМ/_ВВОБН, 5.5.1 

Се юскОЪесф, гл. 8, 5.5.3, 5.5.1, 1.6 НОШОУМ’_ВВОБН. МОМ, ВВОБН, гл. 8 
Се ЗиБМепт, гл. 8, 5.1.2 Воок, 4.3 

Се Зуз$етПгесфогу, гл. 8, 1.4 НОТКЕУЕ АГТ, 2.3.6 

Се Зуз$ет Шо, гл. 8 НОТКЕУЕ СОМТБОТ, 2.3.6 
Се Зуз4етМепи, гл. 8, 5.2.1, 2.4.2, 2.1.2 | НОТКЕУЕ ЕХТ, 2.3.6 
СебузетТ!те, 1.15.1 НОТКЕУЕ БНТЕТ, 2.3.6 
Се{ТугеааРогЦу, 3.8 Ноог, 11.5 

Се ТьЬгеааТ!тез, 1.15.3 НРЕМ, 5.5.3 

Се{Т1<КСоипф, 1.15.3, 1.15.4 №Ргосез$, 3.7 

Се Титейопеш{огтайоп, 1.15.2 НВСОМ, 5.2.2.1 

Че ОзегМате, 2.1.6 Н$_ ВОТАСОМАТ, гл. 8, 5.5.1 
Се$Уегз1оп, 1.2, 2.1.1, 5.1.4 НЗ СВО$Ь, гл. 8 
Се$Уегз1отЕх, гл. 8, 1.2 НЗ ОТАССВОБЗЬ, гл. 8 

Се Уоитеш{огта ол, гл. 8, 6.1.1 Н5 РЕОТАСОМАТ, гл. 8 
Сеф\/Лтаох,, гл. 8 — НЗ НОВГОМТАТ, гл. 8 
Сеф\У/Лштаом)С, гл. 8, 5.5.1, 1.6 Н УЕВТСАГ, гл. 8 
Сеф\/таомТГопе, 5.2.4, 6.13 НТВОВОЕК, 4.3 

Се \ шдомР]1асетепф, гл. 8, 5.1.1 НТВОТТОМ, 4.3 
Сез\У/шаомВесф, гл. 8, 5.1.1 НТВОТТОМГЕЕТ, 4.3 

Се \Ишдо\В ет, гл. 8 НТВОТТОМЕ!СНТ, 4.3 
Сеф\ИщтаомПГгесфогу, 1.14 НТСАРТТОМ, 4.3 

Се МУ шао\Техф, гл. 8, 5.1.1, 5.1.2 НТСЫЕМТ, 4.3 

Се тдомТех Гепа, гл. 8, 5.1.1 НТЕВКОК, 4.3 

Се УГогЕшеПИгесфогу, гл. 8, 6.12 НТСКВОХУВОХ, 4.3 
(СПоЬа1АааАфот, гл. 8, 1.16, 2.3.5 \ТЬгеаа, 3.7 
СоБаШеефеАфо!т, гл. 8 НТНСВОЦ,, 4.3 
СоБа!Е11ААфоа, гл. 8, 1.16 | НТГЕЕТ, 4.3 
СоБа1Се*АфотМаше, гл. 8, 1.16 НТМЕМО, 4.3 

СИоБа]Метогу $афиз, гл. 8, 2.1.3 НТМОМНЕВЕ, 4.3 
СМ_АРУАМСЕЮ, 5.5.2 НТВЕФОСЕ, 4.3 
СМ‚_СОМРАТТВГЬ, 5.5.2 НТВ!СНТ, 4.3 

СКАУ _ВВОБН, гл. 8 НТЫГИЕ, 4.3 

С\У/ НУМОМЕХТ, 5.1.3 НТЗУЗМЕМО, 4.3 

СУ’ _НУ\УУМОРВЕУХ, 5.1.3 НТТОР, 4.3 

СМ’ О\/МЕК, 5.1.2 НТТОРГЕЕТ, 4.3 

СУТ. ЕХБФТУГЕ, 1.9 НТТОРЕ]СНТ, 4.3 

СХ\УТ, БТУГЬЕ, 5.2.4, 6.13 НТТКАМЗРАВЕМТ, 4.3 
НазГогта%, гл. 8, 3.11 НТУБСВОШ,, 4.3 


НазОуегарредТоСотр/|ефеч, гл. 8, 6.7.1 НТ2ООМ, 4.3 
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Н\УУМО _ВОТТОМ, гл. 8, 2.3.5 

НУ\У/МО МОТОРМОБЗТ, гл. 8, 2.3.5, 5.2.1 

НУ\УУМО ТОР, гл. 8, 2.3.5 

Н\У/МО ТОРМОЗТ, гл. 8, 2.3.5, 5.2.1 

СМР, 10.2 

ТСОМ, 4.1.3 

ТаЕеТР, 10.4.3 

ШТ АРРЫСАТТОМ, 5.4.2 

ШТ АЗТЕВТЗК, 5.4.2 

ШТ ЕХСГАМАТТОМ, 5.4.2 

ТОТ НАМЮ, 5.4.2 

ШТ ООЕБТТОМ, 5.4.2 

ОГ \МГМГОСО, 5.4.2 

ТОГЕ_РЕКОВТТУ _СГА$, гл. 8, 3.7 

аммтр, 10.5.4 

ТЕМ ап ГОГ $, гл. 8, 6.2 

Го, 11.5 

ГПМЕГПТЕ, 3.2, 2.5.3, 3.5 

шпЦАцщюотТа ]е, гл. 8, 1.16 

шпри& Вох, 6.5 

при @чеху, 9.3, 10.4.1 

пзег{МепаЦеш, гл. 8 

[146456 Мод32, 1.15.1, 1.15.8 

тТГоб%г, 1.2, 1.15.1 

[МУАГО НАМОГЕ_УАГОЕ, 3.9 

пуег&Вес%, гл. 8 

ТОСТЬ ОБЗК СЕТ ОВНТУЕ СЕОМЕТКУ, 
гл. 8, 6.1.2 

ТОСТЬ БЗК _ СЕТ ГЕМСТН 1М№РЕО, гл. 8, 
6.1.2 

ТОСТ ОГЗК_ РЕКЕОВНМАМСЕ, гл. 8 

ТОСТЫ Э5ТОВАСЕ СНЕСК_УЕВ1КУ, гл. 8, 
6.1.2 

ТОСТЬ БТОВАСЕ ЕЗЕСТ_МЕПГА, гл. 8, 
6.1.3 

ОСТГ. ЭТОВАСЕ_ ТГОАР_МЕРГА, гл. 8, 
6.1.3 

ТОСТ. БТОВАСЕ_ МЕРТГА_ВЕМОТАТ, 
гл. 8, 6.1.3 

ТРегз1{ЕПе, 6.12 

[$ МОТ МОШ,, 11.5 

[$ МОМ,, 11.5 

ТЕМЫ $Т, 6.2 

УРЕС, 5.4.4, 4.1.4 

Кеу, 2.4.2 

КеуБ4_еуепф, гл. 8, 2.3.3, 2.3.1 

КЕУЕУЕМТЕ КЕУТЬР, 2.3.3 

КШТипег, 1.15.4 
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КГЕ АСТТУАТЕ, 2.3.4 


ГАВСЕ ТМТЕСЕК, 1.15.3 

ГлКе, 11.5 

ГлпеТо, гл. 8, 5.5.1, 5.5.3 

[1$%, 10.4.1, 10.4.3 

13$ ОЁРо]@ег, 6.2 

ГоааВ! тар, 4.2.5, 4.4.1, 5.5.3 
ТоаАСигзог, гл. 8, 2.4.5, 4.2.2 
ГоааСигзогЕгот Ее, гл. 8, 2.4.5, 2.4.7 
ГоааЕготЕЙе, 11.4 

ГоаЧГсоп, гл. 8, 4.2.2, 4.4.1, 5.4.2 
ГоааКеуБоагаГауоц%ф, гл. 8, 2.3.4 
ГоааТлЬгагу, гл. 8, 4.2.4, 4.4.1, 1.4 
ГОАРОМСАШЩ,, 4.1.3 

ГоааЗ&гште, 4.1.4 
Госа1ЕеТ1теТтоЕ!еТ!те, 1.15.2 
ГОСВВОБН, 5.5.1 

ГОСРЕМ, 5.5.1 
ГоокарРтуЦегеУаше, гл. 8, 2.2.1 
Го\мег, 11.5 

.РВВКО\МБЕГУЕО, 6.5 
|рСоштТипеоц&$, 2.5.1 

|рОСВ, 2.5.1 

|рЕуеп{ Аг! цфез, 3.4, 3.5 
|рЕУ{МазЕ, 2.5.3 

СРТТЕМТЫ$Т, 6.2, 6.5 . 
СРМЕМОКВУБЗТАТОЬ, 2.1.3 
]рОуегарреа, 2.5.3 
СРРКОСЕЗЗЕМТКУЗ2, 3.10 
ГРЭНЕПЕОРБТВОСТ, 6.10 
ГРТНВЕАГБЕМТКУЗ2, 3.10 
.РУ/ПМРО\МУРГАСЕМЕМТ, 5.1.1 
ГТСКАУ ВВОЗН, гл. 8 

МакКеП1т, 10.4.3 

МакКеП1гесфогу, 10.4.1 
МАКЕПМТАТОМ, гл. 8 
МАКЕПМТВЕЗООВСЕ, 5.4.2 
МАКЕГРАКАМ, 2.4.2 
МакКе\\ога, 2.3.6 

МАВКРАЕТУ, 2.5.1 

МАХ СОМРОТЕВКМАМЕ ТЕМСТН, 2.1.5 
МАХ _РАТН, гл. 8 

МАХОУГОВЬО, 2.5.1 

МАХТМОМ _БОЗРЕМО СООМТ, 3.8 
МВ Т1СОМАБТЕВ]БК, гл. 8 

МВ 1СОМЕХСГАМАТИОМ, гл. 8 
МВ Т1СОМНАМЮ, гл. 8 
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МВ ТСОМОЧЕБЗТТОМ, гл. 8 МОР_АГТ, 2.3.5 

МВ ОК, гл. 8 МОО СОМТВОТ, 2.3.5 
МЕМОКВУЗТАТОЬ, гл. 8 МОР БЕТ, 8.3.5 . 
МЕМОТТЕМТУРЕО, гл. 8 _ Моп{В, 11.5 

МЕЗБАСЕ_ НАМОГЕВ, 1.10 МОУАВЕЕ, 4.1.3 

МЕ ВИМАР, гл. 8 МоуеЕЦПе, гл. 8 

МЕ ВУСОММАМЮ, гл. 8, 5.2.1 МоуеЕ!еЕх, гл. 8 

МЕ ВУРОБГТОМ, гл. 8 МоуеЕ\Це\/ В Ргоггезз, гл. 8 
МЕ СНЕСКЕЮ, гл. 8, 5.2.1 МоуеТоЕх, гл. 8, 5.5.1, 5.5.3 
МЕ ОГБЗАВГЕЕО, гл. 8 Моуе\/1тдо\, гл. 8, 5.1.1 
МЕ ЕМАВГЕР, гл. 8 Мзе\ацЕогМи1р]еО Бес, 3.2 
МЕ СВАУЕЮ, гл. 8 Мз=\У\ацЕогМи Я р]еОБес%зЕх, 3.2 
МЕ МЕМОВАВВВЕАК, гл. 8 МТГоп, 1.10 

МЕ МЕМОВВЕАК, гл. 8 ’|МОТЕХ_АЦШ, АССЕБЬ, 3.3 
МЕ ОМ/МЕВОКАУ,, гл. 8 № х+, 10.5.4 

МЕ РОРОР, гл. 8 МТЕ ТСОМ, гл. 8 

МЕ БЗЕРАКАТОВ, гл. 8, 5.2.1 МТЕ МЕЗЗАСЕ, гл. 8 

МЕ ЭТВИМО, гл. 8, 5.2.1 МТЕ_ТТР, гл. 8 

МЕ ОМСНЕСКЕЮ, гл. 8, 5.2.1 МТМ_ АГ, гл. 8 

МЕЗ СНЕСКЕЮ, гл. 8 МТМ_ОЕГЕТЕ, гл. 8 

МЕБ РЕГАОГТ, гл. 8 ММ_МОПТЖУ, гл. 8 

МЕ ПЗАВГЕЮ, гл. 8 М№ММПауТи!пе, 10.1 

МЕБ ЕМАВГЕЮ, гл. 8 ММЕсьо, 10.2 

МЕЗ СВАУЕЮ, гл. 8 ММЕТР, 10.4.1 

МЕЗ_ НПЛТЕ, гл. 8 МММ5е, 9.3, 9.4 

МЕХ ОМСНЕСКЕЮ, гл. 8 МММБОбБету, 9.4 

МЕ ОМНПЛТЕ, гл. 8 МММБОБегу1МБС, 9.3 

МЕТ ВТМАР, гл. 8 ММММТР, 10.5.2, 10.5.4 
МЕТ МЕМОВАВВВЕАК, гл. 8 ММООРгосез$зог, 10.6 

МЕТ МЕМОВВЕАК, гл. 8 МОРАВ!ГТУ, 2.5.1 

МЕТ О\’МЕВКОВАУ,, гл. 8 МОВМАГ РЕОЕВТУ_СГАБУ, гл. 8, 3.1 
МЕТ ВАПОСНЕСК, гл. 8 МИ, ВВОБН, гл. 8, 5.5.1 
МЕТ ЕВСНТУОБЗТТЕУ, гл. 8 МОЫ, РЕМ, гл. 8, 5.5.1 
МЕТ БЕРАКАТОВ, гл. 8 ОБ]ес$ВтагуТоТехф, гл. 8 
МЕТ ЭТВМО, гл. 8 _ | ОЧесТех&{ТоВтату, 6.13 
МПМ_СНЕСКМАВКЬ, гл. 8 ОПОРАВТУ, 2.5.1 
МПМ_РАТА, гл. 8 ОЕМ_СНАВЪЗЕТ, 1.14 

МИМ_ Ш, гл. 8 ОЕМ_ЕГХЕО_ГЕОМТ, гл. 8 
МПМ_Б5ТАТЕ, гл. 8 ОетТоСтагВу{ЁЕ, гл. 8 
МИМ_ЗОВМЕМО, гл. 8 ОпСПеСонаф, 9.3 

МПМ_ ТУРЕ, гл. 8 ОпСоппес+, 9.3, 9.5.1 
Мшие, 11.5 ОпСоппес#&т?х, 9.5.1 

МК СОМТВОГ, 2.4.1 Оп0О1зсоппес%, 9.3 

МК ТВОТТОМ, 2.4.1 ОМЕБ5ЗТОРВЕИТ©, 2.5.1 

МК МВОТТОМ, 2.4.1 ОМЕБТОРЕИТ, 2.5.1 

МК _ ВВОТТОМ, 2.4.1 ОпГооктр, 9.5.1 


МК ЭН!ЕТ, 2.4.1 ОпМеззахеЗепа, 9.3 
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Оп М5, 9.3 

ОРЕМ_АТГУ\УАУ$, гл. 8, 6.7.1, 6.1.2 
ОРЕМ_ЕХТЗТИМС, гл. 8, 6.7.1, 6.7.2 
ОрепЕуепф, гл. 8, 3.5 | 
ОрепМ\чщфех, 3.3 

ОрепРгосезз, 3.7 

ОрепРгосез$ТоКеп, гл. 8, 2.2.1 
ОрепЗетарроге, гл. 8, 3.4 
Ореп\У/аЦаеТ1те, гл. 8, 3.6 
ОЙОТ_РЕЕАОТТ РВЕСТБ, гл. 8, 1.14 
ОПТ _РЕУХ1СЕ_РВЕСФТЬ, гл. 8, 1.14 
ОПТ _ООТЫМЕ_РВЕСХГ, гл. 8, 1.14 
ОПТ _ВАЗТЕВ_РВЕСГС, гл. 8, 1.14. 
ОПОТ_ТТ ОМГУ РВЕСТ, гл. 8, 1.14 
ОЙОТ_ТТ РВЕСФ5, гл. 8, 1.14 
ОУЕВГАРРЕЮ, гл. 8, 6.7.1 
РагзеМемзСгочцр, 10.5.4 

Рег!огт, 1.8, 2.3.3, 2.3.6, 2.4.2 

Р1е, гл. 8 

Р1]аубоипа, гл. 8 

Ро!1%, 5.3.1.3 

РОМТ, гл. 8 

Ро|уВе7ег, гл. 8 

Ро!уВеегТо, гл. 8 

Ро]ухоп, гл. 8 

Ро!уРо|удогп, гл. 8 

Роз, 9.3 

Роз{Меззаее, 5.1.3 

РгАррМаше, 10.5.2 

РгАгие]1а, 10.5.2 

РтО1 {г иНоп, 10.5.2 
РВЕУЕМТ МЕОТА ВЕМОТХАГ, 6.1.3 
Ргеу1ои$, 10.5.4 

РгЕготАа@гезз, 10.5.2 
РгМемзСгопрз, 10.5.2 
РВОСЕЗЗ_ АП, АССЕЗ®, 3.7 
РВОСЕЗ_ СВКЕАТЕ РВОСЕ$У, 3.7 
РВОСЕЗЗ СВЕАТЕ ТНВЕАЮ, 3.7 
РВОСЕЗЗ ПОР НАМОГЕ, 3.7 
РВОСЕЗЗ @ОЕВКУ_ ПМРГОВМАТТОМ, 3.7 
РКОСЕЗЗ БЕТ ТМРОВМАТТОМ, 3.7 
РВОСЕБЗ ТЕВМТМАТЕ, 3.7 
РКОСЕЗ$ УМ_ОРЕКАТТОМ, 3.7 
РКОСЕЗЗ_ УМ_ВЕАКЮШ, 3.7 
РВОСЕБЗ_УМ_У\УВ/ТЕ, 3.7 
Ргосезз32Е1гз$, 3.10 
РВКОСЕБЗЕМТКВУЗ2, 3.10 


РВОСКВЕЗЗ САМСЕГ, гл. 8 
РВОСВКЕБЗЗ СОМТТМОЕ, гл. 8 
РВКОСВЕЗЗ ООТЕТ, гл. 8 
РКОСВЕЗЗ БТОР, гл. 8 
РКООЕ ОПОАШТУ, 1.14 
РгВер!УТо, 10.5.2 

РгЗиБ]ес%, 10.5.2 

РгТпера, 10.5.2 

Р5_РАБН, гл. 8, 5.5.1 

РБ ПАЗНПООТ, гл. 8, 5.5.1 

РБ РАЗНПООТООТ, гл. 8, 5.5.1 
РБ ПОТ, гл. 8, 5.5.1 

Р5 ПМЭШЕЕКВАМЕ, гл. 8, 5.5.1 
РБ МОШ,, гл. 8, 5.5.1 

Р5_ БОЮ, гл. 8, 5.5.1 
РТ_ВЕТЕВТО, гл. 8 
РТ_ЫМЕТО, гл. 8 
РТ_МОУЕТО, гл. 8 

Ри|зеЕуеп+, гл. 8, 3.5 

РОВСЕ_ ВХАВОНТ, гл. 8, 2.5.2 
РОВСЕ ВХСГЕАБК, гл. 8, 2.5.2 
РОВСЕ_ТХАВОНТ, гл. 8, 2.5.2 
РОВСЕ_ ТХСЬЕАВ, гл. 8, 2.5.2 
РагееСошта, гл. 8, 2.5.2 

Риф, 10.4.3. 

© АШЕУЕМТЬ, 3.2 

95 АШЛМРОТ, 3.2 

05 НОТКЕУ, 3.2 

©5 ТМРОТ, 3.2 

©5 КЕУ, 3.2 

©5_МООБЬЕ, 3.2 

95 _МОЧБЗЕВОТТОМ, 3.2 

95 _МООБЕМОТХЕ, 3.2 

45 РАМТ, 3.2 

05 РОЗТМЕБЗБАСЕ, 3.2 

©5 БЕМОМЕБЗБЗАСЕ, 3.2 

©5 МЕН, 3.2 
ОцегуРег!огтапсеСоищЩег, 1.15.3 
ОиегуРег!огтапсеЕгеачеису, 1.15.3 
ВСПАТА, 4.1.3 

ВеааСага!па], 9.6 

ВеааЕЦе, гл. 8, 6.7.1, 2.5.2, 2.5.5 
ВеааЕ\еЕх, гл. 8, 2.5.3 
Веаацфехег, 9.6 

ВеааГло, 9.6 

ВеааЗтаШ т, 9.6 

Веаа$ гта, 9.6 
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ВЕАГТМЕ РВЮОЕТУ_СГА$ЗЬ, гл. 8, 3.7 | КТ 5ТЕГМС, гл. 8 


Весе!уеТехф, 9.5.1 

Весф$, 5.5.3 

ВЕСТ, гл. 8 

Кесбапе]е, гл. 8, 5.5.1, 5.5.3 
ВЕС МОТЛТ 5%, 2.1.1 - 
Кег2154егНо{Кеу, гл. 8, 2.3.5 
Ве513 {ег пом Меззаде, гл. 8 
ВБееазеСарфиаге, гл. 8, 5.2.3, 5.3.2 
ВееазерС, гл. 8, 5.5.1, 5.5.3, 1.6 
ВееазеМуфех, 3.3 
ВееазеЗетарВоге, гл. 8, 3.4 
гетоуе, гл. 8, 6.8 

ВетоуеПлх, 10.4.1, 10.4.3 
ВетоуеГоп{Везоцгсе, гл. 8, 1.14 
Вепаште, 10.4.3 

ВепатеЕ !е, гл. 8, 6.8 
ВезеЕуеп%, гл. 8, 3.5 
Везо]уе, гл. 8 

ВезитеТЬгеаа, гл. 8, 3.8 
ВейлеуеСиггет Пг, 10.4.3 
ВСВ, гл. 8 

ВСМ_АМЮ, гл. 8, 5.2.2.1 
ВамМ_СОРУ, гл. 8, 5.2.2.1 
ВСМ _ОТЕЕ, гл. 8, 5.2.2.1 
ВОМ_ОБ, гл. 8, 5.2.2.1 
ВамМ_ХОВ, гл. 8, 5.2.2.1 
ВоппаВес{, гл. 8 

гзЕсро, 10.2 

гзЕггог, 10.2 
гзЕггогТТГЕхсеедеа, 10.2 
гзЕггогО пгеасвВае, 10.2 
гзТипеОцф, 10.2 
ВТ_АССЕГЕВАТОКВ, гл. 8 

ВТ АМ'ГСОВФОВ, гл. 8 
ВТ_АМПСОМ, гл. 8 
ВТ_ВИМАЬР, гл. 8, 4.4.1 

ВТ СОВБОВ, гл. 8 

ВТ ПОТАГОС, гл. 8 

ВТ_ЕОМТ, гл. 8 
ВТ_ЕОМТОТВ, гл. 8 

ВТ СВООР_СОВЗОВК, гл. 8 
ВТ СВОЧР ТСОМ, гл. 8, 4.4.1 
ВТ ТСОМ, гл. 8, 4.4.1 
ВТ_МЕМО, гл. 8 

ВТ МЕЗБАСЕТАВГЕ, гл. 8 
ВТ ВСРАТА, гл. 8 


ВТ_УЕВЗОМ, гл. 8 
ВОБЫТАМ СНАВБЕТ, 1.14 
ЗауеТоЕ!е, 11.4 

эс _СГОБЕ, 5.2.1 

эс _МАХГМЕЕ, 5.2.1 

ЭС _МИМТМПЕ, 5.2.1 
5С_МОТЕ, 5.2.1 

эс _КЕБТОВЕ, 5.2.1 

эс ЗГИЕ, 5.2.1 

эс _ТАЗКМЗТ, 1.7, 4.3 

ЗЕ РЕУШЕСЕ, 2.2.1 

ЗЕ РЕУП.ЕСЕ_ЕМАВЕЕЮ, гл. 8 


ЗЕ РЫУШЕСЕ ЕМАВЬГЕО_ ВУ_ОЕРГА- 


ОПТ, гл. 8 


ЗЕ РЕГУПШЕСЕ_ОЗЕО_ЕОВ_АССЕС$, гл. 8 


ЗЕ _ЗЕСОВТГТУ _МАМЕ, 2.2.1 
ЗЕ БНОТРО\М/М МАМЕ, гл. 8 
Зесопа, 11.5 

ЗЕСОВТУ АТТЕВОТЕХ, гл. 8 


зеес{О1тгесфогу, гл. 8, 6.5, 6.6.5, 6.6.1, 


6.4, 3.3, 3.5, 3.6 
Зеес{Сгочр, 10.5.4 
зе]есфОБ]есф, гл. 8, 5.5.1, 1.6 
ЗЕМАРНОВЕ АШ, АССЕБЗУ, 3.4 
ЗЕМАРНОКЕ_ МОШГЕУ_БТАТЕ, 3.4 
Зепа, 10.5.4 
ЗепаМеззаге, гл. 8, 5.1.1, 3.11, 1.4 
Зепа {геашт, 9.5.1 
ЗепаЗ{геатТЬепОгор, 9.5.1 
зепаТехф, 9.5.1 
ЗепаТоВаск, 5.3.2 
Зе$АгсП1тесй оп, гл. 8 
ЗебАггитеп{$, гл. 8, 6.12 
ЗеСПрЬоага\У1ежег, 3.11 
ЗеСоттвВгеак, гл. 8, 2.5.2 
ЗеСоштМазК, гл. 8, 2.5.3, 2.5.5 
Зе Сошш $афе, гл. 8, 2.5.1 
ЗеСотшт'Типеоцф$$, гл. 8, 2.5.1 
Зе Сотриф{егМаюте, 2.1.5 
Зе СигзогРосз, гл. 8, 2.4.2 
Бе езст1рйИоп, гл. 8, 6.12 
Зе Епу1гоптеп$ У ага е, гл. 8 
Зе Еуепф, гл. 8, 3.5 
Зе ЕПеРо!т-фег, гл. 8, 6.7.1 
зефГоспз, 5.3.2 
Зе Гогеггоппа МИ таох, 1.10, 2.3.3 
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Зе{@гарЬ1с:Моае, гл. 8, 5.5.2, 5.5.3, 
5.3.1.3 | 

Зе Но%Кеу, гл. 8 

Зе сопГосай оп, гл. 8 

ЗеКеуБоага же, 2.3.1 

Зе Газ Еггог, 1.1, гл. 8, 2.5.1, 6.7.2 

Зе Госа!] те, 1.15.1 

зе МепиЦет фо, гл. 8 

Зе$Раф$р, гл. 8, 6.12 

ЗеРногЦуС]аз$, гл. 8, 3.7, 1.15.3 

Зе помСта, 6.12 

ЗефЗ1те, 5.3.1.3 

Бебуз$етТ!е, 1.15.1, 10.1 

Зе ТЬгеааРг!ог(Цу, 3.8 

ЗефТипег, 1.15.4 

ЗеТипейопеп{!огтайоп, 1.15.2 

Зе" аЦаеТ1тег, гл. 8, 3.6 

эзеб\Ишаом/ТГопя, гл. 8, 5.2.4, 6.13 

Зеф\ИшаомР]асетепф, гл. 8, 5.1.1 

Зе \У/1таом/ Роз, гл. 8, 2.3.5, 5.2.1, 6.13 

Зе МУ т4ом Вт, гл. 8, 5.2.2.1, 5.3.1.3, 
5.3.1.1, 5.3.1.2, 5.2.2.1, 1.7 

Зе Уп 4о\зНооКЕх, гл. 8, 4.3 

вер \\/ш4о\Тех+, гл. 8, 5.1.1 

зеф\У ог П1гесфогу, гл. 8, 6.12 

Зе У ог ТгапФогш, гл. 8, 5.5.2, 5.5.3, 
5.3.1.3 

5НАааТоВесепт{Оосз, 1.7 

5НВго\мзеГогЕРо]4ег, гл. 8, 6.5 

ЗНСОМТЕ_ ЕОГОЕВЬ, гл. 8, 6.2 

ЭНСОМТЕ_ПУСГОРЕНТОПЕМ, гл. 8, 6.2 

ЭНСОМТЕ_ МОМРОГОЕВ,, гл. 8, 6.2 

ЭВе|_ Мо йРу[соп, гл. 8, 1.10 

Эре|Ехеслщфе, гл. 8, 6.6.1, 2.3.5, 1.4 

ЭНЕЦеОрега%1оп, гл. 8, 6.10 

ЗНЕП.ЕОРБТВОСТ, 6.10 

эН@ерм _РГОВРАВЬТМС, 6.2 

ЭНОрмМ ТМГОГОЕВ, 6.2 

ЭНерм_МОВМАГ, 6.2 

ЭНаеОеКф4орГо4ег, гл. 8, 6.2 

5Н@ае Е Цетфо, гл. 8, 5.4.1 

эНае Ра В ЕготТ ОГ $, 6.3 

ЭНае Зрес1а!Ро!4егТ.оса1оп, гл. 8, 6.2, 6.5 

ЭНОСЕТ АТТЕВОТЕХ, гл. 8 

ЭЗНОЕТ О1ЗРГАУМАМЕ, гл. 8 

ЭНОЕГ ЕХЕТУРЕ, гл. 8 

ЭНОЕГ ТСОМ, гл. 8, 5.4.1 

ЭНСЕГ 1СОМГОСАТТОМ, гл. 8 


ЭНОЕТ ГАВСЕТСОМ, гл. 8, 5.4.1 
ЭНОСЕТ 1ЛМКОУЕВГАУ, гл. 8 
ЭНаЕГ 5МАГИЛСОМ, 5.4.1 
ЭНОЕГ ЗУЗ1СОМТМПЕХ, 5.4.1. 
ЭНТТЕМТО, 6.2 

ЭВом/Сигзог, гл. 8, 2.4.3 
ором/Меззаее, 1.1, 2.1.5, 1.15.2 
Эпом\У/т9дох, гл. 8, 5.1.1, 1.8 
512па|ОБес$Апа\Тац, 3.2 

зщ, 5.5.3 

Це, 10.4.3 

517е, 10.4.3 

Зеер, гл. 8, 3.2, 3.5, 2.3.3 
ЗеерЕх, гл. 8, 3.2 

ЭССР ЭНОВТРАТН, 6.12 

Э.Р ОМСРЕЛОВЙТУ, 6.12 
3Мр_АША»Б, гл. 8 

эмО _АШМАБ 1, гл. 8 

ЭМр АРРЫСАТТОМ, гл. 8 
ЭМр_АЗУМС, гл. 8 

ЭМО ЕПШЕМАМЕ, гл. 8 

эмО _ГООР, гл. 8 

ЭМО МЕМОВУ, гл. 8 

эМр _МОБЕЕАОГТ, гл. 8 
эмМр_МОБТОР, гл. 8 
эмМр_МО\ТАТТ, гл. 8 
эмр_РОВСЕ, гл. 8 

ЭМО _ВЕЗООСВСЕ, гл. 8, 4.1.4 
ЭМО _БУМС, гл. 8 
зоарСоппесйоп, 11.3.1 
Зоске{Соппес оп, 11.3.1 
зоРготВея1полщя, 9.4 
зоРГготСаггепф, 9.4 

зоЕготЕпа, 9.4 

ЗРАСЕРАЕ]ТУ, 2.5.1 

ЭРТ_ СЕТЭСВЕЕМБАУЕАСТТУЕ, 1.4 
ЭРТ_СЕТЬСВЕЕМЗАУЕТТМЕОСТ, 1.4 
ЭРТ ЗЕТОЕБЗК\У/АГГРАРЕК, 1.5 
зриши, 2.1.3 | | 
ЗО ГТипе{$атрТоафеТ1те, 1.15.1 
ЭВССОРУ, 5.5.1 

ЭТАВТЕ ОБЕЗНОМ/\М/ПМООХ,, 1.4 
ЭТАВТОРМЕО, гл. 8 

ЭТПА, АСТТУЕ, 3/7 

зфгсру, 1.10 

54геп, 1.5, 2.3.3 

ЭТВВЕТ, 6.2 
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ЭТВВЕТ СБТВ, гл. 8, 6.2 
ОТВКЕТ ОЕЕЗЕТ, гл. 8, 6.2 
ЭТВВЕТ \УЪЗТЬ, гл. 8, 6.2 
з4гзфг, 2.3.5 

ЭфгТоЕоаф, 5.5.3 

Зибзгш, 11.5 
ЗизрепаТ,геаа, 3.8 

ЗУМ НШЕ, гл. 8 

ЭМ’ _МАХИМТЕУЕ, гл. 8 

ЭМ _МИМТУТЕУЕ, гл. 8 

ЗМ’ ВЕБЗТОВЕ, гл. 8, 1.4 

БМ’ _Б5НО\,, гл. 8 

ЗУ БНОМ/РЕКАПОТТ, гл. 8, 5.1.1 
ЗУ З5НОМ/МАХМТАИЕЮ, гл. 8 
ЗУ/ ЗНОМ/МИМИМТЯИЕЮ, гл. 8 


Э\/_5НО\М/МТММОАСТТУЕ, гл. 8, 6.12 


ЭМ’ ЗНО\УМА, гл. 8, 1.8 
З\М/_ЗНО\ЗИМОАСТГУАТЕ, гл. 8 
ЭМ’ _5НОМ/МОВМАГ, гл. 8, 1.8, 1.4 
э\арМоизеВи оп, гл. 8, 2.4.4 
э\УР_ ОКА\У/ЕВАМЕ, гл. 8 

О\УР ЕВАМЕСНАМСЕЮ, гл. 8 
ЭР НШЕХ/МООТХТ,, гл. 8 
Э\УР_МОАСТГУАТЕ, гл. 8 

Э\УГР_ МОМОТЕ, 2.3.5, 5.2.1 
З\УУР_МОБТЕЕ, 2.3.5, 5.2.1 
эУМСНКВОМТИЕ, 3.3, 3.7 
зузЕггогМеззаре, гл. 8, 1.1 
ЗУБТЕМ _РОМТ, гл. 8, 5.5.1 
ЗУБТЕМ_1УЕО, гл. 8 
БузетРагате$ег шо, гл. 8, 1.3, 1.4 
ЗУБТЕМ"МЕ, гл. 8, 3.7, 10.1 
ЗузешТипеТоа{еТите, гл. 8, 1.15.1 
БузетТипеТоЕ\еТ1те, 1.15.1 

фа ХРОВМ, 5.5.2 

ТСПрЬоага, 3.11 

ТСоттТИпеоц&$, 2.5.1 
ТСоппесйопВези%, 10.5.4 
{Читр.ехе, 4.4.2 
Тегт1па{еРгосезв, гл. 8, 3.7, 1.4 
Тегтшпа{еТ,геад, гл. 8, 3.8 
Тех%Очцф, 5.5.1, 5.5.3 
Тех{ТоЗвогСицф, 2.3.5 
ТЕПегеат, гл. 8, 1.14, 9.4, 6.13 
ТЕЦеТ1те, 1.15.1 

ТН32С$ ТМНЕВП., 3.10 

ТН32С5 5МАРАЦПГ, 3.10 


ТН32С5 З5МАРНЕАРЫ$Т, 3.10 

ТН32С5_ Б5МАРМОООГЕ, 3.10 

ТН32С5 5МАРРКВОСЕБУ, 3.10 

ТН32С5_ЗМАРТНВЕАЮ, 3.10 

ТНВЕАР РВНОЕЮТУ_АВОУЕ_ МОВМАГ, 
3.8 

ТНВЕАР РЕОВТТУ _ВЕГО\М_МОВМАГ, 
3.8 

ТНВЕАО РНОЮМТУ Н1СНЕУЗТ, 3.8 

ТНВЕАРО РЕОВТТУ_ТОГЕ, 3.8 

ТНВЕАО РЕОЕЮТУ ТГО\УЕЗТ, 3.8 

ТНКЕАО РКОЕЮТУ МОКВМАЛТ, 3.8 

ТНВЕАО РВНОЮШЦТУ_ТТМЕ_СВТГСАТ, 

_ 3.8 

ТЬгеаа32Е!г$%, 3.10 

ТЬгеаа32М№ех%, 3.10 

ТНВЕАГЕМТКУЗ2, 3.10 

ТТАЕСНОВегуег, 10.2 

'Г1те, 11.5 

ТТМЕ_20МЕ Ш РАУШСНТ, 1.15.2 

ТТМЕ_ 2ОМЕ ТТ) Б5ТАМПАВЮ, 1.15.2 

ТТМЕ_ 2ОМЕ_ Ш ОМКМО\М, 1.15.2 

ТпопегРгос, 1.15.4 

Типе$атрТора4еТ!те, 1.15.1 

Ттетогу &геат, гл. 8, 6.13 

ТМеззахе, 1.10 | 

ТОКЕМ_АБЛОЗТ РВГ/УТЩШЕСЕВ, 2.2.1 

ТОКЕМ_ООЕБУ, 2.2.1 

Тоуегарред, гл. 8, 6.7.1, 2.5.3 

ТРгосез$ш{огтайоп, 3.7 

ТВер1зыу, 2.1.1 _ 

ТВезоигсе {геаш, 4.1.4 

Тгезоигсе геат, гл. 8 

Теа, 11.5 

Тгио Гей, 11.5 

ТгипВлевь, 11.5 

ТВОМСАТЕ ЕХЗТИМО, гл. 8, 6.1.1, 
6.7.2 

Тбеагс! Вес, 6.6.1 

Тбесиг ку А Без, 3.3 

Т5НЕЦе!\1о, 6.6.5 

ТБОГТИпеЗатр, 1.15.1 

Тагир Ш\{о, 3.7, 2.1.2 

ТбузетТте, 1.15.1 

ТТипейопет1{огта*10оп, 1.15.2 

ТУСошр, 10.4.2 

ТУЕТР, 10.4.2 

Т\У/МАсйуже, 1.12 
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Т\УМНо{Кеу, 2.3.5 

ТУ\У/ММоРагаттз, гл. 8 

ТУ/ОЗТОРЕТ, 2.5.1 

Опрвоок\У/шао\зНооКЕх, гл. 8, 4.3 

Опге$1${егНо&Кеу, гл. 8, 2.3.5 

Орюаа, 10.4.1 

ОрюаАррепа, 10.4.1 

ОроааВезфоге, 10.4.1 

Ороа4аО шаце, 10.4.1 

Оррег, 11.5 

ОЗЕЕШЕ, 4.2.3 

ОБЕШВ, 4.2.3 

ОБЕВЕФ, 4.1.4 

Уаг5 Г Т1те $атрСгеафе, 1.15.1 

УК САРГТАТ, 2.3.1 

УК _СОМТВОГ, 2.3.1 

УК ПЕГЕТЕ, 5.3.2 

УК _ГМЗЕНТ, 2.3.1 

УК ТГСОМТВОГ, 2.3.1 

УК ГМЕМО, 2.3.1 

УК ГЭШЕТ, 2.3.1 

УК МЕМО, 2.3.1, 5.2.3 

УК _ВСОМТВОГ, 2.3.1 

УК ВЕТОКМ, 1.14 

УК ВМЕМЮ, 2.3.1 

УК _В5НТЕТ, 2.3.1 

УК _БНТЕТ, 2.3.1 

уз[соп, 6.6.5 

узотаШсоп, 6.6.5 

УГА_АСТТУЕ, 1.12 

УГАТТ АВАМПРОМЕО 0, 3.2 

УТАТТ ЕАП.ЕЬ, 3.2, 2.5.3 

УГАТТ 10 СОМРЬЕТТОМ, 3.2 

УТАТТ_ ОВУЕСТ 0, 3.2, 2.5.3 

УГАТТ_ ТТМЕОТТ, 3.2, 2.5.3 

УГа{СошттЕуепф, гл. 8, 2.5.3 

УацЕГогтпри Че, гл. 8, 3.7 

УацЕогМа1реОБес%, 3.2, 3.5 

УМа(РогМи ре ОБес&зЕх, 3.2 

У/а Рог ше=1еОБ]есф$, гл. 8, 3.2, 2.5.3, 
3.4, 3.5, 6.6.4 

У/а{ Гог та|еОБ]ес+Ех, гл. 8, 3.2 

УУеьСоппес оп, 11.3.1 

У\УН_САШЫЛММОРВОС, гл. 8 

У\УН_САЦШММОРВОСВЕТ, гл. 8 

УУН_СВТ, гл. 8 

УУН_РЕВОС, гл. 8 


\УН_СЕТМЕЗЗАСЕ, гл. 8 
УУН_ЛОЧВМАГЕРГАУВАСК, гл. 8 
УУН_ЗООВМАГВЕСОВЮ, гл. 8 
У\УН_КЕУВОАВЮ, 4.3 
УУН_КЕУВОАВ, гл. 8 
УУН_МОСЧСЬЕ, 4.3 

УУН_МОЧЬЕ, гл. 8 

УУНТТЕ_ ВКБОБН, гл. 8, 1.6, 5.5.1 
УУНТТЕ РЕМ, гл. 8 

У/НТТЕМЕЗ, 5.5.1 

УБо[, 10.3 

УПМОТМС, 5.2.2.1 
УУПМРОМУРГАСЕМЕМТ, 5.1.1, 1.8 
У\М/1тЕхес, гл. 8, 1.4 

У\У/штНерр, гл. 8 

УУМ_АСТТУАТЕ, 1.4, 1.5 

УУМ_ СНАМСЕСВСНАТУ, 3.11 
УГМ_СНАБ, 2.3.3 
УУМ_СОММАМЮ, 5.1.2 
УГМ_ПЕБЗТКОУ, гл. 8 
УУМ_РКА\ЗМ/СИРВОАВЮ, 3.11 
УМ _РКБАУТТЕМ, гл. 8 
УУМ_РВОРЕП.ЕБ, гл. 8, 6.11 
УГМ_ЕМОБЗЕБЗЗТОМ, 2.2.1 
УУМ_СЕТТЕХТ, 5.1.1 
УУМ_НОТКЕУ, 2.3.5, 3.2 
УУМ_КЕУПРОУХИМ, 3.2 
УУМ_КЕУТЬР, 3.2 

УМ _ГВОТТОМОВГСКК, 2.4.1 
УУМ_ТГВОТТОМРОХИМ, 2.4.1, 5.1.2 
УУМ_ГВОТТОМОР, 2.4.1, 3.2, 5.1.2 
УУМ_МВОТТОМОВГСКК, 2.4.1 
У\УМ_МВОТТОМРОУ/М, 2.4.1 
УУМ_МВОТТОМУР, 2.4.1 

У/М_ МЕАБОВНЕ, гл. 8 

У\УУМ_ МОЧЗЕМОТХЕ, 2.4.1, 3.2 
УМ _МОЧОЗЕМ/НЕЕГ, 2.4.1 
УУМ_МССАГССЬТЕЕ, 5.2.4 
УУМ_МСОЕБТВОУ, гл. 8 
У\УМ_МСЬВОТТОМОВГСКК, 2.4.1 
У\УМ_ МСЬВОТТОМРОХИМ, 2.4.1 
У\УУМ_ МСЬВОТТОМУР, 2.4.1 

УМ МСМВОТТОМОВГСГК, 2.4.1 
У\М_МСМВОТТОМРОХМ, 2.4.1 
УУМ_МСМВОТТОМОР, 2.4.1 
УГМ_МСМООБЕМОТХЕ, 2.4.1 
У\У/М_МСВВОТТОМОВГСКК, 2.4.1 
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УМ_МСВВОТТОМРОУ, 2.4.1 

У\М_МСВВОТТОМУР, 2.4.1 

УМ _РАТАТ, ‚, 3.2 

УМ _РАЗТЕ, ‚ 2.3.3 

У\М_ОЧЕВУЕМОЗЕЗЗТОМ, 2.2.1 

УМ _ВВОТТОМОВЕСГК, 2.4.1 

УМ _ВВОТТОМРОХМ, 2.4.1, 3.2 

У\УМ_ВВОТТОМОР, 2.4.1 

У\М_ЗЕТНОТКЕУ, 2.3.6 

УМ_ЗЕТТЕХТ, 5.1.1, 5.1.2 

У\М_ЗУЗСОММАМЮ, 1.7, 5.1.3, 1.8, 4.3, 
5.2.1, 6.13 

МУУМ_ЗУЗКЕУРОУГМ, 3.2 

У\М_ЗУЗКЕУОР, 3.2 

УМ ТИМЕБ, 1.15.4, 3.2 

УМ _ОЗЕБК, 1.10 
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У\/МАСТГУАТЕ, 1.12 
У\У/МОКОРЕПЬЕВ, 6.11 
У\УУМПРЕМОМРКОС, 5.1.2, 5.1.3 
УУРЕ ВЕЗТОКЕТОМАХИМТЕЕЮ, 5.1.1 
УУРЕ ЗЕТМИМРОБГТОМ, 5.1.1 
М/гцеЕПь, гл. 8, 2.5.2, 2.5.5, 6.1.1 
М/УгцеЕЙеЕХх, гл. 8, 2.5.3 

У\5_ ЕХ_ ТООГБМЛМРОМ,, 1.9 

\!5 517ЕВОХ, 5.2.4 

У ТНТСКЕКВАМЕ, 5.2.4, 6.13 
У! _УТЗТВЕГЕ, 5.1.3 

ХРОВМ, гл. 8, 5.5.2, 5.5.3 

Уеаг, 11.5 

УеагзВеф\ееп, 1.15.1 

Уеаг5рап, 1.15.1 


Распределение функций по заголовочным 


файлам 


Распределение объявлений функций по заголовочным файлам полезно 


знать, если при программировании компилятор сообщает, что не может распо- 
знать ту или иную функцию. Это значит, что соответствующий заголовочный 
файл не подключен к приложению директивой ш@аде. В этом случае вы мо- 
жете найти в этой таблице нераспознанную функцию и определить заголовоч- 


ный файл, который надо подключить к проекту. 


Функция 
_а“пйок 


| СрагТоОет 


Апз1Вер]асеб г 94г04$.Врр 
Арреп4Меп 


Агс 

АтоТо 
Веер 
вивН 
СаЦМех{НооКЕх _ о 
СапсеПо у1шБазе.В 


Заголовочный файл 
ТО.В 


М/Ишпизег. В 


СоСгеафештзапсе — 


Сгеа$еВгиз п1гес% 
Сгеазе  ПрясВеп 
Сгеае ШрисВ п тА1гес{ 


СгеаеГоп ш1гес% 
Сгеа$еНа{& с Вгизь 


Сгеа{еРа вегиВгизЬ 
Сгеж{еРепта1гес% 


СгежеРо]ухопВ яп 
СгеафеРо|уРо|угопВ п 


Ф 
= 
Ф 
55 
=+ 
Ф 
д. 
Ф 
= 


СгеафеКкес*В яп 
СгеафеКесВеп]та1гес% 
СгеаеКоипаВесВ еп 


СгежебоНАВгизь 
СгеафеТооШе!р325парзво%$ 


Сгеже\Уа {а МеТ1тег 


РафеТпеТоБузетТипе 


ВавВЕ ооо са аеоез| 8 

$ о |$ эю ю в обе ое | :ы 

<+ < |<+ | <+ < |< |< |< Фо ензяозя > 

о © © © ан аш о“ ее в 

ыыы | ыы мк 

= |= а о |® | © Е ЕАЕВЕ о |2 & = 

я но ® 9 |“ со р 2. |8 8 | 

< = Е о [м < И В = |В = 
х ы 2 <” Е: 

3 Ф |= _ > 

| в ВЕ я 

ы г 

[т 

= 

> 

с 

| 

[№ 

х 

Е 

| ® 

< 

х 

ы 

ш 

[У 

о 

ы 

= 

х 

х 

т 

< 

бк | 

Ф 


Ф Ф 
9 3 
[4 [4 
ю 7 
+ <+ 
нь 
т Ф 
>. = 
Ф 5 
В 

= 

о 

3 

Фф 


9 


Заголовочный файл 
УПшпизег. В 
УПпизег.В 
УИшеа1.В 
Утаомз.В 
ус \СПрЬга.Врр 
УПтизег.Б 
улпБазе.В 
УЛшпизег. В 
оБ]Ъазе.В 
Уштга1. В 
у1тБазе.В 
у1пБазе. В 
ТаС]оБа1.Прр 
УЛшгёа1. В 
У/теа!. В 
УЛшёа1.6 | 
у1шпазе. В 
ултБазе. В 
У\У/Ишёа1.6 
Ут 9до\гз.Б 
УИтеа1. В 
уттазе. В 
УЛштёа!.В 

| Мшаомз.6 
Ута4омз.В 
У\У/шёа1.В 
М/пеа1. В 
Уп еа1. 6 
\У/1пда!1.В 
У/1тда!. 6 
у1пБазе. В 
Ут а1. В 
утразе. В 
Ве!р32.В 
у1пБазе. В 
5у$0411$.Врр 


- 
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Заголовочный файл 
Па{е011$.Врр 
Оаёе 0 {115.Прр 


у\1празе. В 


Функция 
ДаузшМощВ 
Паузш Уеаг 
еее Афот 
ОееёеМепи 


У/пизег.В 


М/пизег.В . 


Оезфгоу\\"шаом 


ушразе. В 

эпеПАРТ.В 
эреПАРТ.В 
эреПАРТ.В 


УЛпизег. 


015КЕгее 
ОгахАссер Е Пез 
Ога Е 1131 
Огах@иегуЕ Це | 
Огам]соп 

УЛтизег. В 
\М/штеа1.В 
Епа]еМепиЦет о УЛтизег.В 
Епае\/ том | УИ тизег.В 
ЕпитСЬПАа\/1 190% 


ЕпитВезоигсеМатез 


Ога\[сопЕх 


У/Лпизег.В _ 
у шразе.В 

Епит М1 д 0о\'з УЛтизег.В 
Ех У пдомз Ех 


Ех4гас&Аззос1а$е [соп 


М/шизег. п 
ЭреАРТ.В 
эпеАРТ.В 


М/Л/тизег. В 


Ехгас М соп 
ЕШКБес% 
ЕшаАют 
Е1паС]озе 
ЕшлаЕхеси4аЫе 
ЕлаЕ!т$% | 
ЕпаМ№ех& 

Епа\ 1190 
Ешауху/ шадомЕх 
ЕазрЕЛеВи[ег$ 


ЕгатеВес+ 


ушфазе.В 
5у$0411$.Прр 
ЭреПАРТ.В 
5у$041$.Врр 
5у$0411$.Прр 
У/!пизег.В 
УПтизег.В 
УЛпао\мз.В 
У/тизег.В 
УПтаомз.В 
у1тфазе.В 
Утао\мз.В 


МЯпизег. В 


ЕгееЕпу1гоптепт {гш?з 
ЕгееГлЬгагу 
СеАгсПЛгес оп 

Се АзупсКеу {же 

Че АфотМате 

Се СаззМате _ 


\1празе. п 


У/шизег. В 


Функция 

Се СПетВес{ 

Се Сотшш$а4е 

Се СоттТИпеоц{$ 
Се СотрщегМате 
Се{СигзогРоз 

Се ОезК4ор\У/шаом 
Се 013зКЕгеебрасеЕх 
Се муеТуре 

Се Епу1гоптет #1755 
Се Кеубоага $афе 
Се{КеуБоагАТуре 
СеКеу $ же 
Се{Газ{Еггог 

$х-1134Се оса Опуе т 
Че{Мепи 
Се{МепиетСоии\ 
Се МепиЦет ШО 

Се МепиЦеш по 

Се Мепи{афе 

Се Мех МИ том 

Се ОуегарреаВези 
Се{Рагеп& 

Се Раф 
СеРногЦуС]азз 


оо@ о 5 

Фо х Ф Ф 

ен |+ |с+ | <+ <+ - 

а |9 |9 |=) > 
{4 > ООО ЗВ бе Ф 

ооо ® 

ыы. | © О = 

о |@ |5 т 

ой >, [4 

а ы 
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+85 |9 = 

@ Ф 
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[т] 

= 

< 

г- 

® 

^^ 

х 

< 

| | ® 

< 

х 

а 

`В) 

Е. 

ы 

< 

х 

1 

| т 

_ , ы 

= 
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м 


Заголовочный файл 
УЛтизег.В 
у1тБазе.В 
улшБазе. В 
У тао\з.В 
УМ!пизег.В 
улпБазе.В 
У! 14 омз.Б 
у1тфазе. В 
утпБазе.В 
У1таомз.В 
УПтизег. 
У\Утаомз.В 
УПпизег.В 
у1пБазе.В 
ултразе. В 


УЛпизег. И 


УЛштизег. Ц 


Упизег. Ц 


УЛтизег. В 


М/И шпизег. И 


МЛ пизег. В 


улпЪазе. В 


УЙПтизег.В 
у1пЪазе. В 
у1пЪазе. В 
у1пфазе. В 
улпБазе. В 
УПтизег.В 
УЛ шеа!1. В 


2 
Ф 
=+- 
бр 
|= 
= 
= 
® 
= 
|= 


Се ЗузетПО1гесфогу 


Се’Гипе/опетГогта оп 


(> | 42 42 | 62 
Ф |Ф ФФ 
= |= | 
ф | ю < |< 
9 | Ф шо 
он =+ | = 
=. ФФ 
о |“ ЕЩЕ 
В Э 

вен 
| но 

= 


УПштизег. В. 
УЙтизег. В 
у1пБазе.В 
у1шБазе. В 
УМ/1п4домз.В 
Утао\з.В 


улпразе. 
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Функция 
Се{Уегз1опЕх 
СефУотепогта10п 
Се том 

Се УИ ш4омР]асетеп+ 
Се УИ тдомВес% 
Се\У/Лт4омВеп 

Се \/шпаом/ Тех 

Се МУ таом Тех еп {В 
Се \УГогкт=ТПгесфогу 
СПоба1 Ааа Абот 
СоБраееёеАфот 


СПоБа]!СеАфотМате 
СоБа1Метогу $абиз 
НазОуег|аррейаТоСотр|%е@ 
ШП А{фошТаЫе 


КеуБ4_еуеп% 


ГоааКеуБоагаГ.ауой&$ 


ГоокКарР!УПехе\аше 


МоуеЕ\!е\У В Ргог#гезз 


ОБес{ВтагуТоТех& 


ААВАЗАЗАЗААВ 5 
а |< аа > в 5 [© о 
Ф |® Ф |< 5. В. 155 ны д 
= ны) | 55 Е = <* | 5 Р. 
25 ыы 5: о у | = =) 
ы | 5 Ф |Ф д =) Ф |® ы 
о м 3 < |= > 
«а = 
= Е 


©) 
® 
ре. 
о 
Ф 
= 
7 
9 


аа] 3120$ ОешТоСвагВаЕ 


ОрепРгосезТоКеп 
Ореп\!аЦцаеТ!те 


се 

з В 
Е 
< 
Ф 

ЕЁ 

9 

[2 
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Заголовочный файл 
У\Утизег.В 
у1пБазе. В 
У тизег.В 
УЛшизег.В 
УПтизег.В 
УЛтизег.В 
УГпизег. В 
УЛтизег. В 
УЛтизег.В 
ушразе. В 
у1шразе. В 
у шБазе. В 
ушфазе. В 
утразе. В 
ушазе. В 
утпразе. В 
'МИшизег.В 
УПтизег.В 
УПптизег.В 
Ут4о\з.В 
УЛтизег.В 
УЛпизег. В 
у1пБазе.В 
у шазе. В 
у тазе.в 
у шазе. В 
у1пБазе. В 
У\УЛтеа1.В 
УПшпизег.В 
Саззез.прр 
УЛтизег.В 
УЛтизег.В 
УПтизег.В 
у1шфазе.В 
УПтазег.В 


\ушразе. п 


дл 
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Заголовочный файл 
п Мм 
пипвуввет. рр 
Мпа 
Упаае 
УИпвег в 
Упиааь в 
УИтааЕ 
УИпивег.В 
Мпа 
МИпивег.В 
ве!рЗ2.в 
Ыве!рЗ2.в 
УИпфонз. В 


ВеааЕИе улиазе. 
ВеааЕЦеЕх у1пБазе. 


УИпивег.в 
МИпивег.В 
УИпивег. в 
зпразе.В 


пазе. В 
ь 


гетоуе 54А1о.П 


е]еазебетарпоге 
ВетоуеРоп%Везопгсе У\М/1пга1. В 
ВоппаВес% УМ/Лшпизег. В 
Зе]ес&О1гесфогу ЕПеС&г].Врр 
ЗефАтсП1гес оп \М/1пАо\мз.В 
ЗеСоттВгеаКк М/штао\з.В 
ЗеСотшт$афе 
е{СоттТИтеоц$з 
еЕИеРопфег 


улифазе. В 


Забота [ев 


зе {СотшрщегМате У/1тао\мз.В 


М/пизег.В 
упБазе. в 
зе{@гарЬ1сМо4е У\М/1тпеа1. В 
МИпизег.в 
упьазе.В 


к) 
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Функция 
Зе МепаЦет по ___ МЯпизег. В —__ 
ЗеёРогуС1азз уЛпБазе. В 


М/УшаЧо\мз.В 


У/пизег. В 


зе’Титейопе{огтай оп 
зе \МацаеТ!тег 
Зеё\\МИпаомГопй 
Зер\/ш4омР]1асетеп$ 
зег\/пдомРоз 

Зер\/ п4домВёп 

зе паом$НоокЕх 
зе\/т4омТех$ 

Без \/огАТгапзРогт УЛтеа1. В 
ЭНВгомзеКогКо!4ег ЕПеС&:.Юрр 
5НВгомзеГогГо|4ег —_ | 55105).6 
эре] _ Мой Усоп | эпеПАРТ.В 
эпеЕхесще эре АРТ.Б 
5НЕЦеОрега{10п ЗВепАРТ.В 
ЭНСеОезКюорГо]!4ег ЗВ1ОБЬ].В 
эНаеЕЦеШ#о эреАРТ.В 
ЗНСе#Ра В Егош 1% ЗН10Ь) В 


ЭпомСогзог М/Лштизег. В 


УЛ шпизег.В 
УЛ шизег.Б 
УЛпизег.В 
У/Итизег. В 
У/Лтизег. В 


У/тизег. В 


Ра 


э\арМопзеВи “оп УПштизег. В 


ЗузЕггогМеззаге | 5у3041$.Врр 


БузветРагате ег {о У/Л/пизег.В 
3уз30413.Врр 
ЯБе!рз2.6 
Бер32.Ъ 


у! празе. В 


эузетТипеТо)а4еТ!те 
ТЬгеа432Е!т3% 
ТЬгеаа3 2М№ехф 
Тоуег!арреа 
Оппоок\У/т4о\узНоокКЕх 
Опгей1{егНо&Кеу 
У/гцеЕПе 

УгкцеЕПеЕх 


УеагзВекхееп 


`УИтизег.В 
УПтизег.В 
у1пБазе. В 

| у1тБазе. В 
Оа{ёе0411$.Прр 


Уеаг5рап Оа{е0411$.Врр 
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Тематический указатель и типовые задачи 


Ниже дается указатель основных тем и типовых задач, рассмотренных 
в книге. В первом столбце приводится название соответствующей темы. Во 
втором столбце даются в ряде случаев названия подразделов темы или задачи. 
В третьем столбце даются ссылки на соответствующие разделы книги. 


Тема Подраздел | 
ВРЕ Установка ВОЕ 
ВКССЗ2 | | Компилятор ресурсов 


сИрБоага 


СоЁ#2О т Утилита преобразования ПШ, 


сопзое 1три% консольный вход 


Динамическое связывание и отладка 
И 


Получение информации об импорте 4.4.2 
и экспорте исполняемого модуля 
4.3 


Работа с изображениями УРЕС 


Работа с ловушками сообщений 
Уп 4о\з 


Создание ОШ, 4.2.2 


| Создание универсальной ОШ для 
С-+-Ви!аег и МВ У!з1а! 546410 


Статическое связывание и отладка ОШ, 
Хранение изображений в О, 
Графический интерфейс устройств 5.3.1.3. 5.5 


Ловушки сообщений \У1т194о\з 


4. 

ини 

Пцегпеф П!гес% (шпду) 9.6 

РЕВ — формат 
| 5.1.4 

ПЕ 8 


изображений 
р работа с изображениями ЧРЕС 
Аплеты Вызов панели управления 1.12 
и ее компонентов 
Хранители экрана 


Аппаратная часть Сведения о ВОВ 2.1.1 
компьютера 
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Тема [Подраздел Раздел книги 
Аппаратная часть Сведения о памяти 


| компьютера 
р Сведения о процессоре 


Атомы Создание глобальных /локальных атомов | 1.16 


Базы данных Доступ к удаленным данным из сервера |11.8 
УТеь 
Индексация клиентского набора 11.6 
Построение сервера с удаленным 11.1 
модулем данных 
Фильтрация данных клиентского набора | 11.5 


Дата и время Вычисление разности двух дат 1.15.1 
Изменение приоритетов процессов 1.15.3 
Измерение отрезков времени 1.15.3 


= 
= 
< 
® 
> 
[4 
5 
5 
о 
= 
= 
6 
> 
> 
> 
- 
[=] 
| 
т 
т 
ы 
=: 
0 
@ 
+ 
+ 
|". 
с 
а. 
® 
= 
(= 
5 
[о 
© 
|- 
[1 


№ | 
ыы | 
№ | © 


1.15.1 
1.15.2 
1.15.4 
Диски, файлы 6.7.1 
6.7.1 
компонентов и формация особом исто ва диско 
Информация о [Информация о свободном место на диске месте на диске | 6.1.1 
6.1.1 
\У1194о\з$ в приложение 


Поиск по шаблонам. по всему дереву 
ока ое 


Поиск пони фени по папке 6.6.1 


| Получение идентификатора дика = | идентификатора диска 6.1.1 


получение получение информации о конфигурация о конфигурации |6.1.2 
получение информации о конфигурация 


Получение серийного номера дика _ 6.1.1 
[Получение описка дик [6-14 
[Проверка готовности устройства |6.1. 


© 
ы 
| 


© 
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Раздел кн 
6.7.1 
6.12 
6.7.1 
6.1.3 


Подраздел 


ыы —— И 


Диски, файлы 


Синхронная работа с файлом 


Создание и работа с ярлыками 

Создание файла 

Управление СО КОМ 

Ускоренный поиск 

6.7.1 

Блокировка выдвижения лотка СО ВОМ | 6.1.3 

Преобразование формата ВМР в УЗРЕС 
Работа с изображениями ЗРЕС 


Клавиатура Асинхронный опрос клавиш 


Чтение из файла 


Зарегистрировать / снять 
с регистрации горячие клавиши 
для неактивного приложения 


Определение нажатого сочетания 
клавиш 


Переключение языка 


Сведения о клавиатуре 2.1.4 


Эмуляция нажатия клавиш 


ал 
ал 
ры 


р 
-4 —4 —4 < 


1) 
со 
ры 


Вывод строки на контекст 


Задание графического режима 


Преобразование координат контекста 


Меню “Пуск” Дескриптор полосы задач 
Доступность / недоступность кнопки 1.7 
“Пуск” 
Скрытие / восстановление кнопки 1 
"Пуск" 


р 


Управление разделами 


Меню окна Изменение реакции приложения на 
стандартные разделы системного меню 


Определение числа разделов в главном 5.1.2 
меню окна 


5.1.2 
5.1.2 


Получение дескриптора подменю 


Получение дескриптора полосы главного 
меню 


Получение идентификатора раздела 5.1.2 
меню 


Получение текстов разделов главного 5.1.2 
меню 


ой 
ыы 
ры 


| | 


Удаление раздела меню 
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Тема__ Подраздел 
Мышь Анимированные курсоры 2.4.5, 2.4.1 


Взаимное изменение функций правой 
и левой кнопок мыши 


Изображение курсора на контексте 2.4.5, 2.4.7 
устройства 
2.4.2 


Имитация перемещения и щелчка 


МЫШИ 


Ограничение области перемещения 
курсора | 


Отображение курсоров 2.4.5 | 
Позиционирование курсора мыши 


| Получение координат курсора мыши 


| 
Управление видимостью курсора мыши 
Обмен данными Синхронный обмен данными через СОМ |2.5.1, 2.5.2 


| Схемы курсоров 2.4.6, 2.4.1 
[2.43 

порт 

Асинхронный обмен данными через 

СОМ порт 

Настройка СОМ портов 

Отслеживание событий СОМ порта 

Работа с модемом | 2.5.5 

Разрыв связи с СОМ портом 

Установка временных параметров порта 
Объекты ‚ | Запуск из одного приложения других 3.6 
синхронизации приложений 

Ожидание окончания выполнения 3.2 

события 


| Отслеживание процессов и управление 3.10 
ими 


Переход в сигнальное состояние 
в указанное время. или регулярно 
с заданным периодом 


3.11 
Работа с потоками | 
| Работа с семафорами (зетарпоге) 
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Подраздел 


Объекты 
синхронизации 


Переменные 
окружения 


Пиктограммы 


Полоса задач (Буз4$ет 


Тгау) 


Приложения 


| 
Работа с событиями (еуеп{) 3 


Работа с таймерами ожидания (ма{цае 
тег) 


Работа с функциями ожидания 


Разделение работы нескольких 
приложений с какими-то 
неразделяемыми ресурсами 


Сигнал для процессов, что закончена 
какая-то группа операций 


Сообщения об изменениях в каталогах 3.9, 6.6.4 
Установка/снятие события 


Информация о значении конкретной 

переменной окружения 

Создание новой переменной 1.13 

Чтение полного списка переменных 1.13 
окружения текущего процесса 

Масштабирование пиктограмм 

Получение пиктограммы из файла 5 


Получение стандартных пиктограмм для 
КНОПОК 


Преобразование формата ВМР в УРЕС 5.4.4 
Работа с изображениями УРЕС 


Рисование пиктограммы 


Мигание пиктограммы в полосе задач 


1 
Отобразить свернутое окно 1 
в полосе задач 


Свернуть в полосу задач 

Связь приложения с пиктограммой, 1.10 
размещенной в Зуз4ет Тгау 

Скрыть / восстановить полосу задач 


Управление полосой задач 1. 


Синхронный обмен данными через СОМ |2.5.1, 2.5.2 
порт 

Асинхронный обмен данными через 2.5.1, 2.5.3 
СОМ порт 


Буксировка 
Взаимное изменение функций правой 
и левой кнопок мыши 


.5 
.13 
.4.1 
.8 
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ООО 
Зад 


Приложения 


ать стиль окна 1.9 


Запоминание в файлах состояния 
компонентов и форм 


>>) 
ы- 
© 


Запоминание в файлах состояния 6.13 
компонентов и форм 


Запуск из одного приложения других 
приложений 


Зарегистрировать / снять 
с регистрации горячие клавиши 
для неактивного приложения 


Зарегистрировать горячие клавиши для 
активного приложения 
Использование УРЕС в приложении 


Обмен текстовой информацией между 
двумя компьютерами 


Обмен файлами между двумя 
компьютерами 

Ограничение области перемещения 
курсора 

Ожидание окончания выполнения 
события 


Определение и установка ошибок 


ими | 

У/1п4о\мз в приложение 

2.4.2 
1.4, 1.5 
файлов из папок У т9о\з в приложение 

3.11 
5.4.4 


Работа с протоколом ЕТР 10.4 
Работа с реестром 1.11 


4 
9 


= 
ыы 


.1.4 
.4 
.11 


Разделение работы нескольких 


приложений с какими-то 
неразделяемыми ресурсами 


Разместилось внизу всех окон 
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Раздел кимги 


Приложения Разместилось поверх всех окон 
Регистрация собственного расширения 1.11 
файлов 
Связь приложения с пиктограммой, 1.10 
размещенной в Бузет Тгау 
Серверы точного времени 10.1 
Создание и работа с ярлыками 6.12 
Создание невидимого а полосе задач 1.9 

| приложения 


3.9, 6.6.4 

10.2 
Работа с окнами 

5.1.4 

5.1.1 

компонентов и форм 

5.2.2.1 

стандартные разделы системного меню 

5.2.1 


Определение класса окна 5.1.1 
Определение положения и размера окна |5.1.1 


Определение числа разделов в главном 5.1.2 
меню окна 


5.1.8 
5.1.1 
5.1.2 
5.1.8 
5.1.4 
5.1.2 


Получение дескриптора полосы главного | 5.1.2 
меню 


Получение дескриптора родительского 5.1.2 
окна | 


Получение идентификатора раздела 5.1.2 — 
меню 
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Подраздел Раздел книги 


Работа с окнами Получение текста окна — 5.1.1 


Получение текстов разделов главного 5.1.2 
меню 


Получение характеристики бордюра 5.2.4 
созданного окна 


Получить/установить характеристики. 5.1.1 
определяющие местоположение окна 


 Свертывание всех оков 
Свертывание/закрытие окна 5.1.4 


| Создание непрямоугольных форм 5.2.2.1 


Создание формы на основе изображений 


Удаление раздела меню 5.2.1 : 


Управление окнами с помощью 5.1.1 
их дескрипторов 


Установить характеристики бордюра 
созданного окна 


Установка недоступности окна 5.1.4 


Фиксация размера и положение окна 5.2.1 


Работа с папками Выбор папки 


Доступ к системным папкам 
через реестр 


Мониторинг каталогов 


Организация сортировки файлов 


Поиск по шаблонам по всему 
дереву каталогов 


Поиск файлов по папке 6.1 


Получение доступа к корневой папке 
"Рабочий стол” 


Получение имени папки 


Преобразование РТШ/. в путь 


Просмотр папок на основе [15% \У1е\ 


5.2.4 


6.6.5 


Ускоренный поиск 


Рабочий стол Дескриптор рабочего стола 


Надписи на рабочем столе 


Установка обои на рабочем столе 


Характер упорядочивания свернутых 1.3 


окон 
4.1.4 


Использование ресурсов в приложении 4.1.4 


Ресурсы Использование УРЕС в приложении 
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Тема ______ |Подрадел __[____  |Раддея книги | 
Компиляция файла ВС 
Получение информации о ресурсах 


Ресурсы 


Сети 


Система 


матриц и курсоров с помощью ГПпабе 
Еа ог 


1Р-адрес и ОВЬ 


Обмен сообщениями и файлами между 
двумя компьютерами 


Протокол ТСР/ТР 
Свойства характеризующие соединение 9.2 о 


Сетевые протоколы 9.1. 9.4 | 
Телеконференции и служба новостей 10.5 
Тестирование сети 10.2, 10.3 


2.2.2 
2.2.1 
Запрет перезагрузки | 2.2.1 


Зарегистрировать / снять .3.5 _ 
с регистрации горячие клавиши 
для неактивного приложения 


Однократный автозапуск 


Определение версии У/ш@4о\з 


2.2.1 
параметров системы 

Получение имени пользователя | 2.1.6 

2.3.3 
1. 


Регистрация собственного расширения 1.11 
файлов 


Сведения о ВОЗ 
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Система 


Сведения о процессоре 2.1.2 | 
1.10 


Связь приложения с пиктограммой, 
размещенной в Буз4ет Тгау 


Установка английского языка 
Установка русского языка 


Сокеты Организация взаимодействия клиентов 
и сервера 


Сетевой чат 


Сокеты 


2 


Справочная система 


Проектирование 
1.2.1 
1.2.2 
1.2.3 
7.2.4 
1.3.1 
1.3.1 
7.3.2 
1.3.3 


Написание текстов 


Переходы 


%2 


11.2 
11.8 


Удаленные модули 
данных 


Доступ к удаленным данным из сервера 
е 


11.6 
11.3.3 
11.4 
11.3 
11.1 
11.7 
11.9 
11.8 
11.5 


Индексация клиентского набора 


Построение клиентского приложения 


®) о [© 
ыы ая = оао вые о 
(< 5 |3 и - и -ИВ- [5 
3 МЕ: © == ЕЕ: с = 
= 5 | м а Рю р о 
ЗМЕЙ вв аноя ы 
: МЕ: ооо ® 
Е ЧЕЕЕ 8 
о Ф |Н - а мЕМ- я 
(= ш | яя - 
ы м оо > 
‚ЕВЕЕ ВЕВЕВЫАЕ Е 
аз МЕМЕ Е = 
сл я |® © 
И р 
г Ев 
[: ов 
ь МЕ 
ы (=) 


м 9 |: 
Н о ю 


„Ир о! 
аРЕЕЕЕ 
ЕН 
6" [| 
они ро 
шоб ное 
ыы о © Ф 
Ф =. Р.И: 

зы 
ЗЕЕ 
ыы 
он о 
я ыы о ры 
=. мо Н 
|.) р |® = 
м |9 |= 
® о 

(> 
И: 
= Я 

Ф 
| & 


5.3.1.3 
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Тема__________ Подраздел 


"Шрифты 
Получение списка установленных 1.14 
в \ш9о\з шрифтов 


Проверить. зарегистрирован ли 1.14 

в системе какой-то шрифт 

Снятие шрифта с регистрации 
Создание собственного шрифта 


Установка языка 2.34 
Язык и региональные 1.12 
стандарты — апплет 


Язык по умолчанию | 


Дополнительные источники 
информации о С++ВиПаег 


Опубликованные книги и справки 


Ниже приведены сведения о некоторых опубликованных книгах и иных 
информационных материалах авторов по С++Ви4ег. Оперативную информа- 
цию о готовящихся к выпуску и вышедших книгах вы можете найти на сайте 
авторов № вр: / /4е]с1.В1.ги. 


1. Архангельский А. Я. Программирование в С++Ви|9ег 6. 2-ое изд. — 
М: ЗАО "Издательство БИНОМ", 2005 


Книга содержит методические и, частично, справочные материалы по 
С+-+ВиПаег 6 и предшествующим версиям С++Ви!Паег 5 и 4. Рассмотрены та- 
кие возможности С++Ви!аег, как построение кросс-платформенных приложе- 
ний, технологии доступа к данным АОО, ПщфегВазе Ехргезз, АБЕхргезз, компо- 
ненты — серверы СОМ, технологии распределенных приложений СОМ, 
СОВВА, МШАФЗ, \У!еЬЗпар, методика диспетчеризации действий. Дается мето- 
дика построения прикладных программ, реализующих текстовые и графиче- 
ские редакторы, мультипликацию и мультимедиа, работу с базами данных, 
создание отчетов, приложений для Интернет, распределенных приложений, 
клиентов и серверов. 

Справочная часть книги содержит некоторые материалы по языку, функ- 
циям, типам и классам С++Ви|Аег. | 

Судя по отзывам читателей, эта книга позволяет практически с нуля под- 
няться до среднего уровня профессионала по работе с С++Ви!@ег. Во всяком 
случае, ее вполне достаточно, чтобы без труда освоить материал данной книги, 
рассчитанной как раз на подобных специалистов. 


2. Архангельский А. Я. Справочное пособие по С++ВиП@ег 6. Книга 1. 
Язык С++ — М: ЗАО “Издательство БИНОМ", 2002 


В книге даются исчерпывающие справочные сведения по языку С++ 
в С++ВоаПаег 6 и предшествующих версиях С++ВиПаег: синтаксис языка, все 
операции и операторы, все типы данных. Подробно рассматривается работа 
с исключениями, с текстовыми и двоичными файлами, со строками разных 
типов, массивами, множествами, структурами, классами. Обсуждается обра- 
ботка и генерация сообщений \Ут4о\з. Рассматриваются практически все 
функции С и С++, а также ряд функций АРТ \У/т4о\мз$. По большинству функ- 
ций даются подробные описания и примеры использования. 

Рассматривается стандартная библиотека шаблонов ЭТГ: все типы контей- 
неров, итераторов, все алгоритмы и функции-объекты. 

Представленный в книге справочный материал снабжен подробными ком- 
ментариями и примерами, что позволяет читателю изучать его практически 
с нуля. 

Как справочник книга полезна пользователям любой квалификации: от 
начинающих до опытных разработчиков. 


Дополнительные источники информации о С++ВийЙдег 989 


3. Архангельский А. Я. Справочное пособие по С++Ви@ег 6. Книга 2. 
Классы и компоненты — М: ЗАО "Издательство БИНОМ", 2002 


В книге даются справочные сведения по многим базовым классам и типам 
С+-Ви!аег. Описания снабжены таблицами, содержащими свыше 2000 крат- 
ких характеристик свойств, методов, событий. Дается краткая методика раз-- 
работки прикладных программ с помощью С++Ви!@аег. Помимо кратких ха- 
рактеристик, книга содержит подробные описания около 450 свойств, мето- 
дов, событий, присущих различным компонентам и классам. 

Как справочник книга полезна пользователям любой квалификации: от 
начинающих до опытных разработчиков. 


4. Архангельский А. Я., Тагин М.А. Система справок по С++Ви!@дег 


Система справок — это программный продукт, призванный оказать вам 
поддержку в процессе проектирования. Справки встраиваются в среду 
С+-Ви4ег командой Нер | Сизюпихе в дополнение к англоязычной справке, 
и в процессе проектирования при нажатии клавиши Е]! вам предлагаются на 
выбор темы английских или русских справок. Русские справки — это не пере- 
вод с английского, а, скорее, расширенный электронный вариант материалов 
указанных выше книг и данной книги. Так что они могут быть полезны не 
только тем, кто испытывает определенные сложности с английским, но и всем 
пользователям С++ВиПаег, поскольку содержат иначе построенное и скомпо- 
нованное изложение справочных данных, иные примеры, в них устранен ряд 
ошибок англоязычных справок (надеемся, добавлено не слишком много собст- 
венных ошибок). 

В настоящее время серия включает в себя пять справок: по С++ 
в С++Ви!аег, по компонентам и классам С++Виаег, по стандартной библио- 
теке БТГ,, по использованию АР \У/1114о\з в приложениях С++Ви!аег и по 
графикам и диаграммам ТееСТаг%. 

Суммарный объем текстов справок намного превышает объем данной или 
любой из указанных выше книг. А стоят справки намного дешевле, чем книги 
(авторы не преследуют коммерческих целей, но, все-таки, неблагодарный труд 
по подготовке справок требует хоть какой-то компенсации). Достоинство спра- 
вок по сравнению с книгами в том, что они обеспечивают оперативную помощь 
в среде разработки С++ВиПаег, облегчают поиск нужной информации (в кни- 
гах это делать значительно сложнее), позволяют легко переносить примеры 
в свой проект. Но, конечно, справки не заменяют книг, хотя и содержат много 
материала, не поместившегося в книги. Изучать какой-то материал, конечно, 
лучше по книгам. А в процессе разработки помощь справок неоценима (авто- 
ры сами постоянно пользуются ими). | 

К данной книге прилагается только демонстрационная, да и то урезанная 
версия справок, в которой вы можете, фактически, посмотреть только непол- 
ный состав справочных данных. К тому же, в этой версии пока нет сведений по 
С-+-+ВиПаег 2006. А полноценные системы справок распространяются через 
Интернет по адресу: Ввр://1а 6 18.1ри.г5$1.ги/вВе]р2/. Там вы найдете условия 
распространения, включающие бесплатную поддержку — дополнения к справ- 
кам распространяются бесплатно тем, кто приобрел начальную версию. А но- 
вые версии поставляются с 50% скидкой. 

Распространение справок через Интернет не означает, что вы обязательно 
должны иметь доступ в Интернет с домашнего компьютера и иметь собственный 
адрес е-та!. Достаточно, если доступ в Интернет и е-та! есть у вас на работе 
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или у кого-то из ваших друзей и знакомых. Вы можете воспользоваться этими 
возможностями, а затем на дискетах перенести файлы на свой компьютер. 


Планируемые публикации 


5. Архангельский А. Я. Программирование в С++Ви1дег 6 и 2006. — 
М: ЗАО “Издательство БИНОМ", 2006 


Книга аналогична книге [1], но дополнена материалами по С++ВиИ@4ег 
2006. Да и прошлый материал существенно переработан и дополнен. Так что 
книгу можно рекомендовать как тем, кто работает с С++Ви!@ег 6 или предше- 
ствующим версиям С++ВиПаег 5 и 4, так и тем, кто начинает работать 
с С++ВиПаег 2006. Рассмотрена методика проектирования различных видов 
приложений и даются некоторые справочные материалы по языку, функциям, 
типам и классам С++Ви!@ег. Так что книга, как и книга [1], рассчитана на то, 
чтобы читатель, практически с нуля, мог подняться до среднего уровня про- 
фессионала по работе с С++ВиИ4ег. Ориентировочный срок выхода книги — 
весна 2006 г. 


6. Архангельский А. Я. Справочное пособие по С++Во@ег 6 и 2006. Кни- 
га 1. Язык С++ — М: ЗАО "Издательство БИНОМ", 2006 


Книга аналогична книге [2], но дополнена материалами по С++Ви4дег 
2006. Прошлый материал также переработан, дополнен большим количеством 
новых примеров и справочных сведений по функциям и базовым классам 
С++Ви!|аег. 

Ориентировочный срок выхода книги — лето 2006 г. 


4. Архангельский А. Я. Справочное пособие по С++Ви@ег 6 и 2006. Кви- 
га 2. Классы и компоненты — М: ЗАО "Издательство БИНОМ“, 2006 


Книга напоминает книгу [3], но кардинально переработана и расширена. 
В ней даются справочные сведения по многим базовым классам и типам 
С++Виаег. В отличие от книги [3], дается расширенная методика работы 
с каждым компонентом и множество примеров, отсутствовавших в книге [3]. 
Ориентировочный срок выхода книги — осень 2006 г. 


8. Архангельский А, Я., Тагин М.А. Приемы программирования в С++Вий- 
ег 6 и 2006: вычислительные задачи, работа с документами — М: ЗАО 
"Издательство БИНОМ", 2006 


Эта книга, является продолжением данной. Первая часть книги посвяще- 
на различным вычислительным задачам, начиная с традиционных задач обра- 
ботки массивов, работы с векторами и матрицами, и кончая методами реше- 
ние систем линейных и нелинейных уравнений, методами решения дифферен- 
циальных уравнений, методами оптимизации. В этой части книги рассматри- 
вается также компиляция произвольных математических выражений, позво- 
ляющая создавать приложения, в которых пользователь может оперативно за- 
писывать решаемые уравнения или формировать целевые функции. 

Вторая часть книги посвящена работе с документами различных видов: 
текстовыми, графическими, мультимедиа. Рассматриваются многие аспекты 
применения соответствующих компонентов С++Ви4ег, мало известные и со- 
вершенно не затронутые в остальных книгах авторов. Особое внимание уделе- 
но приемам программирования, обеспечивающим различные механизмы взаи- 
модействии с приложениями М1сгозоЁ ОЙ се: У’ога, Ехсе], электронной по- 
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чтой и т.д. Подобные вопросы, судя по конференциям и форумам в Интернете, 
особенно часто возникают у разработчиков приложений С++Ви!аег. 

Книга содержит много модулей процедур и функций с подробными пояс- 
нениями, а также законченные приложения, которые можно включать в свои 
проекты. Ве 

Ориентировочный срок выхода книги — конец 2006 г. 


Сайты, посвященные С++ВиЙдег 


В Интернете имеется чрезвычайно много сайтов, посвященных 
С+-+Ви!аег и содержащих статьи, собрания ГАФ© (часто задаваемые вопросы), 
программы. Ниже дается очень краткий список некоторых из них. Я отдал 
предпочтение в этом списке тем сайтам, которые содержат каталоги ссылок на 
другие источники информации в Интернете. Впрочем, во многих случаях для 
получения ответа на возникший у вас вопрос лучше всего пользоваться адре- 
сом \м\м.уа.ги/. Это поисковая система Яндекс, в которой надо только удачно 
сформулировать вопрос и наверняка получишь ответ, имеющийся на одном из 
сайтов, посвященных С++Ви!аег. 


учу .Бог1ап4.ги — сайт представительства Вогап в России, информация 
о программных продуктах, технологиях, о проводимых семинарах и т.п. 


чуму .4ер К тедот.сот — виртуальный клуб программистов “Королевство 
Ое!рр!", круглый стол с участием прекрасных специалистов, каталог ссылок 
и многое другое 


ВЫр://ги$дос.9.ги /1пдех.з В], Вр: //гиз4ос.4Ё.ги /геулем /рговташите /4е]- 
ры/ — большое и интересное собрание статей на русском языке по Оершы 


угугу.Че] р р!и$.ого/ — статьи, ссылки на сайты, посвященные Бер, боль- 
шая подборка ГА® 


4е]р№1.тазфаК.ги — “Мастера Ое!рЬ!", форум, собрания ЕАО, статьи, програм- 
мы, ссылки на сайты, посвященные Пер}; все на высоком уровне 


{огиш.ушетад.ги — хороший форум программистов 


Вр: / /115.таЙ.ги, 1$$.та|.ги/10355/1/0_1_0_ 1. т! — очень хороший ка- 
талог сайтов и ГАО по Шер 


№Ыр: //ШасЕтап.мр-сГаБ.пеё — “Курс борьбы с Ое]рр!”", статьи, большая под- 
борка ГАФ 


ВЁЫр: / /]ех-со.паго4.ги/ — статьи, ГА® 


ууу. Богап4.хрог{а1.ги — “Вотапа Х Рога", Оеры и С++Ви!@4ег, форум, 
ГАО, скачиваемые ресурсы 


угу". зо Ёбодгот.ги — программы, статьи, форум 

Вр: / /де!ры1.свещепоК.ги — статьи, форум, ГАФ 
\угу.4о\лШоа4.ги — множество программ и исходных текстов 
1$%50й.ги — программы 


де]с1.В1.ги — сайт авторов данной книги, информация о вышедших и готовя- 
щихся к изданию книгах, форум 


1а518.1ри.г$81.ги/ве]р2/ — сайт информации о системе русских справок, реги- 
страция, получение, форум 
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Приемы программирования в 


С-+ВиПаег 6 и 2006 


Для любых версий С++Вийаег 


от 5 до 2006 


Взаимодействие С++Вийаег 
с механизмами МЛпао\м$ 
и взаимодействие с операционной системой 


полоса задач 
панель управления 

управление компьютером 

клавиатура и мышь 

рабочий стол, обои, хранители экрана 
работа с портами 

синхронизация процессов и потоков 
мьютексы, семафоры, таймеры ожидания 


перехват сообщений М/пдо\$ 
и ловушки для них 


создание и использование 0 
создание и использование ресурсов 
окна и графика 


работа с папками, каталогами, файлами 
средствами \М/Ипаом/$ 


и разработка справочных систем 


Работа в сети 


=" организация взаимодействия 
приложений в сети 


обмен сообщениями и файлами 
сокеты, создание чатов 

работа с сетевыми протоколами 
тестирование сети 

телеконференции и службы новостей 


работа с удаленными модулями данных 


Примеры, программы 

и демонстрационная версия 
справочной системы 

Система Справок по С++Вийаег 


Книга рассчитана на читателей, 
освоивших С++Вийаег и желающих 
расширить свои знания и возможнос- 
ти проектирования. Решаются задачи 
управления из приложений С++Вийаег 
отдельными составляющими \/таом/$: 
полосой задач, панелью управления, 
рабочим столом, обоями, хранителями 
экрана, а также задачи управления 
компьютером: клавиатурой, мышью, 
портами. Подробно рассмотрены воп- 
росы синхронизации процессов и по- 
токов с помощью функций и объектов 
ожидания. Обсуждается создание и 
использование ресурсов и ОШ, орга- 
низация перехвата и ловушек сообще- 
ний М/пао\м$. Значительное внимание 
уделено нестандартным задачам рабо- 
ты с окнами и графикой. Излагается 
работа с папками, каталогами, файла- 
ми, ярлыками средствами \ЛИпдому$. 
Подробно рассмотрено создание 
справочных систем. Дано детальное 
описание 300 функций АР! \Мпаом$. 


Рассмотрена работа приложений 
С++Вийаег в локальных сетях и в Ин- 
тернете, сетевые протоколы, органи- 
зация взаимодействия приложений 

в сети, обмен сообщениями и файла- 
ми, создание чатов. Обсуждается 
работа с различными сетевыми служ- 
бами: точного времени, эхо, рта, ЕТР, 
\\По1$, телеконференциями. Дается 
решение всех этих задач с помощью 
двух семейств компонентов: Раз{Ме{ 
и шау. Приводится методика работы 
с удаленными модулями данных. 


Рассмотренные приемы программиро- 
вания применимы к любым версиям 
С++Вийаег, но, конечно, предпочти- 
тельнее использовать С++Вийаег 6 


или 2006. 
| | 
И 7 


